2010-02-14 22:40:18 +03:00
|
|
|
_ _ ____ _
|
|
|
|
___| | | | _ \| |
|
|
|
|
/ __| | | | |_) | |
|
|
|
|
| (__| |_| | _ <| |___
|
2004-04-07 11:30:40 +04:00
|
|
|
\___|\___/|_| \_\_____|
|
|
|
|
|
|
|
|
Source Code Functions Apps Might Use
|
|
|
|
====================================
|
|
|
|
|
|
|
|
The libcurl source code offers a few functions by source only. They are not
|
|
|
|
part of the official libcurl API, but the source files might be useful for
|
|
|
|
others so apps can optionally compile/build with these sources to gain
|
|
|
|
additional functions.
|
|
|
|
|
2004-04-30 12:51:19 +04:00
|
|
|
We provide them through a single header file for easy access for apps:
|
|
|
|
"curlx.h"
|
2004-04-07 11:30:40 +04:00
|
|
|
|
|
|
|
curlx_strtoofft()
|
|
|
|
|
|
|
|
A macro that converts a string containing a number to a curl_off_t number.
|
|
|
|
This might use the curlx_strtoll() function which is provided as source
|
2013-01-03 06:53:06 +04:00
|
|
|
code in curl_strtoofft.c. Note that the function is only provided if no
|
2004-04-07 11:30:40 +04:00
|
|
|
strtoll() (or equivalent) function exist on your platform. If curl_off_t
|
|
|
|
is only a 32 bit number on your platform, this macro uses strtol().
|
|
|
|
|
|
|
|
curlx_tvnow()
|
|
|
|
|
|
|
|
returns a struct timeval for the current time.
|
|
|
|
|
|
|
|
curlx_tvdiff()
|
|
|
|
|
|
|
|
returns the difference between two timeval structs, in number of
|
|
|
|
milliseconds.
|
2004-04-30 12:51:19 +04:00
|
|
|
|
|
|
|
curlx_tvdiff_secs()
|
|
|
|
|
|
|
|
returns the same as curlx_tvdiff but with full usec resolution (as a
|
|
|
|
double)
|
|
|
|
|
|
|
|
FUTURE
|
|
|
|
======
|
|
|
|
|
|
|
|
Several functions will be removed from the public curl_ name space in a
|
|
|
|
future libcurl release. They will then only become available as curlx_
|
|
|
|
functions instead. To make the transition easier, we already today provide
|
|
|
|
these functions with the curlx_ prefix to allow sources to get built properly
|
|
|
|
with the new function names. The functions this concerns are:
|
|
|
|
|
|
|
|
curlx_getenv
|
|
|
|
curlx_strequal
|
|
|
|
curlx_strnequal
|
|
|
|
curlx_mvsnprintf
|
|
|
|
curlx_msnprintf
|
|
|
|
curlx_maprintf
|
|
|
|
curlx_mvaprintf
|
|
|
|
curlx_msprintf
|
|
|
|
curlx_mprintf
|
|
|
|
curlx_mfprintf
|
|
|
|
curlx_mvsprintf
|
|
|
|
curlx_mvprintf
|
|
|
|
curlx_mvfprintf
|