7 Commits

Author	SHA1	Message	Date
Daniel Stenberg	ae7a09db20	CURLOPT_WRITEFUNCTION.3: spell out that it gets called many times	2018-11-23 16:55:33 +01:00
Christopher Head	9526cbe6bc	docs/CURLOPT_WRITEFUNCTION: size is always 1 ... For compatibility with `fwrite`, the `CURLOPT_WRITEFUNCTION` callback is passed two `size_t` parameters which, when multiplied, designate the number of bytes of data passed in. In practice, CURL always sets the first parameter (`size`) to 1. This practice is also enshrined in documentation and cannot be changed in future. The documentation states that the default callback is `fwrite`, which means `fwrite` must be a suitable function for this purpose. However, the documentation also states that the callback must return the number of *bytes* it successfully handled, whereas ISO C `fwrite` returns the number of items (each of size `size`) which it wrote. The only way these numbers can be equal is if `size` is 1. Since `size` is 1 and can never be changed in future anyway, document that fact explicitly and let users rely on it. Closes #2787	2018-07-26 16:24:43 +02:00
Daniel Stenberg	4af40b3646	URLs: change all http:// URLs to https://	2016-02-03 00:19:02 +01:00
Daniel Stenberg	bb71f1aa25	CURLOPT_WRITEFUNCTION: changed the order of some sentences ... First explain the data then describe what the callback should return.	2014-06-17 00:02:22 +02:00
Daniel Stenberg	b203377df7	CURLOPT_WRITEFUNCTION.3: improved language ... Suggestions-by: Jeff Pohlmeyer	2014-06-16 23:55:30 +02:00
Daniel Stenberg	a5e498b543	CURLOPT_WRITEFUNCTION: add RETURN VALUE and DEFAULT sections	2014-06-16 22:01:08 +02:00
Daniel Stenberg	e810ddbb70	CURLOPT_WRITEFUNCTION: initial man page	2014-06-16 20:27:37 +02:00