| Index

| Reference for Wiring 1.0 (ALPHA) 0017+. If you have a previous version, use the reference included with your software. If you see any errors or have any comments, let us know.

Name |  | ### String
Examples |  |
    String a = "CCCP";
    char data[] = {'C', 'C', 'C', 'P'};
    String b = String(data);

    Serial.println(a);  // Prints 'CCCP' to the Serial serial port
    Serial.println(b);  // Prints 'CCCP' to the Serial serial port
    char t[] = "A character string";
    String a = String("hello");
    String b = String(" there");
    String c = String(t);

    a += b; // a holds now 'hello there' equivalent to a.append(b)
    Serial.println(c);  // Prints 'A character string' to the Serial serial port
Description |  | A string is a sequence of characters. The class String includes methods for examining individual characters, comparing strings, searching strings, extracting parts of strings, and for converting an entire string uppercase and lowercase. Strings are always defined inside double quotes ("Abc") and characters are always defined inside single quotes('A'). Note that the Wiring String class has differences with the processing or Java String class. The main difference is that some methods modify the actual string instead of returning a modified copy of it.
Methods |  |
charAt() |  | Returns the character at the specified index
append() |  | Appends the String representation of the argument specified
capacity() |  | Returns the internal capacity of the String
contains() |  | Returns true if there is an occurrence of the input string
getBytes() |  | Returns an array of bytes containing the characters of the String as bytes
setCharAt() |  | Changes the character specified at the specified index
endsWith() |  | Returns true if the current string ends with the input string
equals() |  | Compares a string to a specified object
indexOf() |  | Returns the index value of the first occurrence of a character within the input string
length() |  | Returns the number of characters in the input string
replace() |  | Replaces all the occurrences of a character in a string with the specified character
startsWith() |  | Returns true if the current string starts with the input string
substring() |  | Returns a new string that is part of the input string
toCharArray() |  | Returns the content of the specified String as an array of chars
toLowerCase() |  | Converts all the characters to lower case
toUpperCase() |  | Converts all the characters to upper case
Constructors |  |
    String(data)
Parameters |  |
data |  | byte[], char[]: array of bytes to be decoded into characters or array of characters to be combined into a string, int: empty string with the specified initial capacity, String: string to be copied into the created string
Usage |  | Web & Application
Related |  | char