Str

struct Str {}

Members

Static functions

asciiDigitValue
int asciiDigitValue(char c)

Determines the numeric value of a character as a decimal digit. Differs from g_unichar_digit_value() because it takes a char, so there's no worry about sign extension if characters are signed.

asciiDtostr
string asciiDtostr(string buffer, int bufLen, double d)

Converts a #gdouble to a string, using the '.' as decimal point.

asciiFormatd
string asciiFormatd(string buffer, int bufLen, string format, double d)

Converts a #gdouble to a string, using the '.' as decimal point. To format the number you pass in a printf()-style format string. Allowed conversion specifiers are 'e', 'E', 'f', 'F', 'g' and 'G'.

asciiStrcasecmp
int asciiStrcasecmp(string s1, string s2)

Compare two strings, ignoring the case of ASCII characters.

asciiStrdown
string asciiStrdown(string str, ptrdiff_t len)

Converts all upper case ASCII letters to lower case ASCII letters.

asciiStringToSigned
bool asciiStringToSigned(string str, uint base, long min, long max, long outNum)

A convenience function for converting a string to a signed number.

asciiStringToUnsigned
bool asciiStringToUnsigned(string str, uint base, ulong min, ulong max, ulong outNum)

A convenience function for converting a string to an unsigned number.

asciiStrncasecmp
int asciiStrncasecmp(string s1, string s2, size_t n)

Compare @s1 and @s2, ignoring the case of ASCII characters and any characters after the first @n in each string.

asciiStrtod
double asciiStrtod(string nptr, string endptr)

Converts a string to a #gdouble value.

asciiStrtoll
long asciiStrtoll(string nptr, string endptr, uint base)

Converts a string to a #gint64 value. This function behaves like the standard strtoll() function does in the C locale. It does this without actually changing the current locale, since that would not be thread-safe.

asciiStrtoull
ulong asciiStrtoull(string nptr, string endptr, uint base)

Converts a string to a #guint64 value. This function behaves like the standard strtoull() function does in the C locale. It does this without actually changing the current locale, since that would not be thread-safe.

asciiStrup
string asciiStrup(string str, ptrdiff_t len)

Converts all lower case ASCII letters to upper case ASCII letters.

asciiTolower
char asciiTolower(char c)

Convert a character to ASCII lower case.

asciiToupper
char asciiToupper(char c)

Convert a character to ASCII upper case.

asciiXdigitValue
int asciiXdigitValue(char c)

Determines the numeric value of a character as a hexadecimal digit. Differs from g_unichar_xdigit_value() because it takes a char, so there's no worry about sign extension if characters are signed.

freeString
void freeString(char* str)
freeStringArray
void freeStringArray(char** str)
freeStringArray
void freeStringArray(char*** str)
hasPrefix
bool hasPrefix(string str, string prefix)

Looks whether the string @str begins with @prefix.

hasSuffix
bool hasSuffix(string str, string suffix)

Looks whether the string @str ends with @suffix.

isAscii
bool isAscii(string str)

Determines if a string is pure ASCII. A string is pure ASCII if it contains no bytes with the high bit set.

matchString
bool matchString(string searchTerm, string potentialHit, bool acceptAlternates)

Checks if a search conducted for @search_term should match @potential_hit.

printfStringUpperBound
size_t printfStringUpperBound(string format, void* args)

Calculates the maximum space needed to store the output of the sprintf() function.

stpcpy
string stpcpy(string dest, string src)

Copies a nul-terminated string into the dest buffer, include the trailing nul, and return a pointer to the trailing nul byte. This is useful for concatenating multiple strings together without having to repeatedly scan for the end.

strcanon
string strcanon(string string_, string validChars, char substitutor)

For each character in @string, if the character is not in @valid_chars, replaces the character with @substitutor. Modifies @string in place, and return @string itself, not a copy. The return value is to allow nesting such as |[<!-- language="C" --> g_ascii_strup (g_strcanon (str, "abc", '?')) ]|

