CURLOPT_MIME_OPTIONS(3) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

CURLOPT_MIME_OPTIONS(3)

CURLOPT_MIME_OPTIONS(3)    curl_easy_setopt options    CURLOPT_MIME_OPTIONS(3)



NAME
       CURLOPT_MIME_OPTIONS - set MIME option flags

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MIME_OPTIONS, long options);

DESCRIPTION
       Pass  a long that holds a bitmask of CURLMIMEOPT_* defines. Each bit is
       a Boolean flag used while encoding a MIME tree or multipart form data.

       Available bits are:

       CURLMIMEOPT_FORMESCAPE
              Tells libcurl to escape multipart  form  field  and  file  names
              using  the  backslash-escaping  algorithm  rather  than percent-
              encoding (HTTP only).

              Backslash-escaping consists in preceding backslashes and  double
              quotes  with  a backslash. Percent encoding maps all occurrences
              of double quote, carriage return and line feed to %22,  %0D  and
              %0A respectively.

              Before version 7.81.0, percent-encoding was never applied.

              HTTP browsers used to do backslash-escaping in the past but have
              over time transitioned  to  use  percent-encoding.  This  option
              allows one to address server-side applications that have not yet
              have been converted.

              As an example, consider field or  file  name  strange\name"kind.
              When  the  containing  multipart  form is sent, this is normally
              transmitted as strange\name%22kind. When this option is set,  it
              is sent as strange\\name\"kind.

DEFAULT
       0, meaning disabled.

PROTOCOLS
       HTTP, IMAP, SMTP

EXAMPLE
       CURL *curl = curl_easy_init();
       curl_mime *form = NULL;

       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
         curl_easy_setopt(curl, CURLOPT_MIME_OPTIONS, CURLMIMEOPT_FORMESCAPE);

         form = curl_mime_init(curl);
         if(form) {
           curl_mimepart *part = curl_mime_addpart(form);

           if(part) {
             curl_mime_filedata(part, "strange\\file\\name");
             curl_mime_name(part, "strange\"field\"name");
             curl_easy_setopt(curl, CURLOPT_MIMEPOST, form);

             /* Perform the request */
             curl_easy_perform(curl);
           }
         }

         curl_easy_cleanup(curl);
         curl_mime_free(mime);
       }

AVAILABILITY
       Option added in 7.81.0.

RETURN VALUE
       Returns CURLE_OK

SEE ALSO
       CURLOPT_MIMEPOST(3), CURLOPT_HTTPPOST(3)



libcurl 7.86.0                September 02, 2022       CURLOPT_MIME_OPTIONS(3)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3