tfw.base.util.text

Class TextToolT

java.lang.Object

tfw.base.util.text.TextToolT

Direct Known Subclasses:

TextToolE, TextToolP

public class TextToolT
extends java.lang.Object

A pack of tool functions for text manipulating.
Throws exceptions.

Author:

Typhoon.Free.Wolf

Constructor Summary

Constructors

Constructor and Description
TextToolT()

Method Summary

Modifier and Type	Method and Description
static char	capsLower(char cIn) Changes a character to lower case.
static java.lang.String	capsLower(java.lang.String strIn) Changes a string to lower case.
static char	capsReverse(char cIn) Reverses a character to lower case.
static java.lang.String	capsReverse(java.lang.String strIn) Reverses a string to lower case.
static char	capsUpper(char cIn) Changes a character to upper case.
static java.lang.String	capsUpper(java.lang.String strIn) Changes a string to lower case.
static int	compare(java.lang.String str1, java.lang.String str2) Performs locale-insensitive comparison.
static int	compare(java.lang.String str1, java.lang.String str2, java.util.Locale locale) Performs locale-sensitive comparison.
static java.lang.String	concat(java.lang.Object... o1dArgs) Connects a bunch of true strings, or strings from ".toString()", or the mixture of them.
static java.lang.String	convert(java.lang.String strIn, java.lang.String strSourceEncoding, java.lang.String strTargetEncoding) Converts a string from old encoding to new.
static java.lang.String	eatHeadSpaces(java.lang.String strIn) Eats the SPACEs at the head of a string.
static java.lang.String	eatTailSpaces(java.lang.String strIn) Eats the SPACEs at the head of a string..
static java.lang.String	format(java.lang.String strPattern, java.lang.Object[] o1dArgs) Formats a string with the given pattern and uses it to format the given arguments.
static boolean	isInScopeIgnoreCase(java.lang.String strGiven, java.util.Collection<java.lang.String> colScope) Judges whether the given string is in the given scope, ignore case. See MiscToolT.isInScope(Object, Collection) if the judgment is case sensitive.
static boolean	isInScopeIgnoreCase(java.lang.String strGiven, java.lang.String[] str1dScope) Judges whether the given string is in the given scope, ignore case. See MiscToolT.isInScope(Object, Object[]) if the judgment is case sensitive.
static java.lang.String	n2s(java.lang.String strIn) Converts to an empty string while input is null.
static java.lang.String	o2s(java.lang.Object oIn, java.lang.String strReplacement) Converts to an empty string while input is null.
static void	patternedReplace(java.lang.StringBuffer sbIn, java.lang.String strIn1, java.lang.String strIn2) Deprecated. Under construction. No change will happen to the incoming things.
static java.lang.String	s2n(java.lang.String strIn) Converts to null while input is an empty string.
static void	simpleReplace(java.lang.StringBuffer sbIn, java.lang.String strOldContents, java.lang.String strNewContents) Replaces contents from a given string buffer.
static void	simpleReplace(java.lang.StringBuilder sbIn, java.lang.String strOldContents, java.lang.String strNewContents) Replaces contents from a given string builder.
static java.lang.String	simpleReplace(java.lang.String strIn, java.lang.String strOldContents, java.lang.String strNewContents) Replaces contents from a given string.

Methods inherited from class java.lang.Object

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

Constructor Detail

TextToolT

public TextToolT()

Method Detail

capsLower

public static char capsLower(char cIn)

Changes a character to lower case.

Parameters:

cIn - - The incoming character.

Returns:

Changed character.

capsLower

public static java.lang.String capsLower(java.lang.String strIn)

Changes a string to lower case.

Parameters:

strIn - - The incoming string.

Returns:

Changed string.

capsReverse

public static char capsReverse(char cIn)

Reverses a character to lower case.

Parameters:

cIn - - The incoming character.

Returns:

Reversed character.

capsReverse

public static java.lang.String capsReverse(java.lang.String strIn)

Reverses a string to lower case.

Parameters:

strIn - - The incoming string.

Returns:

Reversed string.

capsUpper

public static char capsUpper(char cIn)

Changes a character to upper case.

Parameters:

cIn - - The incoming character.

Returns:

Changed character.

capsUpper

public static java.lang.String capsUpper(java.lang.String strIn)

Changes a string to lower case.

Parameters:

strIn - - The incoming string.

Returns:

Changed string.

compare

public static int compare(java.lang.String str1,
                          java.lang.String str2)

Performs locale-insensitive comparison.

Parameters:

str1 - - One string to compare.

str2 - - Another string to compare.

Returns:

-1: <; 0: =; 1: >

compare

public static int compare(java.lang.String str1,
                          java.lang.String str2,
                          java.util.Locale locale)

Performs locale-sensitive comparison.

Parameters:

str1 - - One string to compare.

str2 - - Another string to compare.

locale - - Compare according to this locale.

Returns:

-1: <; 0: =; 1: >

concat

public static java.lang.String concat(java.lang.Object... o1dArgs)

Connects a bunch of true strings, or strings from ".toString()", or the mixture of them.

Parameters:

