org.spf4j.base

Class Strings

java.lang.Object

org.spf4j.base.Strings

public final class Strings
extends Object

Author:

zoly

Field Summary

Fields

Modifier and Type	Field and Description
static String	EOL

Method Summary

Modifier and Type	Method and Description
static void	appendJsonStringEscapedChar(char c, Appendable jsonString)
static void	appendJsonStringEscapedChar(char c, StringBuilder jsonString)
static void	appendSpaces(Appendable to, int nrSpaces)
static void	appendSpaces(StringBuilder to, int nrSpaces)
static void	appendUnsignedString(StringBuilder sb, int nr, int shift)
static void	appendUnsignedString(StringBuilder sb, long nr, int shift)
static void	appendUnsignedStringPadded(Appendable sb, int nr, int shift, int padTo)
static void	appendUnsignedStringPadded(StringBuilder sb, int nr, int shift, int padTo)
static String	commonPrefix(String... strs)
static int	compareTo(CharSequence s, CharSequence t) Deprecated. use CharSequences.compare
static boolean	contains(CharSequence string, char... chars) Deprecated. use CharSequences.containsAnyChar instead.
static boolean	contains(String string, char... chars)
static CharsetDecoder	createUtf8Decoder()
static CharsetEncoder	createUtf8Encoder()
static String	decode(CharsetDecoder cd, byte[] ba, int off, int len)
static int	distance(String s1, String s2) Deprecated. use CharSequences.distance instead.
static byte[]	encode(CharsetEncoder ce, char[] ca, int off, int len)
static int	encode(CharsetEncoder ce, char[] ca, int off, int len, byte[] targetArray)
static boolean	endsWith(CharSequence qc, CharSequence with) Deprecated.
static boolean	equals(CharSequence s, CharSequence t) Deprecated.
static void	escapeJsonString(String toEscape, Appendable jsonString)
static void	escapeJsonString(String toEscape, StringBuilder jsonString) Utility method to escape java strings to json strings.
static String	fromUtf8(byte[] bytes) Optimized UTF8 decoder.
static String	fromUtf8(byte[] bytes, int startIdx, int length)
static int	getmaxNrBytes(CharsetEncoder ce, int nrChars)
static CharsetDecoder	getUTF8CharsetDecoder()
static CharsetEncoder	getUTF8CharsetEncoder()
static int	hashcode(CharSequence cs) Deprecated.
static boolean	regionMatches(CharSequence t, int toffset, CharSequence other, int ooffset, int plen) Deprecated. use CharSequences.regionMatches.
static char[]	steal(String str) Steal the underlying character array of a String.
static CharSequence	subSequence(CharSequence seq, int startIdx, int endIdx) Deprecated.
static byte[]	toUtf8(String str) Optimized UTF8 string encoder.
static String	truncate(String value, int length)
static String	unescape(String what)
static String	withFirstCharLower(String str)
static String	wrap(char[] chars) Create a String based on the provided character array.
static void	writeReplaceWhitespaces(String str, char replacement, Appendable writer)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EOL

public static final String EOL

Method Detail

distance

@Deprecated
public static int distance(@Nonnull
                                       String s1,
                                       @Nonnull
                                       String s2)

Deprecated. use CharSequences.distance instead.

unescape

@Nullable
public static String unescape(@Nullable
                                        String what)

contains

public static boolean contains(String string,
                               char... chars)

contains

@Deprecated
public static boolean contains(CharSequence string,
                                           char... chars)

Deprecated. use CharSequences.containsAnyChar instead.

withFirstCharLower

public static String withFirstCharLower(String str)

writeReplaceWhitespaces

public static void writeReplaceWhitespaces(String str,
                                           char replacement,
                                           Appendable writer)
                                    throws IOException

Throws:

IOException

steal

public static char[] steal(String str)

Steal the underlying character array of a String.

Parameters:

str -

Returns:

wrap

public static String wrap(char[] chars)

Create a String based on the provided character array. No copy of the array is made.

Parameters:

chars -

Returns:

createUtf8Encoder

public static CharsetEncoder createUtf8Encoder()

createUtf8Decoder

public static CharsetDecoder createUtf8Decoder()

getUTF8CharsetEncoder

