reserve()

Description

The String reserve() function allows you to allocate a buffer in memory for manipulating strings.

Syntax


string.reserve(size)

Parameters

string : a variable of type String
size : unsigned int declaring the number of bytes in memory to save for string manipulation

Returns

none

Example

String myString;

void setup() {
  // initialize serial and wait for port to open:
  Serial.begin(9600);
  while (!Serial) {
    ; // wait for serial port to connect. Needed for Leonardo only
  }

  myString.reserve(26);
  myString = "i=";
  myString += "1234";
  myString += ", is that ok?";

  // print the String:
  Serial.println(myString);
}

void loop() {
 // nothing to do here
}

See also

String


Language Reference Home

The text of the 86Duino reference is a modification of the Arduino reference, and is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.