C. LAS CLASES STRING Y STRINGBUFFER.

C.1 La clase String

C.1.1 Constructores de la clase String.

public String();
Construye un string vacío.

public String(byte bytes[]);

Construye un string a partir de un vector de bytes codificados
dependiendo de la plataforma (por ejemplo, ASCII), por lo tanto, la
longitud del vector no tiene porqué coincidir siempre con la del string.
Ejemplo: byte bytes[]={65,66};
String s = new String(bytes);
“AB”
public String(byte bytes[], int posición, int cantidad);
Construye un string a partir de un vector de bytes codificados
dependiendo de la plataforma. Para ello toma el primer byte que se
encuentra en la posición indicada como parámetro y tantos bytes del
vector como se indica en el parámetro “cantidad”.
Ejemplo: byte bytes[]={65,66,67,68,69};
String s = new String(bytes, 1 , 3);
BCD
public String(char valor[])
Construye un string inicializado por un vector de caracteres (valor).
Ejemplo: char c[] = {‘H’,’o’,’l’,’a’};
String s = new String( c );

public String(char valor[], int posición, int cantidad);

Construye un string inicializado por un subvector de caracteres. El primer
carácter del string será el indicado por el primer entero (posición),

283
 Las clases String y StringBuffer.

teniendo en cuenta que los vectores comienzan por el índice cero. La

longitud del string será especificado por el segundo entero (cantidad).
Ejemplo: char c[] = {‘H’,’o’,’l’,’a’};
String s = new String( c , 1 , 2 );
“ol”
public String(String valor);
Construye un String que es copia del String especificado como
parámetro.

Ejemplo: String s = new String(“Hola mundo”);

public String(StringBuffer buffer);

Construye un nuevo String a partir de un StringBuffer.

C.1.2 Métodos de la clase String.

public char charAt(int posición);

Devuelve el carácter en la posición especificada por el entero que se pasa
como parámetro, teniendo en cuenta que el primer elemento tiene el
índice cero.

public int compareTo(String otroString);

Compara el string con el string que se pasa como parámetro, devolviendo
0 si son iguales, un número menor que cero si es menor, y un número
mayor que cero si es mayor.

public String concat(String str);

Concatena el string especificado como parámetro al final de este string.

public static String copyValueOf(char datos[], int posición, int cantidad);

Devuelve un String equivalente al vector de caracteres con inicio en el
primer entero y longitud del segundo entero.

public static String copyValueOf(char datos[]);

Equivalente al método anterior pero con el vector entero.

284
 Las clases String y StringBuffer.

public boolean endsWith(String sufijo);

Devuelve true si el string tiene como sufijo el String que se pasa como
parámetro y false en caso contrario.

public boolean equals(Object objeto);

Compara este String con el objeto especificado. Para devolver true, este
objeto no debe ser null y debe ser un String con la misma secuencia de
caracteres.

public boolean equalsIgnoreCase(String otroString);

Devuelve true si los dos Strings son iguales, pero antes de comparar,
convierte el String a minúsculas.

public byte[] getBytes();

Copia caracteres del String en un vector de bytes utilizando la
codificación dependiente de la plataforma.

public void getChars(int inicioOrigen, int finOrigen, char destino[], int

inicioDestino);
Copia desde la posición inicioOrigen hasta finOrigen todos los caracteres
del String y los guarda en el vector de caracteres destino empezando
por la posición inicioDestino.

public int hashCode();

Devuelve el código hash para este String.

public int indexOf(char ch);

Devuelve el índice de la primera ocurrencia del carácter especificado.

public int indexOf(char ch, int desdePosición);

Similar al método anterior, pero empezando a buscar desde la posición
indicada por el parámetro.

public int indexOf(String subStr);

Devuelve el índice de la primera ocurrencia del substring especificado
dentro de este String.

285
 Las clases String y StringBuffer.

public int indexOf(String subStr, int desdePosición);

Similar al método anterior pero se empieza a buscar a partir del índice
especificado por el entero.

