diff options
Diffstat (limited to 'docs/libcurl/curl_multi_remove_handle.3')
-rw-r--r-- | docs/libcurl/curl_multi_remove_handle.3 | 18 |
1 files changed, 16 insertions, 2 deletions
diff --git a/docs/libcurl/curl_multi_remove_handle.3 b/docs/libcurl/curl_multi_remove_handle.3 index 099b929e6..a61827794 100644 --- a/docs/libcurl/curl_multi_remove_handle.3 +++ b/docs/libcurl/curl_multi_remove_handle.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. +.\" * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -19,7 +19,7 @@ .\" * KIND, either express or implied. .\" * .\" ************************************************************************** -.TH curl_multi_remove_handle 3 "November 05, 2020" "libcurl 7.78.0" "libcurl Manual" +.TH curl_multi_remove_handle 3 "November 04, 2021" "libcurl 7.80.0" "libcurl Manual" .SH NAME curl_multi_remove_handle - remove an easy handle from a multi session @@ -41,6 +41,20 @@ other easy handles and transfers will remain unaffected. It is fine to remove a handle at any time during a transfer, just not from within any libcurl callback function. +.SH EXAMPLE +.nf +/* when an easy handle has completed, remove it */ +msg = curl_multi_info_read(multi_handle, &queued); +if(msg) { + if(msg->msg == CURLMSG_DONE) { + /* a transfer ended */ + fprintf(stderr, "Transfer completed\\n"); + curl_multi_remove_handle(multi_handle, msg->easy_handle); + } +} +.fi +.SH AVAILABILITY +Added in 7.9.6 .SH RETURN VALUE CURLMcode type, general libcurl multi interface error code. .SH "SEE ALSO" |