Funkcje pomocnicze
[Pozostałe funkcje]

Functions
char *	gg_vsaprintf (const char *format, va_list ap)
char *	gg_saprintf (const char *format,...)
int	gg_connect (void *addr, int port, int async)
void	gg_chomp (char *line)
char *	gg_urlencode (const char *str)
char *	gg_base64_encode (const char *buf)
char *	gg_base64_decode (const char *buf)
uint32_t	gg_fix32 (uint32_t x)
uint16_t	gg_fix16 (uint16_t x)

---

Function Documentation

char* gg_vsaprintf	(	const char *	format,
		va_list	ap
	)

For internal use only.

Odpowiednik funkcji vsprintf alokujący miejsce na wynik.

Funkcja korzysta z funkcji vsnprintf, sprawdzając czy dostępna funkcja systemowa jest zgodna ze standardem C99 czy wcześniejszymi.

Parameters:

	format	Format wiadomości (zgodny z printf)
	ap	Lista argumentów (zgodna z printf)

Returns:

Zaalokowany bufor lub NULL, jeśli zabrakło pamięci.

char* gg_saprintf	(	const char *	format,
			...
	)

For internal use only.

Odpowiednik funkcji sprintf alokujący miejsce na wynik.

Funkcja korzysta z funkcji vsnprintf, sprawdzając czy dostępna funkcja systemowa jest zgodna ze standardem C99 czy wcześniejszymi.

Parameters:

format

Format wiadomości (zgodny z printf)

Returns:

Zaalokowany bufor lub NULL, jeśli zabrakło pamięci.

int gg_connect	(	void *	addr,
		int	port,
		int	async
	)

For internal use only.

Nawiązuje połączenie TCP.

Parameters:

	addr	Wskaźnik na strukturę in_addr z adresem serwera
	port	Port serwera
	async	Flaga asynchronicznego połączenia

Returns:

Deskryptor gniazda lub -1 w przypadku błędu

void gg_chomp

(

char *

line

)

For internal use only.

Usuwa znaki końca linii.

Funkcja działa bezpośrednio na buforze.

Parameters:

line

Bufor z tekstem

char* gg_urlencode

(

const char *

str

)

For internal use only.

Koduje ciąg znaków do postacji adresu HTTP.

Zamienia znaki niedrukowalne, spoza ASCII i mające specjalne znaczenie dla protokołu HTTP na encje postaci XX, gdzie XX jest szesnastkową wartością znaku.

Parameters:

str

Ciąg znaków do zakodowania

Returns:

Zaalokowany bufor lub NULL w przypadku błędu.

char* gg_base64_encode

(

const char *

buf

)

For internal use only.

Koduje ciąg znaków do base64.

Wynik funkcji należy zwolnić za pomocą free.

Parameters:

buf

Bufor z danami do zakodowania

Returns:

Zaalokowany bufor z zakodowanymi danymi

char* gg_base64_decode

(

const char *

buf

)

For internal use only.

Dekoduje ciąg znaków zapisany w base64.

Wynik funkcji należy zwolnić za pomocą free.

Parameters:

buf

Bufor źródłowy z danymi do zdekodowania

Returns:

Zaalokowany bufor ze zdekodowanymi danymi

uint32_t gg_fix32

(

uint32_t

x

)

For internal use only.

Zamienia kolejność bajtów w 32-bitowym słowie.

Ze względu na little-endianowość protokołu Gadu-Gadu, na maszynach big-endianowych odwraca kolejność bajtów w słowie.

Parameters:

x

Liczba do zamiany

Returns:

Liczba z odpowiednią kolejnością bajtów

uint16_t gg_fix16

(

uint16_t

x

)

For internal use only.

Zamienia kolejność bajtów w 16-bitowym słowie.

Ze względu na little-endianowość protokołu Gadu-Gadu, na maszynach big-endianowych zamienia kolejność bajtów w słowie.

Parameters:

x

Liczba do zamiany

Returns:

Liczba z odpowiednią kolejnością bajtów