Indicates to the mock server that a single new line of a message was received from the real server.
The message line may be appended to the current trace file if logging is enabled ( enable_logging is true), adding a newline character at the end. If logging is disabled but online mode is enabled ( enable_online is true), the message line will be compared to the next expected line in the existing trace file. Otherwise, this function is a no-op.
On failure, throws will be set and the Server state will
remain unchanged apart from the parse state machine, which will remain in the state reached after parsing message_chunk. A
g_io_error will be returned if writing to the trace file failed. If in comparison mode and the received
message chunk corresponds to an unexpected message in the trace file, a uhm_server_error will be
returned.
<note><para>In common cases where message log data only needs to be passed to a Server and not (for example) logged to an application-specific file or the command line as well, it is simpler to use received_message_chunk_from_soup, passing it directly to set_printer. See the documentation for received_message_chunk_from_soup for details.< /para></note>
| this |
a Server |
| message_chunk |
single line of a message which was received |
| message_chunk_length |
length of |