replace_with_detailed_error


Description:

public bool replace_with_detailed_error (Message message, ByteArray? response_data, bool ignore_multistatus, string? prefix) throws Error

Tries to read detailed error information from response_data, if not provided, then from message's response_body.

If the detailed error cannot be found, then does nothing, otherwise frees the content of inout_error, if any, and then populates it with an error message prefixed with prefix.

The prefix might be of form "Failed to something", because the resulting error message will be: "Failed to something: HTTP error code XXX (reason_phrase): detailed_error". When prefix is null, the error message will be: "Failed with HTTP error code XXX (reason phrase): detailed_error".

As the caller might not be interested in errors, also the inout_error can be null, in which case the function does nothing.

Parameters:

this

an WebDAVSession

message

a Message

response_data

received response data, or null

ignore_multistatus

whether to ignore multistatus responses

prefix

error message prefix, used when replacing, or null

Returns:

Whether any detailed error had been recognized.