# curl_share_init

Definition: | include builtins\libcurl.e atom curlshare = curl_share_init()
Description: | Create a shared object. This function returns a CURLSH (atom) handle to be used as input to all the other share-functions, sometimes referred to as a share handle in some places in the documentation. This init call MUST have a corresponding call to curl_share_cleanup when all operations using the share are complete. This share handle is what you pass to curl using the CURLOPT_SHARE option with curl_easy_setopt, to make that specific curl handle use the data in this share. Returns a share handle. A fatal error occurs if something goes wrong. Legacy code may check for NULL, but that is no longer necessary and the equivalent processing should instead be performed via exception handling, if at all - in general Phix takes the perhaps rather stern view that a brutal crash both gives clues and forces a fix, whereas quietly ignoring errors (certainly as opposed to handling them properly) can only lead to frustration, irritation, and annoyance.
pwa/p2js: | Not supported.
See Also: | curl_share_setopt, curl_share_cleanup, curl_easy_setopt