o1dArgs - - Incoming things, can be a bunch of true strings, or strings from ".toString()", or the mixture of them.

Returns:

Connected string.

convert

public static java.lang.String convert(java.lang.String strIn,
                                       java.lang.String strSourceEncoding,
                                       java.lang.String strTargetEncoding)
                                throws java.lang.NullPointerException,
                                       java.io.UnsupportedEncodingException

Converts a string from old encoding to new.

Parameters:

strIn - - Incoming string to be converted.

strSourceEncoding - - Previous encoding of incoming string.

strTargetEncoding - - Demanded new encoding of incoming string.

Returns:

Converted string.

Throws:

java.lang.NullPointerException - - While:

• Incoming string is NULL.
  
• Previous encoding is NULL or empty.
  
• Demanded new encoding is NULL or empty.
  

java.io.UnsupportedEncodingException - - If the named charset is not supported.

eatHeadSpaces

public static java.lang.String eatHeadSpaces(java.lang.String strIn)

Eats the SPACEs at the head of a string.

Parameters:

strIn - - The incoming string.

Returns:

The string which had head SPACEs eaten.

eatTailSpaces

public static java.lang.String eatTailSpaces(java.lang.String strIn)

Eats the SPACEs at the head of a string..

Parameters:

strIn - - The incoming string.

Returns:

The string which had tail SPACEs eaten.

format

public static java.lang.String format(java.lang.String strPattern,
                                      java.lang.Object[] o1dArgs)
                               throws java.lang.NullPointerException,
                                      java.lang.IllegalArgumentException

Formats a string with the given pattern and uses it to format the given arguments.

Parameters:

strPattern - - The incoming message pattern.

o1dArgs - - The arguments which will be filled into the blanks of the main string.

Returns:

Formatted string.

Throws:

java.lang.NullPointerException - - While:

• The message pattern is NULL.
  
• The arguments array is null.
  

java.lang.IllegalArgumentException - While:

• The pattern is invalid.
  
• An argument in the arguments array is not of the type expected by the format element(s).
  

n2s

public static java.lang.String n2s(java.lang.String strIn)

Converts to an empty string while input is null.

Parameters:

strIn - - The incoming string.

Returns:

Converted string.

s2n

public static java.lang.String s2n(java.lang.String strIn)

Converts to null while input is an empty string.

Parameters:

strIn - - The incoming string.

Returns:

Converted string.

o2s

public static java.lang.String o2s(java.lang.Object oIn,
                                   java.lang.String strReplacement)

Converts to an empty string while input is null.

Parameters:

oIn - - The incoming object to convert.

strReplacement - - Replacement, while the converting result is null..

Returns:

Converted string.

isInScopeIgnoreCase

public static boolean isInScopeIgnoreCase(java.lang.String strGiven,
                                          java.lang.String[] str1dScope)

Judges whether the given string is in the given scope, ignore case.
See MiscToolT.isInScope(Object, Object[]) if the judgment is case sensitive.

Parameters:

strGiven - - The given value.

str1dScope - - The reference scope.
.

Returns:

A flag of in scope or not.

• true = In scope.
  
• false = Not in scope.
  

isInScopeIgnoreCase

public static boolean isInScopeIgnoreCase(java.lang.String strGiven,
                                          java.util.Collection<java.lang.String> colScope)

Judges whether the given string is in the given scope, ignore case.
See MiscToolT.isInScope(Object, Collection) if the judgment is case sensitive.

Parameters:

strGiven - - The given value.

colScope - - The reference scope.
.

Returns:

A flag of in scope or not.

• true = In scope.
  
• false = Not in scope.
  

simpleReplace

public static java.lang.String simpleReplace(java.lang.String strIn,
                                             java.lang.String strOldContents,
                                             java.lang.String strNewContents)

Replaces contents from a given string.

Parameters:

strIn - - The incoming string.

strOldContents - - The old contents to be replaced.

strNewContents - - The new contents to replace the old.

Returns:

The target string after replacing.

simpleReplace

public static void simpleReplace(java.lang.StringBuffer sbIn,
                                 java.lang.String strOldContents,
                                 java.lang.String strNewContents)

Replaces contents from a given string buffer.

Parameters:

sbIn - - The incoming string buffer.

strOldContents - - The old contents to be replaced.

strNewContents - - The new contents to replace the old.

simpleReplace

public static void simpleReplace(java.lang.StringBuilder sbIn,
                                 java.lang.String strOldContents,
                                 java.lang.String strNewContents)

Replaces contents from a given string builder.

Parameters:

sbIn - - The incoming string builder.

strOldContents - - The old contents to be replaced.

strNewContents - - The new contents to replace the old.

patternedReplace

@Deprecated
public static void patternedReplace(java.lang.StringBuffer sbIn,
                                                java.lang.String strIn1,
                                                java.lang.String strIn2)

Deprecated. Under construction. No change will happen to the incoming things.

Finds the given pattern in a string, and replaces the found fragment to the given one.

Parameters:

sbIn - - Too old, unknown.

strIn1 - - Too old, unknown.

strIn2 - - Too old, unknown.