curl_easy_escape

[funkcja] Koduje przekazany łańcuch znaków do postaci stosowanej w adresach URL.

Składnia

#include <curl/curl.h>

char * curl_easy_escape( CURL * curl, char * url, int length );

Argumenty

Argument	Opis
CURL * curl	Uchwyt sesji CURL. Wartość tego argumentu może wynosić `NULL`.
char * url	Łańcuch znaków, który ma zostać zakodowany.
int length	Długość łańcucha znaków przekazanego poprzez argument `url`, który ma zostać zakodowany.

Zwracana wartość

Zwraca łańcuch znaków zakończony znakiem terminalnym w przypadku sukcesu. Funkcja zwraca wartość NULL w przypadku niepowodzenia.

Zwrócony łańcuch znaków musi zostać zwolniony przy pomocy funkcji _{» curl ♦}curl_free po zakończeniu z nim pracy.

Opis szczegółowy

Funkcja koduje przekazany łańcuch znaków do postaci stosowanej w adresach URL. Zwracany łańcuch znaków jest nowo zaalokowaną pamięcią, którą należy zwolnić przy pomocy funkcji _{» curl ♦}curl_free.

Funkcja konwertuje wszystkie znaki wejściowe do postaci zgodnej z formatem stosowanym w adresach URL. Znaki a-z, A-Z, 0-9, '-', '.', '_' oraz '~' nie ulegają modyfikacjom. Każdy inny znak jest konwertowany do postaci %NN, gdzie NN jest dwucyfrową liczbą szesnastkową.

Dodatkowe informacje

W przypadku gdy wartość argumentu length wynosi zero to funkcja curl_easy_escape użyje funkcji _{» standard C ♦}strlen do określenia długości tekstu.

Zagadnienia powiązane

curl_easy_unescape	Dekoduje przekazany łańcuch znaków zapisany w formacie adresu URL do postaci tekstowej. (funkcja)
curl_free	Zwalnia pamięć, która została zaalokowana w wyniku wywołania innej funkcji, należącej do biblioteki `CURL`. (funkcja)

Linki zewnętrzne

http://curl.haxx.se/libcurl/c/curl_easy_escape.html

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.