Contents > Library Reference > Strings

Strings

Functions for basic string manipulation.

Functions

| int strlen(string str) | Calculates the number of characters in a string.
| string substr(string str, int index, int len) | Creates a substring from the source string str. The first character of the string is at zero-based index, with the string being a maximum of len characters. If len is negative, it means -len chars from the end of the string.
| string strleft(string str, int len) | Creates a substring from the left len characters of the source string str. If len is negative, it means to include all except the last -len chars.
| string strright(string str, int len) | Creates a substring from the right len characters of the source string str. If len is negative, it means to include all except the first -len chars.
| string strupper(string str) | Creates a string from the source string str in all uppercase characters.
| string strlower(string str) | Creates a string from the source string str in all lowercase characters.
| int strstr(string str, string sub, int first) | Searches the source string str to find sub, beginning at index first.
| string strinsert(string str, int pos, string inster) | Inserts the string insert into the source string str at index pos, returning the result.
| string strreplace(string str, string search, string replace) | Replaces all instances of search in the source string str with replace, returning the result.
| string hex(int value) | Creates a hexadecimal string representation of value in the form "0xh".
| string format(float value, int prec) | Returns the string representation of value with prec decimal places.
| string lformat(float value, int prec) | Returns the string representation of value with prec decimal places. The decimal point used is based on the OS locale settings.
| float lparse(string value) | Converts the string representation value into a float. Unlike relying on the compiler to do the conversion, this function takes into account the decimal point character as defined by the current OS locale settings.
| string strctos(char* array) | Builds a string from an array of characters, array.
| int strstoc(string str, char* array) | Copy each character of a str into the character array array.

Contents > Library Reference > Strings > strlen

strlen

`int strlen(string str)`

Parameters:

| str | a string

Return value: the length of the string

Calculates the number of characters in a string.

Contents > Library Reference > Strings > substr

substr

`string substr(string str, int index, int len)`

Parameters:

| str | a string
| index | the first character
| len | the number of characters

Return value: the requested substring

Creates a substring from the source string str. The first character of the string is at zero-based index, with the string being a maximum of len characters. If len is negative, it means -len chars from the end of the string.

Contents > Library Reference > Strings > strleft

strleft

`string strleft(string str, int len)`

Parameters:

| str | a string
| len | the number of characters

Return value: the requested substring

Creates a substring from the left len characters of the source string str. If len is negative, it means to include all except the last -len chars.

Contents > Library Reference > Strings > strright

strright

`string strright(string str, int len)`

Parameters:

| str | a string
| len | the number of characters

Return value: the requested substring

Creates a substring from the right len characters of the source string str. If len is negative, it means to include all except the first -len chars.

Contents > Library Reference > Strings > strupper

strupper

`string strupper(string str)`

Parameters:

| str | a string

Return value: the uppercase string

Creates a string from the source string str in all uppercase characters.

Contents > Library Reference > Strings > strlower

strlower

`string strlower(string str)`

Parameters:

| str | a string

Return value: the lowercase string

Creates a string from the source string str in all lowercase characters.

Contents > Library Reference > Strings > strstr

strstr

`int strstr(string str, string sub, int first)`

Parameters:

| str | the source string
| sub | the substring to match
| first | the first index to search

Return value: the location of the match, or -1 if none found

Searches the source string str to find sub, beginning at index first.

Contents > Library Reference > Strings > strinsert

strinsert

`string strinsert(string str, int pos, string inster)`

Parameters:

| str | the source string
| pos | the index at which to insert
| inster | the string to insert

Return value: the resulting string

Inserts the string insert into the source string str at index pos, returning the result.

Contents > Library Reference > Strings > strreplace

strreplace

`string strreplace(string str, string search, string replace)`

Parameters:

| str | the source string
| search | the string to search for
| replace | the string to replace with

Return value: the resulting string

Replaces all instances of search in the source string str with replace, returning the result.

Contents > Library Reference > Strings > hex

hex

`string hex(int value)`

Parameters:

| value | an integer

Return value: a hexadecimal string representation

Creates a hexadecimal string representation of value in the form "0xh".

Contents > Library Reference > Strings > format

format

`string format(float value, int prec)`

Parameters:

| value | float value
| prec | precision - digits beyond the decimal place

Return value: string representation

Returns the string representation of value with prec decimal places.

Contents > Library Reference > Strings > lformat

lformat

`string lformat(float value, int prec)`

Parameters:

| value | float value
| prec | precision - digits beyond the decimal place

Return value: string representation

Returns the string representation of value with prec decimal places. The decimal point used is based on the OS locale settings.

Contents > Library Reference > Strings > lparse

lparse

`float lparse(string value)`

Parameters:

| value | string representation

Return value: float value

Converts the string representation value into a float. Unlike relying on the compiler to do the conversion, this function takes into account the decimal point character as defined by the current OS locale settings.

Contents > Library Reference > Strings > strctos

strctos

`string strctos(char* array)`

Parameters:

| array | source array

Return value: string version of array

Builds a string from an array of characters, array.

Note: The final character in the array must be a null character (0).

Contents > Library Reference > Strings > strstoc

strstoc

`int strstoc(string str, char* array)`

Parameters:

| str | source string
| array | destination array

Return value: number of characters copied (include the terminating 0)

Copy each character of a str into the character array array.

Note: The array must be allocated before calling this function. This must either be a local or global array, or an array allocated with new or malloct.