|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectabk.core.util.StringUtils
public final class StringUtils
Métodos de utilidad cuando se trabaja con cadenas.
Field Summary | |
---|---|
static String |
EMPTY
Una cadena vacía: "" . |
static String |
NEWLINE
La cadena de nueva línea, conforme el formato del sistema operativo. |
Constructor Summary | |
---|---|
private |
StringUtils()
Impide la creación de instancias de StringUtils. |
Method Summary | |
---|---|
static String |
capitalize(CharSequence name,
CharSequence prefix)
Método de utilidad que toma una secuencia de caracteres y devuelve una copia con la capitalización invertida del nombre de una variable Java, conforme CharUtils.capitalize(char[], int) y precedida de un prefijo opcional. |
static int |
compareIgnoreCase(String c1,
String c2)
Comparación a salvo de nulos de dos cadenas de texto ignorando si son mayúsculas o minúsculas y asumiendo que null es menor que cualquier instancia no nula. |
static int |
compareIgnoreCase(String c1,
String c2,
boolean nullGreater)
Comparación a salvo de nulos de dos cadenas de texto ignorando si son mayúsculas o minúsculas. |
static boolean |
contentEquals(CharSequence cs1,
CharSequence cs2)
Devuelve true si el contenido de dos secuencias de caracteres es idéntico. |
static String |
decapitalize(CharSequence name,
int offset)
Método de utilidad que toma una secuencia de caracters y devuelve una cadena de texto con la capitalización normal del nombre de una variable Java conforme CharUtils.decapitalize(char[],int) a partir de una posición offset. |
static String |
defaultString(String s)
Devuelve la misma cadena que se le pasa, o bien el valor alternativo EMPTY si s es nulo. |
static boolean |
equalsIgnoreCase(CharSequence cs1,
CharSequence cs2)
Devuelve true si el contenido de dos secuencias de caracteres es el mismo sin
distinguir entre mayúsculas y minúsculas. |
static void |
getChars(CharSequence cs,
int srcBegin,
int srcEnd,
char[] dst,
int dstBegin)
Copia un subconjunto de caracteres en un vector de caracteres que se le pasa. |
static int |
hashCode(CharSequence cs)
Devuelve el código hash del contenido de una secuencia de caracteres. |
static boolean |
isBlank(CharSequence cs)
Comprueba si una cadena es nula, vacía o formada únicamente por espacios, definidos como tal conforme al método Character.isWhitespace(int). |
static boolean |
isDigits(CharSequence value)
Comprueba si la secuencia de caracteres contiene únicamente dígitos Unicode. |
static boolean |
isEmpty(CharSequence s)
Comprueba si una cadena es nula o vacía. |
static String |
leftPad(CharSequence str,
int size)
Rellena por la izquierda una cadena con espacios hasta que el resultado tenga como mínimo un tamaño dado. |
static String |
leftPad(CharSequence str,
int size,
char padChar)
Rellena por la izquierda una cadena con un caracter especificado hasta que el resultado tenga como mínimo un tamaño dado. |
static String |
leftPad(CharSequence str,
int size,
CharSequence padStr)
Rellena por la izquierda una cadena con otra especificada hasta que el resultado tenga como mínimo un tamaño especificado. |
static int |
length(CharSequence s)
Devuelve la longitud de la cadena, o cero si la cadena recibida es nula. |
static String |
rightPad(CharSequence str,
int size)
Rellena por la izquierda una cadena con espacios hasta que el resultado tenga como mínimo un tamaño dado. |
static String |
rightPad(CharSequence str,
int size,
char padChar)
Rellena por la derecha una cadena con un caracter especificado hasta que el resultado tenga como mínimo un tamaño dado. |
static String |
rightPad(CharSequence str,
int size,
CharSequence padStr)
Rellena por la derecha una cadena con otra especificada hasta que el resultado tenga como mínimo un tamaño especificado. |
static String |
strip(CharSequence cs)
Devuelve una copia de una secuencia de caracteres sin los posibles espacios iniciales o finales. |
static String |
stripToEmpty(CharSequence cs)
Ejecuta una operación strip(CharSequence) sobre la secuencia, asegurándose de devolver una cadena vacía en caso de que el resultado sea una cadena nula. |
static String |
stripToNull(CharSequence cs)
Ejecuta una operación strip(CharSequence) sobre la secuencia, asegurándose de devolver una cadena nula en caso de que el resultado sea una cadena vacía. |
static CharSequence |
subSequence(CharSequence cs,
int srcBegin,
int srcEnd)
Copia un subconjunto de una cadena de caracteres. |
static char[] |
toCharArray(CharSequence cs)
Devuelve una copia del contenido de un CharSequence en forma de vector de caracteres. |
static String |
toLowerCase(String s)
Convierte una cadena en minúsculas, usando Locale por defecto, protegiendo la llamada de excepciones NullPointerException. |
static String |
toLowerCase(String s,
Locale locale)
Convierte una cadena en minúsculas, con el Locale especificado, protegiendo la llamada de excepciones NullPointerException. |
static String |
toUnderscoreCase(CharSequence camelName)
Convierte un nombre dado en camelCase al nombre correspondiente de la base de datos, dado en mayúsculas y separado por guiones bajos ( '_' ). |
static String |
toUpperCase(String s)
Convierte una cadena en mayúsculas, usando Locale por defecto, protegiendo la llamada de excepciones NullPointerException. |
static String |
toUpperCase(String s,
Locale locale)
Convierte una cadena en mayúsculas, con el Locale especificado, protegiendo la llamada de excepciones NullPointerException. |
static String |
trim(CharSequence cs)
Devuelve una copia de una secuencia de caracteres sin los posibles espacios iniciales o finales. |
static String |
trimToEmpty(CharSequence cs)
Ejecuta una operación trim(CharSequence) sobre la secuencia, asegurándose de devolver una cadena vacía en caso de que el resultado sea una cadena nula. |
static String |
trimToNull(CharSequence cs)
Ejecuta una operación trim(CharSequence) sobre la secuencia, asegurándose de devolver una cadena nula en caso de que el resultado sea una cadena vacía. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String EMPTY
""
.
public static final String NEWLINE
Constructor Detail |
---|
private StringUtils()
Method Detail |
---|
public static final int length(CharSequence s)
s
- Cadena cuya longitud se consulta.
public static final boolean isEmpty(CharSequence s)
s
- Cadena a comprobar.
true
si la cadena es nula o vacía.public static final boolean isBlank(CharSequence cs)
isBlank(null) = true isBlank("") = true isBlank(" ") = true isBlank("pep") = false isBlank(" pep ") = false
cs
- Cadena a comprobar.
true
si la cadena es nula o vacía.Character.isWhitespace(int)
public static final String defaultString(String s)
s
- Cadena que se evalua.
public static final char[] toCharArray(CharSequence cs)
cs
- Secuencia de caracteres.
public static final void getChars(CharSequence cs, int srcBegin, int srcEnd, char[] dst, int dstBegin)
cs
- Instancia desde donde se copian los caracteres. Si es nulo se trata como un
vector vacío.srcBegin
- Índice del primer caracter a copiar.srcEnd
- Índice del carácter en el que se para la copia (no incluido).dst
- Vector de caracteres donde dejar la copia.dstBegin
- Posición dentro de dst donde se inicia la copia.
NullPointerException
- si dst es nulo.
IndexOutOfBoundsException
- si los valores de srcBegin, srcEnd y
dstBegin generan algún error de desbordabimiento
dentro de cs o dst.public static final CharSequence subSequence(CharSequence cs, int srcBegin, int srcEnd)
cs
- Instancia desde donde se copian los caracteres. Si es nulo se trata como un
vector vacío.srcBegin
- Índice del primer caracter a copiar.srcEnd
- Índice del carácter en el que se para la copia (no incluido).
IndexOutOfBoundsException
- si los valores de srcBegin, srcEnd
generan algún error de desbordabimiento dentro de
cs.public static final String trim(CharSequence cs)
cs
- Secuencia de caracteres a limpiar de espacios. Si es nula se devuelve null
.
public static final String trimToEmpty(CharSequence cs)
cs
- Secuencia de caracteres a limpiar de espacios. Si es nula se trata como una cadena
vacía.
null
.trim(CharSequence)
public static final String trimToNull(CharSequence cs)
cs
- Secuencia de caracteres a limpiar de espacios. Si es nula se trata como una cadena
vacía.
null
si el
resultado es una cadena vacía.trim(CharSequence)
public static final String strip(CharSequence cs)
true
. En caso de que la
secuencia original no tenga espacios ni al principio ni al final, se devuelve la misma
secuencia.
cs
- Secuencia de caracteres a limpiar de espacios. Si es nula se devuelve null
.
Character.isWhitespace(int)
public static final String stripToEmpty(CharSequence cs)
cs
- Secuencia de caracteres a limpiar de espacios. Si es nula se trata como una cadena
vacía.
null
.strip(CharSequence)
public static final String stripToNull(CharSequence cs)
cs
- Secuencia de caracteres a limpiar de espacios. Si es nula se trata como una cadena
vacía.
null
si el
resultado es una cadena vacía.strip(CharSequence)
public static final String decapitalize(CharSequence name, int offset)
Por ejemplo, la llamada
StringUtils.decapitalize("isEmpty", 2)devolverá
"empty"
.
name
- Secuencia a transformar.offset
- Posición dentro de name a partir de la cual se hace la
descapitalización.
StringIndexOutOfBoundsException
- si offset es menor que cero o mayor que la
longitud de name.CharUtils.decapitalize(char[],int)
public static final String capitalize(CharSequence name, CharSequence prefix)
Por ejemplo, la llamada
StringUtils.capitalize("empty", "is")Devolverá
"isEmpty"
.
name
- Secuencia a transformar. Si name es nulo se comporta como si fuese un
vector vacío.prefix
- Prefijo que se copia en la respuesta delante del vector convertido. Por ejemplo
"get"
.
CharUtils.capitalize(char[], int)
public static final String toLowerCase(String s, Locale locale)
s
- Cadena a convertir. Puede ser null
.locale
- Especificación del idioma a utilizar. Si se pasa null
se usa
Locale.getDefault().
public static final String toLowerCase(String s)
s
- Cadena a convertir. Puede ser null
.
public static final String toUpperCase(String s, Locale locale)
s
- Cadena a convertir. Puede ser null
.locale
- Especificación del idioma a utilizar. Si se pasa null
se usa
Locale.getDefault().
public static final String toUpperCase(String s)
s
- Cadena a convertir. Puede ser null
.
public static final String toUnderscoreCase(CharSequence camelName)
'_'
).
camelName
- Nombre en formato camelCase
.
CAMEL_CASE
). Si recibe null
o una cadena vacía se devuelve el
propio parámetro camelName.public static int compareIgnoreCase(String c1, String c2, boolean nullGreater)
c1
- Primera cadena, puede ser nula.c2
- Segunda cadena, puede ser nula.nullGreater
- Si vale true
, se considera que un valor nulo es mayor que cualquier
valor no nulo. En caso contrario, el valor nulo es menor que cualquier
valor no nulo.
ObjectUtils.compare(Object, Object, boolean, Comparator)
,
String.CASE_INSENSITIVE_ORDER
public static int compareIgnoreCase(String c1, String c2)
null
es menor que cualquier instancia no nula.
c1
- Primera cadena, puede ser nula.c2
- Segunda cadena, puede ser nula.
compareIgnoreCase(String, String, boolean)
,
String.CASE_INSENSITIVE_ORDER
public static boolean isDigits(CharSequence value)
false
.
StringUtils.isDigits(null) = false StringUtils.isDigits("") = false StringUtils.isDigits(" ") = false StringUtils.isDigits("123") = true StringUtils.isDigits("12 3") = false StringUtils.isDigits("ab2c") = false StringUtils.isDigits("12-3") = false StringUtils.isDigits("12.3") = false
value
- La secuencia a comprobar. Puede ser nula.
true
si value contiene únicamente dígitos,
false
si contiene algún caracter que no sea un dígito o si
value es nula o está vacía.public static boolean contentEquals(CharSequence cs1, CharSequence cs2)
true
si el contenido de dos secuencias de caracteres es idéntico.
Un valor nulo y una secuencia vacía se consideran iguales: ninguna de las dos tiene caracteres.
cs1
- Primera secuencia de caracteres a comparar.cs2
- Segunda secuencia de caracteres a comparar.
true
si el contenido de dos secuencias de caracteres es idéntico.public static boolean equalsIgnoreCase(CharSequence cs1, CharSequence cs2)
true
si el contenido de dos secuencias de caracteres es el mismo sin
distinguir entre mayúsculas y minúsculas.
Un valor nulo y una secuencia vacía se consideran iguales: ninguna de las dos tiene caracteres.
cs1
- Primera secuencia de caracteres a comparar.cs2
- Segunda secuencia de caracteres a comparar.
true
si el contenido de dos secuencias de caracteres es el mismo sin
distinguir entre mayúsculas y minúsculas.public static int hashCode(CharSequence cs)
El algoritmo del cálculo es el mismo que el de String.hashCode(). El código hash se calcula como:
cs[0]*31^(n-1) + cs[1]*31^(n-2) + ... + cs[n-1]usando aritmética entera, donde cs[i] es el i-ésimo caracter de la secuencia, n es la longitud de la misma, y ^ es el operador exponencial. El código hash de una secuencia vací es cero.
cs
- Secuencia de caracteres.
String.hashCode()
public static String rightPad(CharSequence str, int size)
StringUtils.rightPad(null, 0) = "" StringUtils.rightPad("", 0) = "" StringUtils.rightPad(null, 3) = " " StringUtils.rightPad("", 3) = " " StringUtils.rightPad("bat", 3) = "bat" StringUtils.rightPad("bat", 5) = "bat " StringUtils.rightPad("bat", 1) = "bat" StringUtils.rightPad("bat", -1) = "bat"
str
- La cadena a rellenar. Si es nula equivale a una cadena vacía.size
- Tamaño hasta el que rellenar.
public static String rightPad(CharSequence str, int size, char padChar)
StringUtils.rightPad(null, 0, *) = "" StringUtils.rightPad("", 0, *) = "" StringUtils.rightPad(null, 3, 'z') = "zzz" StringUtils.rightPad("", 3, 'z') = "zzz" StringUtils.rightPad("bat", 3, 'z') = "bat" StringUtils.rightPad("bat", 5, 'z') = "batzz" StringUtils.rightPad("bat", 1, 'z') = "bat" StringUtils.rightPad("bat", -1, 'z') = "bat"
str
- La cadena a rellenar. Si es nula equivale a una cadena vacía.size
- Tamaño hasta el que rellenar.padChar
- El caracter con el que rellenar.
public static String rightPad(CharSequence str, int size, CharSequence padStr)
StringUtils.rightPad(null, 0, *) = "" StringUtils.rightPad("", 0, *) = "" StringUtils.rightPad(null, 3, "z") = "zzz" StringUtils.rightPad("", 3, "z") = "zzz" StringUtils.rightPad("bat", 3, "yz") = "bat" StringUtils.rightPad("bat", 5, "yz") = "batyz" StringUtils.rightPad("bat", 8, "yz") = "batyzyzy" StringUtils.rightPad("bat", 1, "yz") = "bat" StringUtils.rightPad("bat", -1, "yz") = "bat" StringUtils.rightPad("bat", 5, null) = "bat " StringUtils.rightPad("bat", 5, "") = "bat "
str
- La cadena a rellenar. Si es nula equivale a una cadena vacía.size
- Tamaño hasta el que rellenar.padStr
- La cadena con la que rellenar. Si se nula o vacía se rellena con
espacios.
public static String leftPad(CharSequence str, int size)
StringUtils.leftPad(null, 0) = "" StringUtils.leftPad("", 0) = "" StringUtils.leftPad(null, 3) = " " StringUtils.leftPad("", 3) = " " StringUtils.leftPad("bat", 3) = "bat" StringUtils.leftPad("bat", 5) = " bat" StringUtils.leftPad("bat", 1) = "bat" StringUtils.leftPad("bat", -1) = "bat"
str
- La cadena a rellenar. Si es nula equivale a una cadena vacía.size
- Tamaño hasta el que rellenar.
public static String leftPad(CharSequence str, int size, char padChar)
StringUtils.leftPad(null, 0, *) = "" StringUtils.leftPad("", 0, *) = "" StringUtils.leftPad(null, 3, 'z') = "zzz" StringUtils.leftPad("", 3, 'z') = "zzz" StringUtils.leftPad("bat", 3, 'z') = "bat" StringUtils.leftPad("bat", 5, 'z') = "zzbat" StringUtils.leftPad("bat", 1, 'z') = "bat" StringUtils.leftPad("bat", -1, 'z') = "bat"
str
- La cadena a rellenar. Si es nula equivale a una cadena vacía.size
- Tamaño hasta el que rellenar.padChar
- El caracter con el que rellenar.
public static String leftPad(CharSequence str, int size, CharSequence padStr)
StringUtils.leftPad(null, 0, *) = "" StringUtils.leftPad("", 0, *) = "" StringUtils.leftPad(null, 3, "z") = "zzz" StringUtils.leftPad("", 3, "z") = "zzz" StringUtils.leftPad("bat", 3, "yz") = "bat" StringUtils.leftPad("bat", 5, "yz") = "yzbat" StringUtils.leftPad("bat", 8, "yz") = "yzyzybat" StringUtils.leftPad("bat", 1, "yz") = "bat" StringUtils.leftPad("bat", -1, "yz") = "bat" StringUtils.leftPad("bat", 5, null) = " bat" StringUtils.leftPad("bat", 5, "") = " bat"
str
- La cadena a rellenar. Si es nula equivale a una cadena vacía.size
- Tamaño hasta el que rellenar.padStr
- La cadena con la que rellenar. Si se nula o vacía se rellena con
espacios.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |