Opis

Łączy dwa stringi.

Składnia

add(dest[], len, const src[], max)

Zwracana wartość

Zwraca długość napisu wyjściowego.

Typ

Notatki

• dest - tablica znaków do której będziemy dodawać (po wykonaniu operacji napis docelowy) tak więc musi ona mieć taką wielkość, aby po dodaniu drugiego napisu (być może i trzeciego oraz czwartego itd.) ilość znaków napisu docelowego nie była większa niż wielkość tej tablicy.
• len - maksymalna długość docelowego wyrazu.
• src - to napis, który chcemy dodać do drugiego (do dest).
• max - maksymalna ilość znaków z tablicy src, którą pozwalamy dodać do dest.

Przykład

new napis[32]="To jest napis testowy"; // 1
new napisik[]="-a-to drugi"; // 2
new ile=add(napis, sizeof(napis), napisik, sizeof(napisik)) // 3

Uwagi

Ad. 1. Tablica przewiduje 32 znaki, czyli dokładnie tyle ile potrzebujemy aby zmieścić te dwa napisy, jeśli nie będziemy pewni ile miejsc może nam to zając (wartości do tablic zostaną przypisane w czasie działania pluginu (np. get_user_name - nick może być różnej długości)) najlepiej jest przewidzieć maksymalną możliwą długość.

Ad. 2. Może to być też tablica o określonej ilości znaków, jeśli będziemy chcieli sczytać do niej np. nick.

Ad. 3. Funkcja zwraca długość docelowego napisu (po dodaniu), użycie funkcji sizeof pozwala nam sprawdzić jaką ma wielkość dana tablica i takiej długości używamy - dość optymalne rozwiązanie i chyba jedyne w przypadku kiedy pisząc plugin nie deklarujemy wielkości tablicy (new napisik[]). Jeżeli zaś mamy zadeklarowaną wielkość tablicy dodawanej, możemy jako max podać nie wielkość tablicy, ale faktyczną długość wyrazu w niej zawartego (strlen(wyraz)).