org.vishia.util

Class StringFunctions_B

java.lang.Object

org.vishia.util.StringFunctions_B

public class StringFunctions_B
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	sWhiteSpaces
static java.lang.String	version Version, history and license.

Constructor Summary

Constructors

Constructor and Description
StringFunctions_B()

Method Summary

Modifier and Type	Method and Description
static boolean	checkMoreSameChars(java.lang.CharSequence src, java.lang.CharSequence... check)
static boolean	checkOneSameChars(java.lang.CharSequence src, java.lang.CharSequence... check) Checks whether any char is existing in at least one given check Strings.
static boolean	checkSameChars(java.lang.CharSequence... src) Checks whether any char is existing in all given src.
static java.lang.CharSequence	convertBackslashChars(java.lang.CharSequence src) Converts a backslash sequence to a appropriate character.
static java.lang.String	firstLine(java.lang.CharSequence src) Returns the first line of any text.
static java.lang.CharSequence	removeIndentReplaceNewline(java.lang.CharSequence src, int indent, java.lang.String indentChars, int tabSize, java.lang.String sNewline, boolean bSkipSpaces) Cleans a text which may be parsed or such, remove undesired indentation and replace the line end characters.
static java.lang.CharSequence	removeLeadingTrailingWhiteSpacesAndQuotation(java.lang.CharSequence src, char cQuotation)
static java.lang.CharSequence	removeLeadingWhiteSpaces(java.lang.CharSequence src)
static java.lang.CharSequence	replace(java.lang.CharSequence src, char cc, char cr) Replaces all occurences of cc to cr.
static java.lang.CharSequence	replaceNonIdentifierChars(java.lang.CharSequence src, char lowerOrUpper) Build a Java Identifier from a given String, maybe tag name in Xml etc.
static java.lang.String	toFirstLowercase(java.lang.String src) Converts the first character to lower case if it Character.isUpperCase(char) ('A'..'
static java.lang.String	toFirstUppercase(java.lang.String src) Converts the first character to upper case if it Character.isLowerCase(char) ('a'..'

Methods inherited from class java.lang.Object

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

Field Detail

version

public static final java.lang.String version

Version, history and license.

• 2023-02-05 Hartmut new replace(CharSequence, char, char)
• 2022-12-18 Hartmut new convertBackslashChars(CharSequence)
• 2021-02-06 Hartmut new #checkSameItem(String, CharSequence...) and #prepareCheckSameItem(String). This is newly used in the org.vishia.stimuliSelector.StimuliSelector in the script for selection. More ability.
• 2020-07-22 Hartmut new checkOneSameChars(CharSequence, CharSequence...) and checkMoreSameChars(CharSequence, CharSequence...) as enhancement to 2016-activity used in org.vishia.stimuliSelector.StimuliSelector in the script for selection.
• 2016-01-10 Hartmut new: checkSameChars(CharSequence...)
• 2015-11-07 Hartmut created: The functionality to remove indentation was used in JZcmdExecuter. Now it is implemented here for common usage.

Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:

1. You can use this source without any restriction for any desired purpose.
2. You can redistribute copies of this source to everybody.
3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
4. But the LPGL ist not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.

If you are intent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.

See Also:

Constant Field Values

sWhiteSpaces

public static final java.lang.String sWhiteSpaces

See Also:

Constant Field Values

Constructor Detail

StringFunctions_B

public StringFunctions_B()

Method Detail

firstLine

public static java.lang.String firstLine(java.lang.CharSequence src)

Returns the first line of any text.

Parameters:

src - if null then returns "" (empty String)

Returns:

returns src exclusive a "\r" or "\n"

removeLeadingWhiteSpaces

public static java.lang.CharSequence removeLeadingWhiteSpaces(java.lang.CharSequence src)

removeLeadingTrailingWhiteSpacesAndQuotation

public static java.lang.CharSequence removeLeadingTrailingWhiteSpacesAndQuotation(java.lang.CharSequence src,
                                                                                  char cQuotation)

removeIndentReplaceNewline

public static java.lang.CharSequence removeIndentReplaceNewline(java.lang.CharSequence src,
                                                                int indent,
                                                                java.lang.String indentChars,
                                                                int tabSize,
                                                                java.lang.String sNewline,
                                                                boolean bSkipSpaces)

Cleans a text which may be parsed or such, remove undesired indentation and replace the line end characters.

Parameters:

src - Any source String with indentation

indent - column which indentation should be removed

IndentChars - some Characters which are expected in the indentation area.

tabSize - User tab size to prevent tabs as indentation

sNewline - String as newline designation, usual "\n", "\r\n" or "\r".

bSkipSpaces - true then skip over the first whitespace characters in all following lines.

Returns:

either src if it does not contain a newline character and does not contain prevented whitespaces or a StringBuiler which contains the result.

checkSameChars

public static boolean checkSameChars(java.lang.CharSequence... src)

Checks whether any char is existing in all given src. This routine is used to check some conditions which are dedicated by some characters in a string.

• For Example "ACx" " BC" "Cd" contains all the char 'C' therefore this routine returns true.
• For Example "ACx" "AC" "Dx" There is no common character containing in all three sequences, returns false.

Parameters:

src - some char sequences

Returns:

true if at least one char is found which is contained in all src.

checkOneSameChars

public static boolean checkOneSameChars(java.lang.CharSequence src,
                                        java.lang.CharSequence... check)

Checks whether any char is existing in at least one given check Strings. This routine is used to check some conditions which are dedicated by some characters in a string.

• For Example "AC" " Axyz" "Cmno" both contains either the char 'A' or the char 'C', therefore this routine returns true.
• For Example "AB" " Axyz" "Cmno" The char 'B' is not found, returns false.

Parameters:

src - some chars to check

check - some strings where the check chars should be found.

Returns:

true if at least one char is found which is contained in all src.

checkMoreSameChars

public static boolean checkMoreSameChars(java.lang.CharSequence src,
                                         java.lang.CharSequence... check)

replace

public static java.lang.CharSequence replace(java.lang.CharSequence src,
                                             char cc,
                                             char cr)

Replaces all occurences of cc to cr. Often use to change \ to /

Parameters:

src -

cc -

cr -

Returns:

src itself if cc is not found, else a StringBuilder with replacement

replaceNonIdentifierChars

public static java.lang.CharSequence replaceNonIdentifierChars(java.lang.CharSequence src,
                                                               char lowerOrUpper)

Build a Java Identifier from a given String, maybe tag name in Xml etc.

Parameters:

src - Any String. Non-conform characters will be replaced by '_'

lowerOrUpper - if'a' or 'A' converts the first char to lower or upper. If '-' do not convert.

Returns:

src if src is conform (less effort) else new conform CharSequence in a StringBuilder.

convertBackslashChars

public static java.lang.CharSequence convertBackslashChars(java.lang.CharSequence src)

Converts a backslash sequence to a appropriate character. It follows the familiar Java or C/++ conventions, but also additional the possibilities for all UTF16 character similar given also in C# Some replacements follow the C# conventions, see https://learn.microsoft.com/en-us/dotnet/standard/base-types/character-escapes-in-regular-expressions

\a	0x07 (bell)	C# convention
\b	0x08 (backspace)	Java convention
\cX	0x00..0x1f (X is the ASCII 0x40..7e, builds ctrl character)	C# convention, enhanced
\e	0x1b (escape)	C# convention
\f	0x0c (form feed, page break)	Java convention
\n	0x0a (new line)	Java convention
\r	0x0d (carriage return)	Java convention
\t	0x09 (tab)	Java convention
\ u	todo UTF	C# convention
\x	0x00..FF (ASCII)	C# convention
\}	0x5F, \ itself	Java convention

Parameters:

src -

Returns:

toFirstLowercase

public static java.lang.String toFirstLowercase(java.lang.String src)

Converts the first character to lower case if it Character.isUpperCase(char) ('A'..'Z'). If the src starts with '_' or it is not an identifier, src will be returned. The rest of the src is left unchanged. Use replaceNonIdentifierChars(CharSequence, char) to convert maybe non identifier words to identifier words.

Parameters:

src -

Returns:

toFirstUppercase

public static java.lang.String toFirstUppercase(java.lang.String src)

Converts the first character to upper case if it Character.isLowerCase(char) ('a'..'z'). If the src starts with '_' or it is not an identifier, src will be returned. The rest of the src is left unchanged. Use replaceNonIdentifierChars(CharSequence, char) to convert maybe non identifier words to identifier words.

Parameters:

src -

Returns: