samp.directory
← Skrypty i biblioteki

oscar-broman/strlib

String functions for SA-MP Pawn scripting.

Biblioteka★ 52zaktualizowano sty 2025Brak licencjiPawnsampctl
Otwórz na GitHubie

To repozytorium nie ma pliku licencji. Jest publiczne do odczytu, ale samo to nie daje pozwolenia na ponowne użycie.

Zainstaluj za pomocą sampctl

sampctl package install oscar-broman/strlib

Uruchom to w folderze swojego projektu. sampctl pobiera pakiet i to, od czego zależy.

Wypróbuj w kompilatorze Pawn →

Dodaje jej pliki include, razem z bibliotekami, od których zależy, do kompilatora Pawn w twojej przeglądarce, gotowe do dołączenia w skrypcie.

Zależy od 1 pakietu

README.md

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"

Ta strona jest zbudowana z tego, co GitHub publikuje o repozytorium. samp.directory nie hostuje kodu. Zgłoś problem z tym wpisem

oscar-broman/strlib: Biblioteka SA-MP | samp.directory