Easy handle

libcurl을 사용하여 배워야 할 기본은 다음과 같다:

먼저 전송에 대한 당신의 핸들인 "easy handle"을 생성하는 것이다:

CURL *easy_handle = curl_easy_init();

그 다음 수신되는 전송을 제어하기 위한 핸들에서 다양한 옵션을 설정하는 것이다. 다음과 같이 URL을 설정하는 예제이다:

/* 작동할 URL 설정 */
res = curl_easy_setopt(easy_handle, CURLOPT_URL, "http://example.com/");

easy handle을 생성하고 옵션을 설정하는 것은 실제로 전송이 이루어지지는 않으며, 그리고 전송이 실제로 발생할 때

나중에 사용하기를 원하는 것을 libcurl이 저장하는 것보다 더 많은 일이 발생하도록 만들지는 않는다. 많은 문법 검사와 입력 검증은 지연될 수 있으므로, curl_easy_setopt가 불평하지 않기 때문에, 입력이 정확하고 유효하다는 의미는 아니며, 나중에 오류가 반환될 수 있다.

별도의 장에서 easy 옵션(https://ec.haxx.se/libcurl-options.html)에 대해서 자세히 읽어 보길 바란다.

모든 옵션은 "sticky"이다. 다시 그것들을 변경하거나 핸들에서 curl_easy_reset()을 호출할 때까지 핸들에서 설정된 상태로 남아있는다.

easy handle로 옵션 설정을 완료하면, 실제 전송을 시작할 수 있다.

실제 "전송 단계 수행"은 당신의 어플리케이션에서 원하는 동작의 종류와 어떻게 libcurl이 당신의 아키텍처에 가장 잘 통화되어있는지에 따라 다른 수단과 함수 호출을 사용하여 완료 할 수 있다. 이 장의 후반부에서 좀더 상세히 설명한다.

전송이 완료된 이후에 성공여부를 파악할 수 있으며, libcurl은 easy handle로 부터 전송동안에 수집된 정확한 통계와 다양한 정보를 추출할 수 있다. 전송 후 정보를 참조하라.

전송이 진행되는 동안, libcurl은 데이터를 전달하고, 데이터를 읽거나 다양한 작업을 수행하기 위해서 콜백으로 알려진 특정 함수를 호출한다.

재사용하십시오!

Easy handle은 재사용될 수 있도록 설계되었다. easy handle을 가지고 단일 전송을 완료할 때, 다음 전송을 위해 이것을 즉시 다시 사용할 수 있다. 이것으로 인해 많은 이득이 있다.