public String intern();

Devuelve un String que es igual a este String pero se garantiza que se
incluye en el pool único de Strings.

public int lastIndexOf(char ch);

Devuelve el índice de la última ocurrencia del carácter especificado.

public int lastIndexOf(char ch, int desdePosición);

Similar al método anterior, pero empezando a buscar en la posición
indicada.

public int lastIndexOf(String subStr);

Devuelve el índice de la última ocurrencia del substring especificado
dentro de este String.

public int lastIndexOf(String subStr, int desdePosición);

Similar al método anterior pero se empieza a buscar a partir del índice
especificado por el entero.

public int length();

Devuelve la longitud del string.

public boolean regionMatches(int desdePosición, String otroStr, int

desdePosiciónOtro, int longitud);
Devuelve true si un substring coincide con otro substring que se pasa
como parámetro y false en caso contrario.

El primer entero (desdePosición) es el índice de este string a partir del

cual se va a comparar.
El segundo entero (desdePosiciónOtro) es el índice del string parámetro a
partir del cual se va a comparar.
El tercer entero (longitud) es el número de caracteres que se van a
comprobar.

286
 Las clases String y StringBuffer.

public boolean regionMatches(boolean ignorarMayúsc, int desdePosición,

String otroStr, int desdePosiciónOtro, int longitud);
Similar al anterior, si se pasa un valor true en ignorarMayúsc, se
ignorarán mayúsculas y minúsculas y si es false no.

public String replace(char charAntiguo, char charNuevo);

Devuelve un String resultado de reemplazar todos los caracteres que
coincidan con el primer parámetro por el segundo.

public boolean startsWith(String prefijo);

Devuelve true si el string tiene como prefijo el String que se pasa
como parámetro y false en caso contrario.

public boolean startsWith(String prefijo, int desdePosición);

Devuelve true si el string tiene como prefijo el String que se pasa
como parámetro y false en caso contrario, pero empezando por la
posición indicada por el entero.

public String substring(int desdePosición);

Devuelve el substring que comienza en la posición indicada por el entero
(inclusive).

public String substring(int desdePosición, int hastaPosición);

Devuelve el substring que comienza en la posición indicada por el primer
entero (inclusive) hasta la posición indicada por el segundo entero
(exclusive).

public char[] toCharArray();

Devuelve un vector de caracteres equivalente a este string.

public String toLowerCase();

Devuelve un String resultado de convertir todos los caracteres a
minúsculas.

public String toLowerCase(Locale local);

Devuelve un String resultado de convertir todos los caracteres a
minúsculas utilizando las reglas de conversión particulares del país
(locale).

287
 Las clases String y StringBuffer.

public String toUpperCase();

Devuelve un String resultado de convertir todos los caracteres a
mayúsculas.

public String toUpperCase(Locale local);

Devuelve un String resultado de convertir todos los caracteres a
mayúsculas utilizando las reglas de conversión particulares del país
(locale).

public String trim();

Elimina los espacios al principio y al final del String.

public static String valueOf(Object objeto);

Devuelve un String resultado de evaluar el método toString() del
objeto.

public static String valueOf(char datos[]);

Devuelve un String equivalente al vector de caracteres.

public static String valueOf(char datos[], int desdePosición, int cantidad);

Devuelve un String equivalente al vector de caracteres, comenzando
por el primer entero y de la longitud especificada por el segundo entero.

public static String valueOf(boolean b);

Devuelve un String equivalente al valor boolean del parámetro.

public static String valueOf(char ch);

Devuelve un String equivalente al carácter.

public static String valueOf(int i);

Devuelve un String equivalente al entero.

public static String valueOf(long l);

Devuelve un String equivalente al entero largo.

public static String valueOf(float f);

Devuelve un String equivalente al real de tipo float.

288
 Las clases String y StringBuffer.

public static String valueOf(double d);

Devuelve un String equivalente al real de tipo double.

C.2 La clase StringBuffer.

