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

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.")
 }

Ö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:

negatív érték: myString > myString2 (az első eltérés pozíciója)
pozitív érték: myString < myString2 (az első eltérés pozíciója)
0: a két String azonos

Példa

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

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:

true: végrehajtva
false: hiba, a String változatlan marad

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.

Leírás