String
Category: Built-In Types
Brief Description
Built-in string class.
Member Functions
Description
This is the built-in string class (and the one used by GDScript). It supports Unicode and provides all necessary means for string handling. Strings are reference counted and use a copy-on-write approach, so passing them around is cheap in resources.
Member Function Description
String String ( bool from )
String String ( int from )
String String ( float from )
String String ( Vector2 from )
String String ( Rect2 from )
String String ( Vector3 from )
String String ( Matrix32 from )
String String ( Plane from )
String String ( Quat from )
String String ( AABB from )
String String ( Matrix3 from )
String String ( Transform from )
String String ( Color from )
String String ( NodePath from )
String String ( RID from )
String String ( InputEvent from )
String String ( Dictionary from )
String String ( Array from )
String String ( RawArray from )
String String ( IntArray from )
String String ( RealArray from )
String String ( StringArray from )
String String ( Vector2Array from )
String String ( Vector3Array from )
String String ( ColorArray from )
String basename ( )
If the string is a path to a file, return the path to the file without the extension.
bool begins_with ( String text )
Return true if the strings begins with the given string.
StringArray bigrams ( )
Return the bigrams (pairs of consecutive letters) of this string.
String c_escape ( )
Return a copy of the string with special characters escaped using the C language standard.
String c_unescape ( )
Return a copy of the string with escaped characters replaced by their meanings according to the C language standard.
String capitalize ( )
Change the case of some letters. Replace underscores with spaces, convert all letters to lowercase then capitalize first and every letter following the space character. For capitalize camelCase mixed_with_underscores it will return Capitalize Camelcase Mixed With Underscores.
int casecmp_to ( String to )
Perform a case-sensitive comparison to another string, return -1 if less, 0 if equal and +1 if greater.
bool empty ( )
Return true if the string is empty.
bool ends_with ( String text )
Return true if the strings ends with the given string.
void erase ( int pos, int chars )
Erase chars characters from the string starting from pos.
String extension ( )
If the string is a path to a file, return the extension.
int find ( String what, int from=0 )
Find the first occurrence of a substring, return the starting position of the substring or -1 if not found. Optionally, the initial search index can be passed.
int find_last ( String what )
Find the last occurrence of a substring, return the starting position of the substring or -1 if not found. Optionally, the initial search index can be passed.
int findn ( String what, int from=0 )
Find the first occurrence of a substring but search as case-insensitive, return the starting position of the substring or -1 if not found. Optionally, the initial search index can be passed.
String format ( var values, String placeholder={_} )
String get_base_dir ( )
If the string is a path to a file, return the base directory.
String get_file ( )
If the string is a path to a file, return the file and ignore the base directory.
int hash ( )
Hash the string and return a 32 bits integer.
int hex_to_int ( )
Convert a string containing an hexadecimal number into an int.
String insert ( int pos, String what )
Insert a substring at a given position.
bool is_abs_path ( )
If the string is a path to a file or directory, return true if the path is absolute.
bool is_rel_path ( )
If the string is a path to a file or directory, return true if the path is relative.
bool is_subsequence_of ( String text )
Check whether this string is a subsequence of the given string.
bool is_subsequence_ofi ( String text )
Check whether this string is a subsequence of the given string, without considering case.
bool is_valid_float ( )
Check whether the string contains a valid float.
bool is_valid_html_color ( )
Check whether the string contains a valid color in HTML notation.
bool is_valid_identifier ( )
Check whether the string is a valid identifier. As is common in programming languages, a valid identifier may contain only letters, digits and underscores (_) and the first character may not be a digit.
bool is_valid_integer ( )
Check whether the string contains a valid integer.
bool is_valid_ip_address ( )
Check whether the string contains a valid IP address.
String json_escape ( )
Return a copy of the string with special characters escaped using the JSON standard.
String left ( int pos )
Return an amount of characters from the left of the string.
int length ( )
Return the length of the string in characters.
bool match ( String expr )
Do a simple expression match, where ‘*’ matches zero or more arbitrary characters and ‘?’ matches any single character except ‘.’.
bool matchn ( String expr )
Do a simple case insensitive expression match, using ? and * wildcards (see match).
RawArray md5_buffer ( )
Return the MD5 hash of the string as an array of bytes.
String md5_text ( )
Return the MD5 hash of the string as a string.
int nocasecmp_to ( String to )
Perform a case-insensitive comparison to another string, return -1 if less, 0 if equal and +1 if greater.
int ord_at ( int at )
Return the character code at position at.
String pad_decimals ( int digits )
Format a number to have an exact number of digits after the decimal point.
String pad_zeros ( int digits )
Format a number to have an exact number of digits before the decimal point.
String percent_decode ( )
Decode a percent-encoded string. See percent_encode.
String percent_encode ( )
Percent-encode a string. This is meant to encode parameters in a URL when sending a HTTP GET request and bodies of form-urlencoded POST request.
String plus_file ( String file )
If the string is a path, this concatenates file at the end of the string as a subpath. E.g. "this/is".plus_file("path") == "this/is/path".
String replace ( String what, String forwhat )
Replace occurrences of a substring for different ones inside the string.
String replacen ( String what, String forwhat )
Replace occurrences of a substring for different ones inside the string, but search case-insensitive.
int rfind ( String what, int from=-1 )
Perform a search for a substring, but start from the end of the string instead of the beginning.
int rfindn ( String what, int from=-1 )
Perform a search for a substring, but start from the end of the string instead of the beginning. Also search case-insensitive.
String right ( int pos )
Return the right side of the string from a given position.
RawArray sha256_buffer ( )
String sha256_text ( )
Return the SHA-256 hash of the string as a string.
float similarity ( String text )
Return the similarity index of the text compared to this string. 1 means totally similar and 0 means totally dissimilar.
StringArray split ( String divisor, bool allow_empty=True )
Split the string by a divisor string, return an array of the substrings. Example “One,Two,Three” will return “One”,”Two”,”Three” if split by ”,”.
RealArray split_floats ( String divisor, bool allow_empty=True )
Split the string in floats by using a divisor string, return an array of the substrings. Example “1,2.5,3” will return 1,2.5,3 if split by ”,”.
String strip_edges ( bool left=True, bool right=True )
Return a copy of the string stripped of any non-printable character at the beginning and the end. The optional arguments are used to toggle stripping on the left and right edges respectively.
String substr ( int from, int len )
Return part of the string from the position from, with length len.
RawArray to_ascii ( )
Convert the String (which is a character array) to RawArray (which is an array of bytes). The conversion is speeded up in comparison to to_utf8() with the assumption that all the characters the String contains are only ASCII characters.
float to_float ( )
Convert a string, containing a decimal number, into a float.
int to_int ( )
Convert a string, containing an integer number, into an int.
String to_lower ( )
Return the string converted to lowercase.
String to_upper ( )
Return the string converted to uppercase.
RawArray to_utf8 ( )
Convert the String (which is an array of characters) to RawArray (which is an array of bytes). The conversion is a bit slower than to_ascii(), but supports all UTF-8 characters. Therefore, you should prefer this function over to_ascii().
String xml_escape ( )
Return a copy of the string with special characters escaped using the XML standard.
String xml_unescape ( )
Return a copy of the string with escaped characters replaced by their meanings according to the XML standard.
© 2014–2020 Juan Linietsky, Ariel Manzur, Godot Engine contributors
Licensed under the MIT License.
https://docs.godotengine.org/en/2.1/classes/class_string.html