AMXX · Counter-Strike 1.6

appzone.inc

Zbiór funkcji ułatwiających pisanie pluginów AMXX — mniej powtarzalnego kodu, gotowe rozwiązania SQL i obsługa polskich odmian wyrazów.

Zaloguj się, aby pobrać 7 udokumentowanych funkcji

Przejdź do sekcji

Dokumentacja funkcji

Jak zacząć korzystać z biblioteki?

Aby używać appzone.inc w pluginach AMXX, wykonaj poniższe kroki:

Pobierz bibliotekę

Plik appzone.inc — wymagane zalogowanie na AppZone.pl.

Zaloguj się

Umieść w katalogu kompilatora

Skopiuj plik do /scripting/include w lokalnym kompilatorze AMXX.

Dołącz bibliotekę w kodzie

Na górze pliku .sma dodaj:

#include <appzone>

Gotowe — możesz korzystać z funkcji biblioteki. Wybierz funkcję z menu po lewej, aby zobaczyć dokumentację.

az_nick

Pobieranie nicku gracza lub nazwy serwera

Opis

Zwraca nick gracza o podanym indeksie. Gdy id wynosi 0, zwraca nazwę serwera.

Składnia

az_nick(id)

id — indeks gracza (1–32) lub 0 dla nazwy serwera.

Przykład

client_print(id, print_chat, "Twoj nick: %s", az_nick(id));
// Wyświetli nick gracza na czacie

az_fmt

Formatowanie stringów (kompatybilne z AMXX 1.8.2+)

Opis

Zwraca sformatowany string. Działa jak fmt() z AMXX 1.10, ale działa też w starszych wersjach kompilatora (1.8.2+).

Składnia

az_fmt(const textformat[], any:...)

textformat[] — format z symbolami %d, %s, %f itd.

any:... — parametry do podstawienia

Przykład

new dwa = 2, cztery = 4, text[] = "To sie zgadza";
new menu = menu_create("Przykladowe menu", "menu_handle");
menu_additem(menu, az_fmt("%d + %d jest rowne %d! %s", dwa, dwa, cztery, text));
menu_display(id, menu);
// Opcja menu: "2 + 2 jest rowne 4! To sie zgadza"

az_explode

Dzielenie stringów na tablicę

Opis

Dzieli ciąg znaków na tablicę według podanego separatora.

Składnia

az_explode(const string[], const character, output[][], const maxs, const maxlen)

string[] — ciąg wejściowy

character — znak separatora

output[][] — tablica wynikowa

maxs — maks. liczba podziałów

maxlen — maks. długość jednej części

Przykład

new text[30], output[6][33];
formatex(text, charsmax(text), "Test 1|Test 2|Test 3");
new ilosc_czesci = az_explode(text, '|', output, charsmax(output), charsmax(output[]));
client_print(id, print_chat, "Ilosc czesci: %d", ilosc_czesci);
for (new i = 0; i < ilosc_czesci; i++) {
    client_print(id, print_chat, "Czesc %d: %s", i, output[i]);
}

az_wordending_int

Polskie odmiany wyrazów (int)

Opis

Zwraca poprawną polską końcówkę wyrazu w zależności od liczby całkowitej.

Składnia

az_wordending_int(ile, czlon[], zero[], jeden[], dwa[])

ile — liczba (np. fragi, punkty)

czlon[] — rdzeń wyrazu, np. „frag”

zero[] — końcówka dla 0, np. „ów” → fragów

jeden[] — końcówka dla 1, np. „a” → fraga

dwa[] — końcówka dla 2–4, np. „i” → fragi

Przykład

new frags = get_user_frags(id);
client_print(id, print_chat, "Zdobyles %d %s", frags, az_wordending_int(frags, "frag", "ow", "a", "i"));
// np. "Zdobyles 5 fragow", "1 fraga", "3 fragi"

az_wordending_float

Polskie odmiany wyrazów (float)

Opis

Zwraca poprawną polską końcówkę wyrazu w zależności od liczby zmiennoprzecinkowej (obsługuje m.in. wartość 0.5).

Składnia

az_wordending_float(Float:ile, czlon[], zero[], pol[], jeden[], dwa[])

Float:ile — wartość zmiennoprzecinkowa

pol[] — końcówka dla 0.5

Przykład

new Float:promile = 16.5;
client_print(id, print_chat, "Masz %.1f %s substancji", promile, az_wordending_float(promile, "promil", "i", "a", "", "e"));

az_sql_connect

Połączenie z bazą MySQL

Opis

Nawiązuje centralne połączenie z bazą danych MySQL dla kolejnych zapytań SQL.

Składnia

az_sql_connect(const host[], const user[], const pass[], const db[])

Przykład

public plugin_init() {
    register_plugin("Test SQL", "1.0", "Author");
    az_sql_connect("sql.example.pl", "user", "haslo", "nazwa_bazy");
}

az_sql_send_query

Asynchroniczne zapytania SQL

Opis

Wysyła zapytanie SQL z opcjonalnym callbackiem obsługującym wynik (SELECT) lub bez zwracania danych (INSERT, UPDATE).

Składnia

az_sql_send_query(const query[], const query_handle[] = "", id = -1)

query[] — treść zapytania SQL

query_handle[] — nazwa funkcji callback (puste dla zapytań bez wyniku)

id — wartość przekazywana do callbacku, np. indeks gracza

Przykład

public wczytaj_dane(id) {
    az_sql_send_query("SELECT * FROM gracze", "handle_wczytaj_dane", id);
}

public handle_wczytaj_dane(failstate, Handle:query_response, error[], errnum, data[], size) {
    if (failstate != TQUERY_SUCCESS) {
        log_amx("Blad SQL: %s", error);
        return PLUGIN_CONTINUE;
    }
    new player = data[0];
    // Obsluga wynikow...
    return PLUGIN_CONTINUE;
}