CharSequences.java

/*-
 * #%L
 * io.earcam.utilitarian.charstar
 * %%
 * Copyright (C) 2017 - 2018 earcam
 * %%
 * SPDX-License-Identifier: (BSD-3-Clause OR EPL-1.0 OR Apache-2.0 OR MIT)
 *
 * You <b>must</b> choose to accept, in full - any individual or combination of
 * the following licenses:
 * <ul>
 * 	<li><a href="https://opensource.org/licenses/BSD-3-Clause">BSD-3-Clause</a></li>
 * 	<li><a href="https://www.eclipse.org/legal/epl-v10.html">EPL-1.0</a></li>
 * 	<li><a href="https://www.apache.org/licenses/LICENSE-2.0">Apache-2.0</a></li>
 * 	<li><a href="https://opensource.org/licenses/MIT">MIT</a></li>
 * </ul>
 * #L%
 */
package io.earcam.utilitarian.charstar;

import static java.nio.charset.StandardCharsets.UTF_8;

import java.nio.ByteBuffer;
import java.nio.CharBuffer;
import java.nio.charset.Charset;
import java.util.Arrays;
import java.util.Comparator;

import javax.annotation.Nullable;
import javax.annotation.ParametersAreNonnullByDefault;

@ParametersAreNonnullByDefault
public final class CharSequences {

	private CharSequences()
	{

	}


	static CharStar backedCharSequence(char[] sequence)
	{
		return CharStar.backedCharSequence(sequence);
	}


	static CharStar charSequence(char[] sequence)
	{
		char[] encapsulated = Arrays.copyOf(sequence, sequence.length);
		return CharStar.charSequence(encapsulated);
	}


	static CharStar charSequence(CharSequence sequence)
	{
		return CharStar.charSequence(toArray(sequence));
	}


	public static boolean startsWith(CharSequence text, CharSequence prefix)
	{
		if(prefix.length() > text.length()) {
			return false;
		}
		for(int i = 0; i < prefix.length(); i++) {
			if(text.charAt(i) != prefix.charAt(i)) {
				return false;
			}
		}
		return true;
	}


	public static boolean endsWith(CharSequence text, CharSequence suffix)
	{
		if(suffix.length() > text.length()) {
			return false;
		}
		for(int i = text.length() - 1, j = suffix.length() - 1; j >= 0; i--, j--) {
			if(text.charAt(i) != suffix.charAt(j)) {
				return false;
			}
		}
		return true;
	}


	public static boolean same(@Nullable CharSequence a, @Nullable CharSequence b)
	{
		if(a == null || b == null) {
			return a == b;
		}
		if(a.length() != b.length()) {
			return false;
		}
		for(int i = 0; i < a.length(); i++) {
			if(a.charAt(i) != b.charAt(i)) {
				return false;
			}
		}
		return true;
	}


	public static int hashCode(CharSequence sequence)
	{
		int hash = 0;
		for(int i = 0; i < sequence.length(); i++) {
			hash = 31 * hash + sequence.charAt(i);
		}
		return hash;
	}


	public static CharSequence trim(CharSequence padded)
	{
		int s = 0;
		int e = padded.length();
		while(Character.isWhitespace(padded.charAt(s))) {
			s += 1;
		}
		while(Character.isWhitespace(padded.charAt(e - 1))) {
			e -= 1;
		}
		return padded.subSequence(s, e);
	}


	public static @Nullable CharSequence replace(@Nullable CharSequence sequence, char find, char replace)
	{
		if(sequence == null) {
			return null;
		}
		char[] chars = new char[sequence.length()];
		for(int i = 0; i < chars.length; i++) {
			chars[i] = sequence.charAt(i);
			if(chars[i] == find) {
				chars[i] = replace;
			}
		}
		return CharStar.backedCharSequence(chars);
	}


	/**
	 * Returns {@code true} if the argument {@code text} is {@code null} or {@link CharSequence#length()} {@code == 0}
	 * 
	 * @param text the CharSequence to test
	 * @return {@code true} IFF <i>empty</i>
	 */
	public static boolean isEmpty(@Nullable CharSequence text)
	{
		return text == null || text.length() == 0;
	}


	/**
	 * Equivalent to {@link String#lastIndexOf(int)
	 * 
	 * @param text the CharSequence to test
	 * @param character the {@code char} to find
	 * @return the index of first occurrence of argument {@code character}
	 */
	public static int lastIndexOf(CharSequence text, char character)
	{
		for(int i = text.length() - 1; i >= 0; i--) {
			if(text.charAt(i) == character) {
				return i;
			}
		}
		return -1;
	}


	public static int indexOf(CharSequence text, char character)
	{
		return indexOf(text, character, 0);
	}


	public static int indexOf(CharSequence text, char character, int start)
	{
		for(int i = start; i < text.length(); i++) {
			if(text.charAt(i) == character) {
				return i;
			}
		}
		return -1;
	}


	public static byte[] toBytes(CharSequence utf8Sequence)
	{
		return toBytes(utf8Sequence, UTF_8);
	}


	public static byte[] toBytes(CharSequence sequence, Charset charset)
	{
		ByteBuffer buffer = charset.encode(CharBuffer.wrap(sequence));
		byte[] bytes = new byte[buffer.remaining()];
		buffer.get(bytes);
		return bytes;
	}


	public static Comparator<CharSequence> comparator()
	{
		return CharSequences::compare;
	}


	public static int compare(CharSequence a, CharSequence b)
	{
		int max = Math.min(a.length(), b.length());
		int i = 0;
		while(i < max) {
			char c1 = a.charAt(i);
			char c2 = b.charAt(i);
			if(c1 != c2) {
				return c1 - c2;
			}
			i++;
		}
		return a.length() - b.length();
	}


