strlib

String functions for SA-MP Pawn scripting.

Functions

strgetfirstc - Get the first character of a string
strgetc - Get a character from a specific index in a string.
isempty - Find out if a string is empty.
isequal - Compare two strings.
strexplode - Split a string by a given delimiter.
strimplode - Glue together strings into one.
strreplace - Replace occurrences of the search string with the replacement string.
strtrim - Trim whitespace or a specific group of characters from a string.
strcount - Count substrings.
strfromliteral - Read a string from a PAWN string literal.
strtoliteral - Build a PAWN string literal from a given string.
strfrombin - Convert an array to a string.
strtobin - Convert a string to an array.
strcatmid - Concatenate a part of another string.
strurlencode - URL encode a string.
strurldecode - Decode an encoded URL.
strpad - Pad edge(s) of a string with spaces.
strwrap - Wrap a string inside two other strings.
utf8encode - Encode a string into UTF-8 (assuming it's ISO-8859-1).
utf8decode - Decode a UTF-8 encoded string.

Output as return value

All of the functions above require one argument to be the output variable - the functions listed below do not.

Note, however, the max size of returned strings is STRLIB_RETURN_SIZE (default 128). Using large sizes will add lots of heap usage.

sprintf(format[], ...) - Same as the native format, but it returns the output.
ret_utf8encode(input[])
ret_utf8decode(input[])
ret_strpad(string[], length, substr[] = !" ", edge = edge_both, trim_first = true, trim_chars[] = "")
ret_strwrap(left[], string[], right[])
ret_strcatmid(string[], source[], start = 0, end = -1)
ret_strfrombin(input[], inputlength = sizeof(input))
ret_strimplode(glue[], ...)
ret_strreplace(string[], search[], replacement[], ignorecase = false, pos = 0, limit = -1)
ret_strfromliteral(input[], &pos = 0)
ret_strtoliteral(input[])
ret_strtrim(string[], chars[] = "", trim_edges:edges = trim_both)
ret_strurldecode(input[])
ret_strurlencode(input[], pack = false)
ret_strpack(source[])
ret_strunpack(source[])
ret_strcat(string1[], string2[])
ret_strmid(source[], start, end)
ret_strins(string[], substr[], pos)
ret_strdel(string[], start, end)
ret_valstr(value, pack = false)
ret_GetPlayerName(playerid, pack = false)

Examples

`sprintf`

SetGameModeText(sprintf("Hello %s. %d %d %d.", "world", 1, 2, 3));

// GameMode text is now: Hello world. 1 2 3.

`isequal`

new str1[] = "HELLO", str2[] = "hello";

if (isequal(str1, str2)) // false
if (isequal(str1, str2, .ignorecase = true)) // true

`strexplode`

new output[10][10], count;

count = strexplode(output, "I, like, jolly, ranchers", ",");

for (new i = 0; i < count; i++)
	print(output[i]);

/* Output:
     I
     like
     jolly
     ranchers
*/

`strimplode`

new output[128];

strimplode(" ~~ ", output, sizeof(output), "I", "like", "jolly", "ranchers");

// output = "I ~~ like ~~ jolly ~~ ranchers"

`strreplace`

new string[128] = "Hello world";

strreplace(string, "world", "earth"); // string = "Hello earth"
strreplace(string, "HELLO", "Hola"); // string = "Hello earth" (no match for "HELLO")
strreplace(string, "HELLO", "Hola", .ignorecase = true); // string = "Hola earth"

`strtrim`

new string[128] = "   XXbla    blaY    ";

strtrim(string); // string = "XXbla    blaY"
strtrim(string, "XY"); // string = "bla    bla"

string = "/Users/home/bla/bla/";

strtrim(string, "/\\", .edges = trim_right); // string = "/Users/home/bla/bla"

`strcount`

new string[] = "cow COW cow COW sheep cow", count;

count = strcount(strong, "cow"); // count = 3
count = strcount(strong, "cow", .ignorecase = true); // count = 5

`strfrombin`

new data[] = {0x11223344, 0x55667788, 0x99AABBCC, 0xDDEEFF00};
new string[128];

strfrombin(string, data); // string = "112233445566778899AABBCCDDEEFF00"

spacemud / strlib