Richard Smith wrote:
Could we change the summary documentation to read something like:
| Read data into a streambuf at least until a delimiter is | encountered. The implementation may read beyond the | delimiter, but will not block when doing so.
That's a bit on the long side for a brief description, but I've made some tweaks along those lines. Hopefully they will make the behaviour clearer.
While I'm on the subject of ASIO documentation, I can't see any documentation on whether the service_name parameters to the basic_resolver_query constructors are allowed to be port numbers (e.g. "80") or whether they have to be symbolic names (e.g. "http"). Port numbers work, at least on Linux, but it's not clear whether this is something that I should be relying on. Similarly for IPv4 and IPv6 addresses in the host_name parameter.
The behaviour is intended to be as-if getaddrinfo was used, and that function supports numbers as strings. So yes, you can rely on this behaviour. Cheers, Chris