public static CharsetEncoder getUTF8CharsetEncoder()

getUTF8CharsetDecoder

public static CharsetDecoder getUTF8CharsetDecoder()

encode

public static byte[] encode(CharsetEncoder ce,
                            char[] ca,
                            int off,
                            int len)

getmaxNrBytes

public static int getmaxNrBytes(CharsetEncoder ce,
                                int nrChars)

encode

public static int encode(CharsetEncoder ce,
                         char[] ca,
                         int off,
                         int len,
                         byte[] targetArray)

decode

public static String decode(CharsetDecoder cd,
                            byte[] ba,
                            int off,
                            int len)

fromUtf8

public static String fromUtf8(byte[] bytes)

Optimized UTF8 decoder. Here is a benchmark comparison with the JDK implementation (see EncodingBenchmark.java in the benchmark project): EncodingBenchmark.stringDecode thrpt 10 16759798.463 ± 343505.144 ops/s EncodingBenchmark.fastStringDecode thrpt 10 17413298.464 ± 301756.867 ops/s

Parameters:

bytes -

Returns:

fromUtf8

public static String fromUtf8(byte[] bytes,
                              int startIdx,
                              int length)

toUtf8

public static byte[] toUtf8(String str)

Optimized UTF8 string encoder. comparison with the stock JDK implementation (see EncodingBenchmark.java in the benchmark project): EncodingBenchmark.stringEncode thrpt 10 9481668.776 ± 252543.135 ops/s EncodingBenchmark.fastStringEncode thrpt 10 22469383.612 ± 898677.892 ops/s

Parameters:

str -

Returns:

compareTo

@Deprecated
public static int compareTo(@Nonnull
                                        CharSequence s,
                                        @Nonnull
                                        CharSequence t)

Deprecated. use CharSequences.compare

equals

@Deprecated
public static boolean equals(@Nonnull
                                         CharSequence s,
                                         @Nonnull
                                         CharSequence t)

Deprecated.

hashcode

@Deprecated
public static int hashcode(CharSequence cs)

Deprecated.

subSequence

@Deprecated
public static CharSequence subSequence(CharSequence seq,
                                                   int startIdx,
                                                   int endIdx)

Deprecated.

endsWith

@Deprecated
public static boolean endsWith(CharSequence qc,
                                           CharSequence with)

Deprecated.

escapeJsonString

public static void escapeJsonString(@Nonnull
                                    String toEscape,
                                    StringBuilder jsonString)

Utility method to escape java strings to json strings.

Parameters:

toEscape - - the java string to escape.

jsonString - - the destination json String builder.

escapeJsonString

public static void escapeJsonString(@Nonnull
                                    String toEscape,
                                    Appendable jsonString)
                             throws IOException

Throws:

IOException

appendJsonStringEscapedChar

public static void appendJsonStringEscapedChar(char c,
                                               StringBuilder jsonString)

appendJsonStringEscapedChar

public static void appendJsonStringEscapedChar(char c,
                                               Appendable jsonString)
                                        throws IOException

Throws:

IOException

appendUnsignedString

public static void appendUnsignedString(StringBuilder sb,
                                        long nr,
                                        int shift)

appendUnsignedString

public static void appendUnsignedString(StringBuilder sb,
                                        int nr,
                                        int shift)

appendUnsignedStringPadded

public static void appendUnsignedStringPadded(StringBuilder sb,
                                              int nr,
                                              int shift,
                                              int padTo)

appendUnsignedStringPadded

public static void appendUnsignedStringPadded(Appendable sb,
                                              int nr,
                                              int shift,
                                              int padTo)
                                       throws IOException

Throws:

IOException

appendSpaces

public static void appendSpaces(Appendable to,
                                int nrSpaces)
                         throws IOException

Throws:

IOException

appendSpaces

public static void appendSpaces(StringBuilder to,
                                int nrSpaces)

regionMatches

@Deprecated
public static boolean regionMatches(CharSequence t,
                                                int toffset,
                                                CharSequence other,
                                                int ooffset,
                                                int plen)

Deprecated. use CharSequences.regionMatches.

truncate

public static String truncate(@Nonnull
                              String value,
                              int length)

commonPrefix

@Nonnull
public static String commonPrefix(@Nonnull
                                           String... strs)