Contents

CFHTTPMessageAppendBytes(_:_:_:)

Appends data to a CFHTTPMessage object.

Declaration

func CFHTTPMessageAppendBytes(_ message: CFHTTPMessage, _ newBytes: UnsafePointer<UInt8>, _ numBytes: CFIndex) -> Bool

Parameters

  • message:

    The message to modify.

  • newBytes:

    A reference to the data to append.

  • numBytes:

    The length of the data pointed to by newBytes.

Return Value

TRUE if the data was successfully appended, otherwise FALSE.

Discussion

This function appends the data specified by newBytes to the specified message object which was created by calling CFHTTPMessageCreateEmpty(_:_:). The data is an incoming serialized HTTP request or response received from a client or a server. While appending the data, this function deserializes it, removes any HTTP-based formatting that the message may contain, and stores the message in the message object. You can then call CFHTTPMessageCopyVersion(_:), CFHTTPMessageCopyBody(_:), CFHTTPMessageCopyHeaderFieldValue(_:_:), and CFHTTPMessageCopyAllHeaderFields(_:) to get the message’s HTTP version, the message’s body, a specific header field, and all of the message’s headers, respectively.

If the message is a request, you can also call CFHTTPMessageCopyRequestURL(_:) and CFHTTPMessageCopyRequestMethod(_:) to get the message’s request URL and request method, respectively.

If the message is a response, you can also call CFHTTPMessageGetResponseStatusCode(_:) and CFHTTPMessageCopyResponseStatusLine(_:) to get the message’s status code and status line, respectively.

See Also

HTTP Messages