Framework (A-Z)

Referencia para la versión de Wiring 1.0 Build 0100+. Si tiene una versión previa, use la referencia incluida con su software. Si encuentra errores o tiene comentarios, no dude en contactarnos.

Nombre

String

Ejemplos
// declara s1 con un string inicial
String s1 = String("string numero uno"); 
byte bytes[20];  // arreglo de bytes
char array[20];  // arreglo de caracteres

void setup() {
  Serial.begin(9600); 
  // Enciende el LED de la tarjeta Wiring
  pinMode(WLED, OUTPUT);  
  digitalWrite(WLED, HIGH);
  
  // s2 contiene "10000"
  String s2 = String(10000);  
  Serial.println("s2 contiene: " + s2);
  
  // s3 contiene "567000"
  String s3 = String(567000, DEC); 
  Serial.println("s3 contiene: " + s3);
  
  // s4 contiene "string numero cuatro"
  String s4 = "string numero cuatro";  
  Serial.println("s4 contiene: " + s4);
  
  // use el operador + para adicionar un string
  s4 += " mas otra parte";  
  // use el operador + cuando imprime en el serial
  Serial.println("ahora s4 contiene: " + s4);  
  
  // tomar el caracter en la posicion 5
  char c = s4.charAt(5);  
  Serial.print("c contiene: ");
  Serial.println(c);  // imprime 'g'
  
  // s5 contiene "string numero uno"
  String s5 = String("string numero uno");  
  
  int cmp = s1.compareTo(s5);  // compara s1 y s5
  if (cmp == 0) {
    Serial.println("s1 y s5 son iguales");  // imprime igual
  } else {
    Serial.println("s1 y s5 son direfentes");
  }
  
  // controla si s5 termina en "uno"
  if (s5.endsWith("uno"))  
    // imprime "s5 termina con "uno""
    Serial.println("s5 termina con "uno"");  
  
  if (s1.equals(s5))  // controla si s1 es igual a s5
    Serial.println("s1 y s5 son iguales");  // imprime igual
  
  // s6 contiene "string numero uno"
  String s6 = String("string numero uno");  
  // controla si s5 y s6 son iguales ignorando la diferencia entre mayusculas y minusculas
  if (s5.equalsIgnoreCase(s6))  
    // imprime igual
    Serial.println("s6 y s5 son iguales ignorando mayusculas y minusculas");  
  
  Serial.print("indice del caracter R en s6 es:");
  Serial.println(s6.indexOf('R'), DEC);  // imprime -1

  Serial.print("index of char R on s6 from index 13 is: ");
  // imprime -1, no encontrado
  Serial.println(s6.indexOf('R', 13), DEC);  
  
  String s7 = s6.substring(7, 14);
  Serial.println("s7 es: "+s7);  // imprime "numero"
  
  Serial.print("indice del string "numero" en s6 es: ");  
  Serial.println(s6.indexOf(s7), DEC);  // imprime 7

  Serial.print("ultimo indice del caracter 'n' en s6 es:");  
  Serial.println(s6.lastIndexOf('n'), DEC);  // imprime 15
  
  Serial.print("la longitud de s6 es: ");  
  Serial.println(s6.length(), DEC);  // imprime 17

  // asigna el caracter en el indice 15 como 'N'
  s6.setCharAt(15, 'N');  
  // omprime "string numero uNo"
  Serial.println("s6 es: "+s6);  
  
  // controla si s6 empieza con "string"
  if (s6.startsWith("string"))  
    // s6 empieza con el string "string"
    Serial.println("s6 empieza con "string""); 
    
  // imprime "string numero uno"
  s6.toLowerCase();
  Serial.println("s6 en minusculas es: "+s6);  
  
  // imprime "STRING NUMERO UNO"
  s6.toUpperCase();
  Serial.println("s6 en mayusculas es: "+s6);  
  
  s6.concat(" mas espacio al final   ");  // concatena un string
  // imprime "STRING NUMERO UNO mas espacio al final   "
  Serial.println("s6 es: "+s6);  
 
  // imprime "STRING NUMERO UNO mas espacio al final" 
  s6.trim();
  Serial.println("trim de s6 es: "+s6); 

  // imprime "STRING NUMERO UNO mas espaci5 al final"
  s6.replace('o', '5');
  Serial.println("s6 es: "+s6);  
  
  // toma el arreglo bytes y lo convierte en un arreglo de bytes
  s6.getBytes(bytes, 20);  
  Serial.print("arreglo bytes es: ");
  for (int i=0; i<20; i++) {
    // imprime "S T R I N G   N U M E R O   U N O   m"
    Serial.write(bytes[i]);
    Serial.print(" ");
  }
  Serial.println();
  Serial.print("arreglo array es: ");
  s6.toCharArray(array, 20);
  Serial.println(array);  // imprime "STRING NUMERO UNO m"
}

void loop() {
  
}

Descripción Un string es una cadena de caracteres. La clase String incluye métodos para examinar caracteres individuales, camparar strings, buscar strings, extraer partes de un string, y para convertir un string entero de mayúsculas a minúsculas. Los Strings son siempre definidos dentro de comillas dobles ("Abc") y los caracteres son siempre definidos dentro de comillas simples ('A').

Note que la clase de Wiring String tiene diferencias con la clase String de processing o Java. La principal diferencia es que algunos métodos modifican el string actual en vez de retornar una copia modificada de el.
Campos
Métodos
charAt() Retorna el caracter en un índice especificado
compareTo() Compara dos strings lexicográficamente
concat() Concatena el argumento String especificado
endsWith() Retorna true si el string actual termina con el string de entrada
equals() Compara un string con un string especificado
equalsIgnoreCase() Compara un string con un string especificado, ignorando mayúsculas y minúsculas
indexOf() Retorna el valor del índice de la primera aparición de un caracter o un string en un string de entrada
lastIndexOf() Retorna el valor del índice de la última aparición de un caracter o un string en un string de entrada
length() Retorna el número de caracteres en un string
setCharAt() Cambia un caracter especificado en el índice especificado
startsWith() Retorna true si el string actual empieza con el string de entrada
substring() Retorna un nuevo string que es parte del string de entrada
toLowerCase() Convierte todos los caracteres a minúsculas
toUpperCase() Convierte todos los caracteres a mayúsculas
toInt() Retorna la representación numérica de un string
trim() Retorna una copia de un string, destacando y rastreando espacios en blanco omitidos
getBytes() Retorna un arreglo de bytes conteniendo los caracteres de un String como bytes
toCharArray() Retorna el contenido de un String especificado como un arreglo de caracteres
replace() Remplaza todas las apariciones de un caracter en un string con el caracter espeficado
Constructor
String(data)
String(data, base)
Parámetros
data byte[], char[]: Arreglo de bytes para ser decodificado en caracteres o arreglo de caracteres para ser convinados en un string, int, long: conversión de string de un valor especificado, String: string para ser copiado en un string creado
base DEC, HEX, OCT o BIN (exclusivo para datos int o long)
Uso Application
Updated on July 07, 2011 11:13:44pm PDT

Creative Commons License