Annotation of embedaddon/curl/docs/examples/post-callback.c, revision 1.1

1.1     ! misho       1: /***************************************************************************
        !             2:  *                                  _   _ ____  _
        !             3:  *  Project                     ___| | | |  _ \| |
        !             4:  *                             / __| | | | |_) | |
        !             5:  *                            | (__| |_| |  _ <| |___
        !             6:  *                             \___|\___/|_| \_\_____|
        !             7:  *
        !             8:  * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al.
        !             9:  *
        !            10:  * This software is licensed as described in the file COPYING, which
        !            11:  * you should have received as part of this distribution. The terms
        !            12:  * are also available at https://curl.haxx.se/docs/copyright.html.
        !            13:  *
        !            14:  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
        !            15:  * copies of the Software, and permit persons to whom the Software is
        !            16:  * furnished to do so, under the terms of the COPYING file.
        !            17:  *
        !            18:  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
        !            19:  * KIND, either express or implied.
        !            20:  *
        !            21:  ***************************************************************************/
        !            22: /* <DESC>
        !            23:  * Issue an HTTP POST and provide the data through the read callback.
        !            24:  * </DESC>
        !            25:  */
        !            26: #include <stdio.h>
        !            27: #include <string.h>
        !            28: #include <curl/curl.h>
        !            29: 
        !            30: /* silly test data to POST */
        !            31: static const char data[]="Lorem ipsum dolor sit amet, consectetur adipiscing "
        !            32:   "elit. Sed vel urna neque. Ut quis leo metus. Quisque eleifend, ex at "
        !            33:   "laoreet rhoncus, odio ipsum semper metus, at tempus ante urna in mauris. "
        !            34:   "Suspendisse ornare tempor venenatis. Ut dui neque, pellentesque a varius "
        !            35:   "eget, mattis vitae ligula. Fusce ut pharetra est. Ut ullamcorper mi ac "
        !            36:   "sollicitudin semper. Praesent sit amet tellus varius, posuere nulla non, "
        !            37:   "rhoncus ipsum.";
        !            38: 
        !            39: struct WriteThis {
        !            40:   const char *readptr;
        !            41:   size_t sizeleft;
        !            42: };
        !            43: 
        !            44: static size_t read_callback(void *dest, size_t size, size_t nmemb, void *userp)
        !            45: {
        !            46:   struct WriteThis *wt = (struct WriteThis *)userp;
        !            47:   size_t buffer_size = size*nmemb;
        !            48: 
        !            49:   if(wt->sizeleft) {
        !            50:     /* copy as much as possible from the source to the destination */
        !            51:     size_t copy_this_much = wt->sizeleft;
        !            52:     if(copy_this_much > buffer_size)
        !            53:       copy_this_much = buffer_size;
        !            54:     memcpy(dest, wt->readptr, copy_this_much);
        !            55: 
        !            56:     wt->readptr += copy_this_much;
        !            57:     wt->sizeleft -= copy_this_much;
        !            58:     return copy_this_much; /* we copied this many bytes */
        !            59:   }
        !            60: 
        !            61:   return 0; /* no more data left to deliver */
        !            62: }
        !            63: 
        !            64: int main(void)
        !            65: {
        !            66:   CURL *curl;
        !            67:   CURLcode res;
        !            68: 
        !            69:   struct WriteThis wt;
        !            70: 
        !            71:   wt.readptr = data;
        !            72:   wt.sizeleft = strlen(data);
        !            73: 
        !            74:   /* In windows, this will init the winsock stuff */
        !            75:   res = curl_global_init(CURL_GLOBAL_DEFAULT);
        !            76:   /* Check for errors */
        !            77:   if(res != CURLE_OK) {
        !            78:     fprintf(stderr, "curl_global_init() failed: %s\n",
        !            79:             curl_easy_strerror(res));
        !            80:     return 1;
        !            81:   }
        !            82: 
        !            83:   /* get a curl handle */
        !            84:   curl = curl_easy_init();
        !            85:   if(curl) {
        !            86:     /* First set the URL that is about to receive our POST. */
        !            87:     curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/index.cgi");
        !            88: 
        !            89:     /* Now specify we want to POST data */
        !            90:     curl_easy_setopt(curl, CURLOPT_POST, 1L);
        !            91: 
        !            92:     /* we want to use our own read function */
        !            93:     curl_easy_setopt(curl, CURLOPT_READFUNCTION, read_callback);
        !            94: 
        !            95:     /* pointer to pass to our read function */
        !            96:     curl_easy_setopt(curl, CURLOPT_READDATA, &wt);
        !            97: 
        !            98:     /* get verbose debug output please */
        !            99:     curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
        !           100: 
        !           101:     /*
        !           102:       If you use POST to a HTTP 1.1 server, you can send data without knowing
        !           103:       the size before starting the POST if you use chunked encoding. You
        !           104:       enable this by adding a header like "Transfer-Encoding: chunked" with
        !           105:       CURLOPT_HTTPHEADER. With HTTP 1.0 or without chunked transfer, you must
        !           106:       specify the size in the request.
        !           107:     */
        !           108: #ifdef USE_CHUNKED
        !           109:     {
        !           110:       struct curl_slist *chunk = NULL;
        !           111: 
        !           112:       chunk = curl_slist_append(chunk, "Transfer-Encoding: chunked");
        !           113:       res = curl_easy_setopt(curl, CURLOPT_HTTPHEADER, chunk);
        !           114:       /* use curl_slist_free_all() after the *perform() call to free this
        !           115:          list again */
        !           116:     }
        !           117: #else
        !           118:     /* Set the expected POST size. If you want to POST large amounts of data,
        !           119:        consider CURLOPT_POSTFIELDSIZE_LARGE */
        !           120:     curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, (long)wt.sizeleft);
        !           121: #endif
        !           122: 
        !           123: #ifdef DISABLE_EXPECT
        !           124:     /*
        !           125:       Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue"
        !           126:       header.  You can disable this header with CURLOPT_HTTPHEADER as usual.
        !           127:       NOTE: if you want chunked transfer too, you need to combine these two
        !           128:       since you can only set one list of headers with CURLOPT_HTTPHEADER. */
        !           129: 
        !           130:     /* A less good option would be to enforce HTTP 1.0, but that might also
        !           131:        have other implications. */
        !           132:     {
        !           133:       struct curl_slist *chunk = NULL;
        !           134: 
        !           135:       chunk = curl_slist_append(chunk, "Expect:");
        !           136:       res = curl_easy_setopt(curl, CURLOPT_HTTPHEADER, chunk);
        !           137:       /* use curl_slist_free_all() after the *perform() call to free this
        !           138:          list again */
        !           139:     }
        !           140: #endif
        !           141: 
        !           142:     /* Perform the request, res will get the return code */
        !           143:     res = curl_easy_perform(curl);
        !           144:     /* Check for errors */
        !           145:     if(res != CURLE_OK)
        !           146:       fprintf(stderr, "curl_easy_perform() failed: %s\n",
        !           147:               curl_easy_strerror(res));
        !           148: 
        !           149:     /* always cleanup */
        !           150:     curl_easy_cleanup(curl);
        !           151:   }
        !           152:   curl_global_cleanup();
        !           153:   return 0;
        !           154: }

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>