String :: append - Append a String
The function appends the string cString onto the end of this string and returns a reference to the string.
The coding type of the result depends on the string coding type of the calling string. When encoding types of the strings differ, a copy of the string passed in cString is created and recoded to the encoding type of the calling string before performing the operation..
odaba::String x = "free";
odaba::String y = "dom";
x.append(y);
// x == "freedom"
Return value: String object ( odaba::String & )
Implementation details
odaba::String &
String :: append ( odaba::String &cString )
- cString
- Constant string object
When iPosition exceeds the string length or when the string is empty, the the function returns -1 (lower).