net.openhft.chronicle.core.util

Class StringUtils

java.lang.Object

net.openhft.chronicle.core.util.StringUtils

public final class StringUtils
extends Object

A utility class that provides a collection of static methods for advanced string manipulation.

This class contains methods for handling CharSequence and StringBuilder instances, including:

• Comparing CharSequences for content equality.
• Checking if a CharSequence starts or ends with a specific substring.
• Setting the length and content of a StringBuilder.
• Transforming a string to Title Case.
• Reversing part of a StringBuilder's content.
• Generating NumberFormatException with custom messages.

Note: This class is not meant to be instantiated and therefore has a private constructor.

Method Summary

Modifier and Type	Method and Description
static boolean	endsWith(@NotNull CharSequence source, @NotNull String endsWith) Checks if the given CharSequence ends with the specified string, in a case-insensitive way.
static boolean	equalsCaseIgnore(@Nullable CharSequence s, @NotNull CharSequence cs) Compares two CharSequences for equality ignoring case considerations.
static byte[]	extractBytes(@NotNull String s)
static byte[]	extractBytes(@NotNull StringBuilder sb)
static char[]	extractChars(@NotNull String s)
static char[]	extractChars(StringBuilder sb)
static @Nullable String	firstLowerCase(@Nullable String str)
static byte	getStringCoder(@NotNull String str)
static byte	getStringCoder(@NotNull StringBuilder str)
static boolean	isEqual(@Nullable CharSequence s, @Nullable CharSequence cs) Compares two CharSequences for content equality.
static boolean	isEqual(@Nullable StringBuilder s, @Nullable CharSequence cs) Compares a StringBuilder and a CharSequence for content equality.
static @NotNull String	newString(char[] chars)
static @NotNull String	newStringFromBytes(byte[] bytes)
static double	parseDouble(@NotNull CharSequence in)
static int	parseInt(CharSequence s, int radix)
static long	parseLong(CharSequence s, int radix)
static void	reverse(StringBuilder text, int start) Reverses a portion of the content of a StringBuilder in place, from the given start index to the end.
static void	set(@NotNull StringBuilder sb, CharSequence cs) Sets the content of a StringBuilder to the content of the given CharSequence.
static void	setCount(@NotNull StringBuilder sb, int count)
static void	setLength(@NotNull StringBuilder sb, int length) Sets the length of a StringBuilder without altering its content.
static boolean	startsWith(@NotNull CharSequence source, @NotNull String startsWith) Checks if the given CharSequence starts with the specified string.
static @Nullable String	toString(@Nullable Object o) Returns the string representation of the specified object.
static @Nullable String	toTitleCase(@Nullable String name) Converts the given string to title case.

Methods inherited from class java.lang.Object

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

Method Detail

isEqual

public static boolean isEqual(@Nullable
                              @Nullable StringBuilder s,
                              @Nullable
                              @Nullable CharSequence cs)

Compares a StringBuilder and a CharSequence for content equality.

Parameters:

s - the StringBuilder to be compared.

cs - the CharSequence to be compared.

Returns:

true if both character sequences are equal, false otherwise.

setLength

public static void setLength(@NotNull
                             @NotNull StringBuilder sb,
                             int length)

Sets the length of a StringBuilder without altering its content. This operation has performance benefits compared to StringBuilder.setLength(int).

Parameters:

sb - the StringBuilder whose length needs to be set.

length - the new length.

Throws:

AssertionError - if there is an IllegalAccessException or IllegalArgumentException.

set

public static void set(@NotNull
                       @NotNull StringBuilder sb,
                       CharSequence cs)

Sets the content of a StringBuilder to the content of the given CharSequence.

Parameters:

sb - the StringBuilder to be modified.

cs - the CharSequence whose content will be set in the StringBuilder.

endsWith

public static boolean endsWith(@NotNull
                               @NotNull CharSequence source,
                               @NotNull
                               @NotNull String endsWith)

Checks if the given CharSequence ends with the specified string, in a case-insensitive way.

Parameters:

source - the CharSequence to be checked.

endsWith - the string to check if the CharSequence ends with.

Returns:

true if the CharSequence ends with the specified string, false otherwise.

startsWith

public static boolean startsWith(@NotNull
                                 @NotNull CharSequence source,
                                 @NotNull
                                 @NotNull String startsWith)

Checks if the given CharSequence starts with the specified string.

Parameters:

source - the CharSequence to be checked.

startsWith - the string to check if the CharSequence starts with.

Returns:

true if the CharSequence starts with the specified string, false otherwise.

isEqual

public static boolean isEqual(@Nullable
                              @Nullable CharSequence s,
                              @Nullable
                              @Nullable CharSequence cs)

Compares two CharSequences for content equality.

Parameters:

s - the first CharSequence to be compared.

cs - the second CharSequence to be compared.

Returns:

true if both character sequences are equal, false otherwise.

extractChars

public static char[] extractChars(StringBuilder sb)

equalsCaseIgnore

public static boolean equalsCaseIgnore(@Nullable
                                       @Nullable CharSequence s,
                                       @NotNull
                                       @NotNull CharSequence cs)

Compares two CharSequences for equality ignoring case considerations.

Parameters:

s - the first CharSequence to be compared.

cs - the second CharSequence to be compared.

Returns:

true if the CharSequences are equal irrespective of case, false otherwise.

toString

@Nullable
public static @Nullable String toString(@Nullable
                                                  @Nullable Object o)

Returns the string representation of the specified object.

Parameters:

o - the object whose string representation is to be returned.

Returns:

the string representation of the specified object or null if the object is null.

getStringCoder

public static byte getStringCoder(@NotNull
                                  @NotNull String str)

getStringCoder

public static byte getStringCoder(@NotNull
                                  @NotNull StringBuilder str)

extractBytes

public static byte[] extractBytes(@NotNull
                                  @NotNull StringBuilder sb)

extractChars

public static char[] extractChars(@NotNull
                                  @NotNull String s)

extractBytes

public static byte[] extractBytes(@NotNull
                                  @NotNull String s)

setCount

public static void setCount(@NotNull
                            @NotNull StringBuilder sb,
                            int count)

newString

@NotNull
public static @NotNull String newString(char[] chars)

newStringFromBytes

@NotNull
public static @NotNull String newStringFromBytes(byte[] bytes)

firstLowerCase

@Nullable
public static @Nullable String firstLowerCase(@Nullable
                                                        @Nullable String str)

parseDouble

public static double parseDouble(@NotNull
                                 @NotNull CharSequence in)

toTitleCase

@Nullable
public static @Nullable String toTitleCase(@Nullable
                                                     @Nullable String name)

Converts the given string to title case. It will capitalize the first letter of the string and then replace spaces with underscores and adjust casing for subsequent characters.

Parameters:

name - the input string to be converted.

Returns:

the converted string in title case with underscores, or null if the input is null.

reverse

public static void reverse(StringBuilder text,
                           int start)

Reverses a portion of the content of a StringBuilder in place, from the given start index to the end.

Parameters:

text - the StringBuilder whose content needs to be partially reversed.

start - the index from which to start the reverse operation.

parseInt

public static int parseInt(CharSequence s,
                           int radix)
                    throws NumberFormatException

Throws:

NumberFormatException

parseLong

public static long parseLong(CharSequence s,
                             int radix)
                      throws NumberFormatException

Throws:

NumberFormatException