strcasecmp
int strcasecmp(string s1, string s2)

A case-insensitive string comparison, corresponding to the standard strcasecmp() function on platforms which support it.

strchomp
string strchomp(string string_)

Removes trailing whitespace from a string.

strchug
string strchug(string string_)

Removes leading whitespace from a string, by moving the rest of the characters forward.

strcmp0
int strcmp0(string str1, string str2)

Compares @str1 and @str2 like strcmp(). Handles %NULL gracefully by sorting it before non-%NULL strings. Comparing two %NULL pointers returns 0.

strcompress
string strcompress(string source)

Replaces all escaped characters with their one byte equivalent.

strdelimit
string strdelimit(string string_, string delimiters, char newDelimiter)

Converts any delimiter characters in @string to @new_delimiter. Any characters in @string which are found in @delimiters are changed to the @new_delimiter character. Modifies @string in place, and returns @string itself, not a copy. The return value is to allow nesting such as |[<!-- language="C" --> g_ascii_strup (g_strdelimit (str, "abc", '?')) ]|

strdown
string strdown(string string_)

Converts a string to lower case.

strdup
string strdup(string str)

Duplicates a string. If @str is %NULL it returns %NULL. The returned string should be freed with g_free() when no longer needed.

strdupVprintf
string strdupVprintf(string format, void* args)

Similar to the standard C vsprintf() function but safer, since it calculates the maximum space required and allocates memory to hold the result. The returned string should be freed with g_free() when no longer needed.

strdupv
string[] strdupv(string[] strArray)

Copies %NULL-terminated array of strings. The copy is a deep copy; the new array should be freed by first freeing each string, then the array itself. g_strfreev() does this for you. If called on a %NULL value, g_strdupv() simply returns %NULL.

strerror
string strerror(int errnum)

Returns a string corresponding to the given error code, e.g. "no such process". Unlike strerror(), this always returns a string in UTF-8 encoding, and the pointer is guaranteed to remain valid for the lifetime of the process.

strescape
string strescape(string source, string exceptions)

Escapes the special characters '\b', '\f', '\n', '\r', '\t', '\v', '\' and '"' in the string @source by inserting a '\' before them. Additionally all characters in the range 0x01-0x1F (everything below SPACE) and in the range 0x7F-0xFF (all non-ASCII chars) are replaced with a '\' followed by their octal representation. Characters supplied in @exceptions are not escaped.

strfreev
void strfreev(string[] strArray)

Frees a %NULL-terminated array of strings, as well as each string it contains.

strjoinv
string strjoinv(string separator, string[] strArray)

Joins a number of strings together to form one long string, with the optional @separator inserted between each of them. The returned string should be freed with g_free().

strlcat
size_t strlcat(string dest, string src, size_t destSize)

Portability wrapper that calls strlcat() on systems which have it, and emulates it otherwise. Appends nul-terminated @src string to @dest, guaranteeing nul-termination for @dest. The total size of @dest won't exceed @dest_size.

strlcpy
size_t strlcpy(string dest, string src, size_t destSize)

Portability wrapper that calls strlcpy() on systems which have it, and emulates strlcpy() otherwise. Copies @src to @dest; @dest is guaranteed to be nul-terminated; @src must be nul-terminated; @dest_size is the buffer size, not the number of bytes to copy.

strncasecmp
int strncasecmp(string s1, string s2, uint n)

A case-insensitive string comparison, corresponding to the standard strncasecmp() function on platforms which support it. It is similar to g_strcasecmp() except it only compares the first @n characters of the strings.

strndup
string strndup(string str, size_t n)

Duplicates the first @n bytes of a string, returning a newly-allocated buffer @n + 1 bytes long which will always be nul-terminated. If @str is less than @n bytes long the buffer is padded with nuls. If @str is %NULL it returns %NULL. The returned value should be freed when no longer needed.

strnfill
string strnfill(size_t length, char fillChar)

Creates a new string @length bytes long filled with @fill_char. The returned string should be freed when no longer needed.

strreverse
string strreverse(string string_)