	public static char[] toArray(CharSequence sequence)
	{
		char[] array = new char[sequence.length()];
		for(int i = 0; i < array.length; i++) {
			array[i] = sequence.charAt(i);
		}
		return array;
	}
}


























































Active mutators

INCREMENTS_MUTATOR
VOID_METHOD_CALL_MUTATOR
RETURN_VALS_MUTATOR
MATH_MUTATOR
NEGATE_CONDITIONALS_MUTATOR
INVERT_NEGS_MUTATOR
CONDITIONALS_BOUNDARY_MUTATOR

Tests examined

io.earcam.utilitarian.charstar.CharSequencesTest.trimLeading() (4 ms)
io.earcam.utilitarian.charstar.CharStarTest.backedSubsequenceMaintainsMutableState() (6 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.doesNotEndWith() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.trimBothEnds() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.indexOfStartingFromNonZero() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.compareToLessThan() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.indexOf() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.zeroLengthStringIsEmpty() (4 ms)
io.earcam.utilitarian.charstar.CharStarTest.subsequenceInvalidWhenStartIndexIsGreaterThanEndIndex() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.compareToGreaterThan() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.doesNotEndWithDifferentLength() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest._oesNotEndWith() (65 ms)
io.earcam.utilitarian.charstar.CharStarTest.notEqualToEquivalentString() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.notSame() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.nonZeroLengthStringBuilderIsNotEmpty() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.startsWith() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.indexOfNotFound() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.same() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.doesNotStartWith() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.nothingToTrim() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.toBytes() (7 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.replaceIsNullSafe() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.sameBothNull() (5 ms)
io.earcam.utilitarian.charstar.CharStarTest.equal() (3 ms)
io.earcam.utilitarian.charstar.CharStarTest.notEqualAtEnd() (4 ms)
io.earcam.utilitarian.charstar.CharStarTest.notEqualToNullObject() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.endsWithIdentical() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.nullIsEmpty() (4 ms)
io.earcam.utilitarian.charstar.CharStarTest.consistentHashCodeWithString() (3 ms)
io.earcam.utilitarian.charstar.CharStarTest.notEqualAtStart() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.notSameDifferentLength() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.lastIndexOf() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.lastIndexOfLast() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.replace() (9 ms)
io.earcam.utilitarian.charstar.CharStarTest.compareToEqual() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.notSameSecondIsNull() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.lastIndexOfFirst() (3 ms)
io.earcam.utilitarian.charstar.CharStarTest.notEqualToNullInstance() (7 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.doesNotStartWit_() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.consistentHashCodeBetweenStringBuilderAndString() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.doesNotStartWithDifferentLength() (3 ms)
io.earcam.utilitarian.charstar.CharStarTest.notEqualInMiddle() (4 ms)
io.earcam.utilitarian.charstar.CharStarTest.compareToLessThan() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.lastIndexOfNotFound() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.indexOfLast() (3 ms)
io.earcam.utilitarian.charstar.CharStarTest.subsequenceInvalidWhenStartIndexIsNegative() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.comparator() (8 ms)
io.earcam.utilitarian.charstar.CharStarTest.compareToGreaterThan() (3 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.doesNotEndWit_() (5 ms)
io.earcam.utilitarian.charstar.CharStarTest.subsequenceToStringIsOnlySubsequence() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.indexOfFirst() (7 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.trimTrailing() (4 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.startsWithIdentical() (6 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.notSameFirstIsNull() (3 ms)
io.earcam.utilitarian.charstar.CharStarTest.serializableSubsequence() (16 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.endsWith() (3 ms)
io.earcam.utilitarian.charstar.CharStarTest.subsequenceInvalidWhenEndIndexIsNegative() (3 ms)
io.earcam.utilitarian.charstar.CharStarTest.notEqualAtEndDifferentLength() (5 ms)
io.earcam.utilitarian.charstar.CharSequencesTest.compareToEqual() (5 ms)

Report generated by PIT 1.4.3

1		/*-
2		* #%L
3		* io.earcam.utilitarian.charstar
4		* %%
5		* Copyright (C) 2017 - 2018 earcam
6		* %%
7		* SPDX-License-Identifier: (BSD-3-Clause OR EPL-1.0 OR Apache-2.0 OR MIT)
8		*
9		* You <b>must</b> choose to accept, in full - any individual or combination of
10		* the following licenses:
11		* <ul>
12		* <li><a href="https://opensource.org/licenses/BSD-3-Clause">BSD-3-Clause</a></li>
13		* <li><a href="https://www.eclipse.org/legal/epl-v10.html">EPL-1.0</a></li>
14		* <li><a href="https://www.apache.org/licenses/LICENSE-2.0">Apache-2.0</a></li>
15		* <li><a href="https://opensource.org/licenses/MIT">MIT</a></li>
16		* </ul>
17		* #L%
18		*/
19		package io.earcam.utilitarian.charstar;
20
21		import static java.nio.charset.StandardCharsets.UTF_8;
22
23		import java.nio.ByteBuffer;
24		import java.nio.CharBuffer;
25		import java.nio.charset.Charset;
26		import java.util.Arrays;
27		import java.util.Comparator;
28
29		import javax.annotation.Nullable;
30		import javax.annotation.ParametersAreNonnullByDefault;
31
32		@ParametersAreNonnullByDefault
33		public final class CharSequences {
34
35		private CharSequences()
36		{
37
38		}
39
40

CharSequences.java

Mutations

Active mutators

Tests examined