Strings are used to store text. They can be used to display text on an LCD or in the Arduino IDE Serial Monitor window. Strings are also useful for storing the user input. For example, the characters that a user types on a keypad connected to the Arduino.
There are two types of strings in Arduino programming −
Arrays of characters, which are the same as the strings used in C programming.
The Arduino String, which lets us use a string object in a sketch.
In this chapter, we will learn Strings, objects and the use of strings in Arduino sketches. By the end of the chapter, you will learn which type of string to use in a sketch.
String Character Arrays
The first type of string that we will learn is the string that is a series of characters of the type char. In the previous chapter, we learned what an array is; a consecutive series of the same type of variable stored in memory. A string is an array of char variables.
A string is a special array that has one extra element at the end of the string, which always has the value of 0 (zero). This is known as a «null terminated string».
String Character Array Example
This example will show how to make a string and print it to the serial monitor window.
The following example shows what a string is made up of; a character array with printable characters and 0 as the last element of the array to show that this is where the string ends. The string can be printed out to the Arduino IDE Serial Monitor window by using Serial.println() and passing the name of the string.
This same example can be written in a more convenient way as shown below −
In this sketch, the compiler calculates the size of the string array and also automatically null terminates the string with a zero. An array that is six elements long and consists of five characters followed by a zero is created exactly the same way as in the previous sketch.
Manipulating String Arrays
We can alter a string array within a sketch as shown in the following sketch.
Example
Result
The sketch works in the following way.
Creating and Printing the String
In the sketch given above, a new string is created and then printed for display in the Serial Monitor window.
Shortening the String
The string is shortened by replacing the 14th character in the string with a null terminating zero (2). This is element number 13 in the string array counting from 0.
When the string is printed, all the characters are printed up to the new null terminating zero. The other characters do not disappear; they still exist in the memory and the string array is still the same size. The only difference is that any function that works with strings will only see the string up to the first null terminator.
Changing a Word in the String
Finally, the sketch replaces the word «cake» with «tea» (3). It first has to replace the null terminator at like[13] with a space so that the string is restored to the originally created format.
New characters overwrite «cak» of the word «cake» with the word «tea». This is done by overwriting individual characters. The ‘e’ of «cake» is replaced with a new null terminating character. The result is that the string is actually terminated with two null characters, the original one at the end of the string and the new one that replaces the ‘e’ in «cake». This makes no difference when the new string is printed because the function that prints the string stops printing the string characters when it encounters the first null terminator.
Functions to Manipulate String Arrays
The previous sketch manipulated the string in a manual way by accessing individual characters in the string. To make it easier to manipulate string arrays, you can write your own functions to do so, or use some of the string functions from the C language library.
Given below is the list Functions to Manipulate String Arrays
S.No.
Functions & Description
1
The String class, part of the core as of version 0019, allows you to use and manipulate strings of text in more complex ways than character arrays do. You can concatenate Strings, append to them, search for and replace substrings, and more. It takes more memory than a simple character array, but it is also more useful.
For reference, character arrays are referred to as strings with a small ‘s’, and instances of the String class are referred to as Strings with a capital S. Note that constant strings, specified in «double quotes» are treated as char arrays, not instances of the String class
Access a particular character of the String.
Compares two Strings, testing whether one comes before or after the other, or whether they are equal. The strings are compared character by character, using the ASCII values of the characters. That means, for example, ‘a’ comes before ‘b’ but after ‘A’. Numbers come before letters.
Appends the parameter to a String.
Converts the contents of a string as a C-style, null-terminated string. Note that this gives direct access to the internal String buffer and should be used with care. In particular, you should never modify the string through the pointer returned. When you modify the String object, or when it is destroyed, any pointer previously returned by c_str() becomes invalid and should not be used any longer.
Tests whether or not a String ends with the characters of another String.
Compares two strings for equality. The comparison is case-sensitive, meaning the String «hello» is not equal to the String «HELLO».
Compares two strings for equality. The comparison is not case-sensitive, meaning the String(«hello») is equal to the String(«HELLO»).
Copies the string’s characters to the supplied buffer.
Locates a character or String within another String. By default, it searches from the beginning of the String, but can also start from a given index, allowing to locate all instances of the character or String.
Locates a character or String within another String. By default, it searches from the end of the String, but can also work backwards from a given index, allowing to locate all instances of the character or String.
Returns the length of the String, in characters. (Note that this does not include a trailing null character.)
Modify in place, a string removing chars from the provided index to the end of the string or from the provided index to index plus count.
The String replace() function allows you to replace all instances of a given character with another character. You can also use replace to replace substrings of a string with a different substring.
The String reserve() function allows you to allocate a buffer in memory for manipulating strings.
Sets a character of the String. Has no effect on indices outside the existing length of the String.
Tests whether or not a String starts with the characters of another String.
Copies the string’s characters to the supplied buffer.
Get a substring of a String. The starting index is inclusive (the corresponding character is included in the substring), but the optional ending index is exclusive (the corresponding character is not included in the substring). If the ending index is omitted, the substring continues to the end of the String.
Converts a valid String to an integer. The input string should start with an integer number. If the string contains non-integer numbers, the function will stop performing the conversion.
Converts a valid String to a float. The input string should start with a digit. If the string contains non-digit characters, the function will stop performing the conversion. For example, the strings «123.45», «123», and «123fish» are converted to 123.45, 123.00, and 123.00 respectively. Note that «123.456» is approximated with 123.46. Note too that floats have only 6-7 decimal digits of precision and that longer strings might be truncated.
Get a lower-case version of a String. As of 1.0, toLowerCase() modifies the string in place rather than returning a new.
Get an upper-case version of a String. As of 1.0, toUpperCase() modifies the string in place rather than returning a new one.
Get a version of the String with any leading and trailing whitespace removed. As of 1.0, trim() modifies the string in place rather than returning a new one.
The next sketch uses some C string functions.
Example
Result
The sketch works in the following way.
Print the String
The newly created string is printed to the Serial Monitor window as done in previous sketches.
Get the Length of the String
The strlen() function is used to get the length of the string. The length of the string is for the printable characters only and does not include the null terminator.
The string contains 17 characters, so we see 17 printed in the Serial Monitor window.
Get the Length of the Array
The operator sizeof() is used to get the length of the array that contains the string. The length includes the null terminator, so the length is one more than the length of the string.
sizeof() looks like a function, but technically is an operator. It is not a part of the C string library, but was used in the sketch to show the difference between the size of the array and the size of the string (or string length).
Copy a String
The strcpy() function is used to copy the str[] string to the out_num[] array. The strcpy() function copies the second string passed to it into the first string. A copy of the string now exists in the out_num[] array, but only takes up 18 elements of the array, so we still have 22 free char elements in the array. These free elements are found after the string in memory.
The string was copied to the array so that we would have some extra space in the array to use in the next part of the sketch, which is adding a string to the end of a string.
Append a String to a String (Concatenate)
The sketch joins one string to another, which is known as concatenation. This is done using the strcat() function. The strcat() function puts the second string passed to it onto the end of the first string passed to it.
After concatenation, the length of the string is printed to show the new string length. The length of the array is then printed to show that we have a 25-character long string in a 40 element long array.
Remember that the 25-character long string actually takes up 26 characters of the array because of the null terminating zero.
Array Bounds
When working with strings and arrays, it is very important to work within the bounds of strings or arrays. In the example sketch, an array was created, which was 40 characters long, in order to allocate the memory that could be used to manipulate strings.
If the array was made too small and we tried to copy a string that is bigger than the array to it, the string would be copied over the end of the array. The memory beyond the end of the array could contain other important data used in the sketch, which would then be overwritten by our string. If the memory beyond the end of the string is overrun, it could crash the sketch or cause unexpected behavior.
Arduino Strings
Created on: 11 March 2015
Part 18 of the Arduino Programming Course
Strings are used to store text. They can be used to display text on an LCD or in the Arduino IDE Serial Monitor window.
Strings are also useful for storing user input – for example the characters that a user types on a keypad connected to the Arduino.
There are two types of strings in Arduino programming: 1) Arrays of characters which are the same as the strings used in C programming 2) The Arduino String which lets us use a string object in a sketch
Strings, objects and how to use strings in Arduino sketches are fully explained in this part of the Arduino programming course. The question of which type of sting to use in a sketch is answered at the end of this article.
String Character Arrays
The first type of string that we will look at is the string that is a series of characters of type char. The previous part of this course showed what an array is – a consecutive series of the same type of variable stored in memory. A string is an array of char variables.
A string is a special array that has one extra element at the end of the string which always has the value of 0 (zero). This is known as a «null terminated string».
String Character Array Example Sketch
This sketch will show how to make a string and print it to the serial monitor window.
The sketch shows what a string is made up of – it consists of a character array with printable characters and a 0 in the last element of the array to show that this is where the string ends.
The string can be printed out to the Arduino IDE Serial Monitor window by using Serial.println() and passing it the name of the string.
This same sketch can be written more conveniently this way:
In this sketch, the compiler calculates the size of the string array and also automatically null terminates the string with a zero. An array that is six elements long and consists of five characters followed by a zero is created exactly the same way as in the previous sketch.
Strings and Characters
Characters are written between single quotes like this:
Strings are written between double quotes like this:
Manipulating String Arrays
We can alter a string array within a sketch as the following sketch shows.
Creating and Printing the String
In this sketch, a new string is created and then printed for display in the Serial Monitor window (1).
Shortening the String
The string is shortened by replacing the 14th character in the string with a null terminating zero (2). This is element number 13 in the string array counting from 0.
When the string is printed out, all the characters are printed up to the new null terminating zero. The other characters do not disappear – they still exist in memory and the string array is still the same size. The only difference is that any function that works with strings will only see the string up to the first null terminator.
Changing a Word in the String
Finally the sketch replaces the word «cake» with «tea» (3). It first has to replace the null terminator at like[13] with a space so that the string is restored to how it was originally created.
New characters overwrite «cak» of the work «cake» with the word «tea». This is done by overwriting individual characters. The ‘e’ of «cake» is replaced with a new null terminating character. The result is that the string is actually terminated with two null characters – the original one at the end of the string and the new one that replaces the ‘e’ in «cake». This makes no difference when the new string is printed out because the function that prints the string stops printing string characters when it encounters the first null terminator.
Functions to Manipulate String Arrays
The previous sketch manipulated the string in a very manual way by accessing individual characters in the string. To make it easier to manipulate string arrays, you could write your own functions to do so, or use some of the string functions from the C language library.
The next sketch uses some C string functions.
The sketch works in the following way.
(1) Print the String
The newly created string is printed to the Serial Monitor window as done in previous sketches.
(2) Get the Length of the String
The strlen() function is used to get the length of the string. The length of the string is for the printable characters only and does not include the null terminator.
The string contains 17 characters, so we see 17 printed in the Serial Monitor window.
(3) Get the Length of the Array
The operator sizeof() is used to get the length of the array that contains the string. The length includes the null terminator, so the length is one more than the length of the string.
sizeof() looks like a function, but technically is an operator. It is not part of the C string library, but was used in the sketch to show the difference between the size of the array and the size of the string (or string length).
(4) Copy a String
The strcpy() function is used to copy the str[] string to the out_num[] array. The strcpy() function copies the second string passed to it into the first string. A copy of the string now exists in the out_num[] array, but only takes up 18 elements of the array, so we still have 22 free char elements in the array. These free elements are found after the string in memory.
The string was copied to the array so that we would have some extra space in the array to use in the next part of the sketch which is adding a string to the end of a string.
(5) Append a String to a String (Concatenate)
The sketch joins one string to another, which is known as concatenation. This is done using the strcat() function. The strcat() function puts the second string passed to it onto the end of the first string passed to it.
After concatenation, the length of the string is printed to show the new string length. The length of the array is then printed to show that we have a 25 character long string in a 40 element long array.
Remember that the 25 character long string actually takes up 26 characters of the array because of the null terminating zero.
Array Bounds
When working with strings and arrays, it is very important to work within the bounds of the string or array. In the example sketch an array was created that was 40 characters long in order to allocate memory that could be used to manipulate strings.
If the array was made too small and we tried to copy a string that is bigger than the array to it, the string would be copied over the end of the array. The memory beyond the end of the array could contain other important data used in the sketch which would then be overwritten by our string. If the memory beyond the end of the string is overrun, it could crash the sketch or cause unexpected behaviour.
Books that may interest you:
The Arduino String Object
The second type of string used in Arduino programming is the String object.
What is an Object?
An object is a construct that contains both data and functions. A String object can be created just like a variable and assigned a value or string. The String object contains functions (which are called «methods» in object oriented programming (OOP)) which operate on the string data contained in the String object.
The following sketch and explanation will make it clearer what an object is and how the String object is used.
This video shows the sketch running.
—>
A string object is created and assigned a value (or string) at the top of the sketch.
This creates a String object with the name my_str and gives it a value of «This is my string.».
This can be compared to creating a variable and assigning a value to it such as an integer:
(1) Printing the String
The string can be printed to the Serial Monitor window just like a character array string.
(2) Convert the String to Upper-case
The string object my_str that was created has a number of functions or methods that can operate on it. These methods are invoked by using the objects name followed by the dot operator (.) and then the name of the function to use.
The toUpperCase() function operates on the string contained in the my_str object which is of type String and converts the string data (or text) that the object contains to upper-case characters.
A list of the functions that the String class contains can be found in the Arduino String reference.
Technically String is called a class and is used to create String objects.
(3) Overwrite a String
The assignment operator is used to assign a new string to the my_str object that replaces the old string.
The assignment operator can not be used on character array strings, but works on String objects only.
(4) Replacing a Word in the String
The replace() function is used to replace the first string passed to it by the second string passed to it. replace() is another function that is built into the String class and so is available to use on the String object my_str.
(5) Getting the Length of the String
Getting the length of the string is easily done by using length(). In the example sketch, the result returned by length() is passed directly to Serial.println() without using an intermediate variable.
You can help the Starting Electronics website by making a donation:
Any donation is much appreciated and used to pay the running costs of this website. Click the button below to make a donation.
When to use a String Object or String Character Array
A String object is much easier to use than a string character array. The object has built-in functions that can perform a number of operations on strings which are fully documented in the reference section on the Arduino website.
The main disadvantage of using the String object is that it uses a lot of memory and can quickly use up the Arduino’s RAM memory which may cause the Arduino to hang, crash or produce unexpected behaviour. This is especially true for the smaller Arduinos such as the Arduino Uno.
If a sketch on an Arduino is small and limits the use of objects, then there should be no problems.
Character array strings are more difficult to use and you may need to write your own functions to operate on these types of strings. The advantage is that you have control of the size of the string arrays that you make, so you can keep the arrays small to save memory.
You need to make sure that you do not write over the end of the array bounds with string arrays. The String object does not have this problem and will take care of the string bounds for you, provided that there is enough memory for it to operate on. The String object can try to write to memory that does not exist when it runs out of memory, but will never write over the end of the string that it is operating on.
Where Strings are Used
This part of the Arduino programming course has looked at what strings are, how they look in memory and some operations that can be done on strings.
Actual practical uses of strings will be covered in the next part of this course when we look at how to get user input from the Serial Monitor window and save the input in a string.
