A String objektum funkciói

A nagybetűs String objektumot ne keverjük össze a karakterlánc (char array) kisbetűs string változóval!

A szövegek kezelésére kialakított objektum viszonylag egyszerűvé teszi a szöveges jellegű feladatok elvégzését, de egyben zabálja a memóriát, ami az abban meglehetősen szűkölködő Arduino-kon gyorsan problémát jelenthet.

Néhány példa az objektummal végezhető műveletekre:

String stringOne = "Hello String";                        // using a constant String
String stringOne =  String('a');                          // converting a constant char into a String
String stringTwo =  String("This is a string");           // converting a constant string into a String object
String stringOne =  String(stringTwo + " with more");     // concatenating two strings
String stringOne =  String(13);                           // using a constant integer
String stringOne =  String(analogRead(0), DEC);           // using an int and a base
String stringOne =  String(45, HEX);                      // using an int and a base (hexadecimal)
String stringOne =  String(255, BIN);                     // using an int and a base (binary)
String stringOne =  String(millis(), DEC);                // using a long and a base
String stringOne =  String(5.698, 3);                     // using a float and the decimal places

charAt()

Hozzáférés a karakterlánc egy bizonyos karakteréhez.

Szintaktika

myString.charAt( n )

n (unsigned int): a karakter pozíciója

A függvény visszatérési értéke az adott karakter.

Az adott pozícióra egy karakter beírását a setCharAt() funkció végzi.

Példa

 String reportString = "Franklin, Benjamin";
 int spacePosition = reportString.indexOf(' ');
 if (reportString.charAt(spacePosition + 1) == 'B') {
    Serial.println("You might have found the Benjamins.")
 }

compareTo()

Összehasonlít két karakterláncot, megvizsgálva, hogy azonosak vagy eltérőek-e. A karakterláncok hasonlításánál a karakterek ASCII értékeit használja. Ez azt jelenti például, hogy bár az a a b előtt áll, de az A utánuk.

Szintaktika

myString.compareTo(myString2)

myString (String): az egyik hasonlítandó String
myString2 (String): a másik hasonlítandó String

Visszatérési értékek:

Példa

  stringOne = "Cucumber";
  stringTwo = "Cucuracha";
  if (stringOne.compareTo(stringTwo) < 0) {
    Serial.println(stringOne + " comes before " + stringTwo);
  } else {
    Serial.println(stringOne + " comes after " + stringTwo);
  }

concat()

Egy paraméter hozzáfűzése a String-hez.

Szintaktika

myString.concat(parameter)
<color blue>myString (String):
String, amihez hozzá kell fűzni
parameter A paraméter, amit a String-hez kell fűzni, ez lehet: String, string, char, byte, int, unsigned int, long, unsigned long, float, double

Visszatérési értéke:

c_str()

A karakterlánc tartalmát átkonvertálja C-stílusú, null-terminál String-re. Figyelembe kell venni, hogy ez a művelet közvetlen hozzáférést biztosít a belső karakterlánc-pufferhez, ezáltal óvatosan kell használni. A funkcióhoz hasonló hatást lehet elérni a toCharArray()-jel is.

Szintaktika

myString.c_str()

myString (String): A bemeneti String

A függvény visszatérési értéke a konvertált String.

endsWith()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

equals()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

equalsIgnoreCase()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

getBytes()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

indexOf()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

lastIndexOf()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

length()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

remove()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

replace()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

reserve()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

setCharAt()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

startsWith()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

substring()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

toCharArray()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

toDouble()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

toInt()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

toFloat()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

toLowerCase()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

toUpperCase()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa

 

trim()

Leírás

Szintaktika

dtostrf (value, width, prec, out)

value (float, double): bemeneti érték

Példa