Si se quiere utilizar un String que pueda variar de tamaño o contenido, se

deberá crear un objeto de la clase StringBuffer.

C.2.1 Constructores de la clase StringBuffer.

public StringBuffer();
Crea un StringBuffer vacío.

public StringBuffer(int longitud);

Crea un StringBuffer vacío de la longitud especificada por el
parámetro.

public StringBuffer(String str);

Crea un StringBuffer con el valor inicial especificado por el String.

C.2.2 Métodos de la clase StringBuffer.

public synchronized StringBuffer append(Object objeto)

Añade un objeto al final del StringBuffer.

public synchronized StringBuffer append(String str);

Añade un String al final del StringBuffer.

public synchronized StringBuffer append(char str[]);

Añade un vector de caracteres al final del StringBuffer.

289
 Las clases String y StringBuffer.

public synchronized StringBuffer append(char str[],int desdePosición, int

cantidad);
Añade parte de un vector de caracteres al final del StringBuffer.

El primer entero es el índice del primer elemento del vector.

El segundo entero es la longitud del subvector.

public StringBuffer append(boolean b);

Añade un valor boolean al final del StringBuffer.

public synchronized StringBuffer append(char ch);

Añade un carácter al final del StringBuffer.

public StringBuffer append(int i);

Añade un entero al final del StringBuffer.

public StringBuffer append(long l);

Añade un entero largo al final del StringBuffer.

public StringBuffer append(float f);

Añade un real de tipo float al final del StringBuffer.

public StringBuffer append(double d);

Añade un real de tipo double al final del StringBuffer.

public int capacity();

Devuelve la capacidad actual del StringBuffer.

public synchronized char charAt(int posición);

Devuelve el carácter especificado por el índice que se pasa como
parámetro.

public synchronized void ensureCapacity(int capacidadMínima);

Asegura que la capacidad del StringBuffer sea como mínimo la
especificada como parámetro.

290
 Las clases String y StringBuffer.

public synchronized void getChars(int inicioOrigen, int finOrigen, char

destino[],int inicioDestino);
Copia caracteres del StringBuffer en un vector de caracteres.

El primer entero (inicioOrigen) es el índice del primer carácter del

StringBuffer.

El segundo entero (finOrigen) es el índice del último carácter del

stringBuffer.

El tercer entero (inicioDestino) es el índice del primer elemento del

vector de caracteres que se llenará.

public synchronized StringBuffer insert(int posición, Object objeto);

Inserta un objeto en la posición especificada por el entero.

public synchronized StringBuffer insert(int posición, String str);

Inserta un String en la posición especificada por el entero.

public synchronized StringBuffer insert(int posición, char str[]);

Inserta un vector de caracteres en la posición especificada por el entero.

public StringBuffer insert(int posición, boolean b);

Inserta un valor boolean en la posición especificada por el entero.

public synchronized StringBuffer insert(int posición, char ch);

Inserta un carácter en la posición especificada por el entero.

public StringBuffer insert(int posición, int i);

Inserta un entero (int) en la posición especificada por el entero.

public StringBuffer insert(int posición, long l);

Inserta un entero (long) en la posición especificada por el entero.

public StringBuffer insert(int posición, float f);

Inserta un real (float) en la posición especificada por el entero.

291
 Las clases String y StringBuffer.

public StringBuffer insert(int posición, double d);

Inserta un real (double) en la posición especificada por el entero.

public int length();

Devuelve el número de caracteres que tiene el StringBuffer.

public synchronized StringBuffer reverse();

Invierte el StringBuffer.

public synchronized void setCharAt(int posición, char ch);

Cambia el carácter en la posición especificada por el entero por el
carácter especificado como parámetro.

public synchronized void setLength(int nuevaLongitud);

Cambia la longitud del StringBuffer por el entero que se pasa como
parámetro. Si la longitud nueva es menor que la anterior, los caracteres
del final se pierden. Si la nueva longitud es mayor que la anterior, los
nuevos caracteres se inicializan a cero.

292