samp.directory
← Skripte und Bibliotheken

oscar-broman/strlib

String functions for SA-MP Pawn scripting.

Bibliothek★ 52aktualisiert Jan. 2025Keine LizenzPawnsampctl
Auf GitHub öffnen

Dieses Repository hat keine Lizenzdatei. Es ist öffentlich lesbar, aber das allein gibt noch keine Erlaubnis, es weiterzuverwenden.

Mit sampctl installieren

sampctl package install oscar-broman/strlib

Führe das in deinem Projektordner aus. sampctl lädt das Paket und alles herunter, wovon es abhängt.

Im Pawn-Compiler ausprobieren →

Fügt seine Include-Dateien samt der Bibliotheken, von denen es abhängt, dem Pawn-Compiler in deinem Browser hinzu, bereit zum Einbinden in ein Skript.

Hängt von 1 Paket ab

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"

Diese Seite wird aus dem erstellt, was GitHub über das Repository veröffentlicht. samp.directory hostet den Code nicht. Ein Problem mit diesem Eintrag melden

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