Reverses all of the bytes in a string. For example, g_strreverse ("abcdef") will result in "fedcba".

strrstr
string strrstr(string haystack, string needle)

Searches the string @haystack for the last occurrence of the string @needle.

strrstrLen
string strrstrLen(string haystack, ptrdiff_t haystackLen, string needle)

Searches the string @haystack for the last occurrence of the string @needle, limiting the length of the search to @haystack_len.

strsignal
string strsignal(int signum)

Returns a string describing the given signal, e.g. "Segmentation fault". You should use this function in preference to strsignal(), because it returns a string in UTF-8 encoding, and since not all platforms support the strsignal() function.

strsplit
string[] strsplit(string string_, string delimiter, int maxTokens)

Splits a string into a maximum of @max_tokens pieces, using the given @delimiter. If @max_tokens is reached, the remainder of @string is appended to the last token.

strsplitSet
string[] strsplitSet(string string_, string delimiters, int maxTokens)

Splits @string into a number of tokens not containing any of the characters in @delimiter. A token is the (possibly empty) longest string that does not contain any of the characters in @delimiters. If @max_tokens is reached, the remainder is appended to the last token.

strstrLen
string strstrLen(string haystack, ptrdiff_t haystackLen, string needle)

Searches the string @haystack for the first occurrence of the string @needle, limiting the length of the search to @haystack_len.

strtod
double strtod(string nptr, string endptr)

Converts a string to a #gdouble value. It calls the standard strtod() function to handle the conversion, but if the string is not completely converted it attempts the conversion again with g_ascii_strtod(), and returns the best match.

strup
string strup(string string_)

Converts a string to upper case.

strvContains
bool strvContains(string strv, string str)

Checks if @strv contains @str. @strv must not be %NULL.

strvEqual
bool strvEqual(string strv1, string strv2)

Checks if @strv1 and @strv2 contain exactly the same elements in exactly the same order. Elements are compared using g_str_equal(). To match independently of order, sort the arrays first (using g_qsort_with_data() or similar).

strvGetType
GType strvGetType()
strvLength
uint strvLength(string[] strArray)

Returns the length of the given %NULL-terminated string array @str_array. @str_array must not be %NULL.

toAscii
string toAscii(string str, string fromLocale)

Transliterate @str to plain ASCII.

toString
string toString(const(char)* s, size_t len)
Undocumented in source. Be warned that the author may not have intended to support it.
toStringArray
string[] toStringArray(const(char*)* args)
toStringArray
string[] toStringArray(const(char*)* args, size_t len)
toStringArray
string[][] toStringArray(char*** args)
toStringz
char* toStringz(string s)
Undocumented in source. Be warned that the author may not have intended to support it.
toStringzArray
char** toStringzArray(string[] args)
toStringzArray
char*** toStringzArray(string[][] args)
tokenizeAndFold
string[] tokenizeAndFold(string string_, string translitLocale, string[] asciiAlternates)

Tokenises @string and performs folding on each token.

vasprintf
int vasprintf(string[] string_, string format, void* args)

An implementation of the GNU vasprintf() function which supports positional parameters, as specified in the Single Unix Specification. This function is similar to g_vsprintf(), except that it allocates a string to hold the output, instead of putting the output in a buffer you allocate in advance.

vfprintf
int vfprintf(FILE* file, string format, void* args)

An implementation of the standard fprintf() function which supports positional parameters, as specified in the Single Unix Specification.

vprintf
int vprintf(string format, void* args)

An implementation of the standard vprintf() function which supports positional parameters, as specified in the Single Unix Specification.

vsnprintf
int vsnprintf(string string_, gulong n, string format, void* args)

A safer form of the standard vsprintf() function. The output is guaranteed to not exceed @n characters (including the terminating nul character), so it is easy to ensure that a buffer overflow cannot occur.

vsprintf
int vsprintf(string string_, string format, void* args)

An implementation of the standard vsprintf() function which supports positional parameters, as specified in the Single Unix Specification.

Meta