====== A String objektum funkciói ====== A nagybetűs //"String"// objektumot ne keverjük össze a [[hu:arduino:variables#char_array|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() ===== {{anchor: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 [[hu:arduino:string_reference#setcharat|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() ===== {{anchor: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: \\ * 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);
  }

===== concat() ===== {{anchor:concat}} Egy paraméter hozzáfűzése a String-hez. === Szintaktika === myString.concat(//parameter//) \\ 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 ===== c_str() ===== {{anchor: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() ===== {{anchor:endswith}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== equals() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== equalsIgnoreCase() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== getBytes() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== indexOf() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== lastIndexOf() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== length() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== remove() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== replace() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== reserve() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== setCharAt() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== startsWith() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== substring() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== toCharArray() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== toDouble() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== toInt() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== toFloat() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== toLowerCase() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== toUpperCase() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===

===== trim() ===== {{anchor:horgony}} Leírás === Szintaktika === dtostrf (//value//, //width//, //prec//, //out//) \\ //value// (float, double): bemeneti érték \\ === Példa ===