diff options
| author | Daniel Stenberg <daniel@haxx.se> | 2004-07-02 14:00:49 +0000 | 
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2004-07-02 14:00:49 +0000 | 
| commit | 5a70e42428209416848f7fcda5a856dd6c4966a0 (patch) | |
| tree | c4cd0e073d4d1b9ccb0ceac495438d8cbbc41915 /docs/libcurl | |
| parent | e4caa98901cea926fb564db4ea0cf14dd6728825 (diff) | |
I prefer CURLOPT_WRITEDATA before CURLOPT_FILE
Diffstat (limited to 'docs/libcurl')
| -rw-r--r-- | docs/libcurl/libcurl-tutorial.3 | 15 | 
1 files changed, 9 insertions, 6 deletions
diff --git a/docs/libcurl/libcurl-tutorial.3 b/docs/libcurl/libcurl-tutorial.3 index f1716b692..1c2215de5 100644 --- a/docs/libcurl/libcurl-tutorial.3 +++ b/docs/libcurl/libcurl-tutorial.3 @@ -188,24 +188,27 @@ similar to this:  You can control what data your function get in the forth argument by setting  another property: -    curl_easy_setopt(easyhandle, CURLOPT_FILE, &internal_struct); +    curl_easy_setopt(easyhandle, CURLOPT_WRITEDATA, &internal_struct);  Using that property, you can easily pass local data between your application  and the function that gets invoked by libcurl. libcurl itself won't touch the -data you pass with CURLOPT_FILE. +data you pass with CURLOPT_WRITEDATA.  libcurl offers its own default internal callback that'll take care of the data  if you don't set the callback with CURLOPT_WRITEFUNCTION. It will then simply  output the received data to stdout. You can have the default callback write  the data to a different file handle by passing a 'FILE *' to a file opened for -writing with the CURLOPT_FILE option. +writing with the CURLOPT_WRITEDATA option.  Now, we need to take a step back and have a deep breath. Here's one of those  rare platform-dependent nitpicks. Did you spot it? On some platforms[2],  libcurl won't be able to operate on files opened by the program. Thus, if you -use the default callback and pass in a an open file with CURLOPT_FILE, it will -crash. You should therefore avoid this to make your program run fine virtually -everywhere. +use the default callback and pass in a an open file with CURLOPT_WRITEDATA, it +will crash. You should therefore avoid this to make your program run fine +virtually everywhere. + +(CURLOPT_WRITEDATA was formerly known as CURLOPT_FILE. Both names still work +and do the same thing).  There are of course many more options you can set, and we'll get back to a few  of them later. Let's instead continue to the actual transfer:  | 
