|  | Home | Libraries | People | FAQ | More | 
Write a header to a stream asynchronously using a serializer.
        Defined in header <boost/beast/http/write.hpp>
      
template< class AsyncWriteStream, bool isRequest, class Body, class Fields, class WriteHandler> void-or-deduced async_write_header( AsyncWriteStream& stream, serializer< isRequest, Body, Fields >& sr, WriteHandler&& handler);
This function is used to write a header to a stream asynchronously using a caller-provided HTTP/1 serializer. The function call always returns immediately. The asynchronous operation will continue until one of the following conditions is true:
http::serializer::is_header_done returns true
          
        This operation is implemented in terms of zero or more calls to the stream's
        async_write_some function,
        and is known as a composed operation. The program must
        ensure that the stream performs no other writes until this operation completes.
      
| Name | Description | 
|---|---|
| 
                   | The stream to which the data is to be written. The type must support the AsyncWriteStream concept. | 
| 
                   | The serializer to use. The object must remain valid at least until the handler is called; ownership is not transferred. | 
| 
                   | The handler to be called when the operation completes. Copies will be made of the handler as required. The equivalent function signature of the handler must be: void handler( error_code const& error, // result of operation std::size_t bytes_transferred // the number of bytes written to the stream ); 
                  Regardless of whether the asynchronous operation completes immediately
                  or not, the handler will not be invoked from within this function.
                  Invocation of the handler will be performed in a manner equivalent
                  to using  | 
        The implementation will call http::serializer::split with the value true on the serializer passed in.
      
        Convenience header <boost/beast/http.hpp>