curl_easy_unescape

Składnia

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ć zdekodowany.
int length	Długość łańcucha znaków przekazanego poprzez argument url, który ma zostać zdekodowany.
int * outlength	Długość zwróconego tekstu w przypadku sukcesu. Znaczenie argumentu zostanie zignorowane w przypadku gdy jego wartość wyniesie NULL.

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 dekoduje przekazany łańcuch znaków zapisany w formacie adresu URL do postaci tekstowej. 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 zakodowane w formacie stosowanym w adresach URL do postaci tekstowej. Niniejsza funkcja jest funkcją odwrotną do _{» curl ♦} curl_easy_escape.

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.

Jeżeli wartość argumentu outlength jest różna od NULL to funkcja zapisze do niego długość zwracanego łańcucha znaków. Takie podejście umożliwia poprawne odczytanie zdekodowanego łańcucha znaków, który w łańcuchu dekodowanym zawierałby znaki %00.

Zagadnienia powiązane

curl_easy_escape	Koduje przekazany łańcuch znaków do postaci stosowanej w adresach URL. (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_unescape.html