Sample code for 30+ languages & platforms
Swift

Read the REST Response Body in Chunks

See more REST Examples

Demonstrates Rest.ReadRespChunkBd, which reads the response body one chunk at a time, appending each chunk to a BinData. A return value of 0 signals the body is complete, while -1 indicates a read failure.

Background. Chunked reading lets an application process a large response incrementally rather than buffering the entire body at once. It is used after ReadResponseHeader within the staged request model.

Chilkat Swift Downloads

Swift

func chilkatTest() {
    var success: Bool = false

    let rest = CkoRest()!
    var bTls: Bool = true
    var bAutoReconnect: Bool = true
    success = rest.connect(hostname: "example.com", port: 443, tls: bTls, autoReconnect: bAutoReconnect)
    if success == false {
        print("\(rest.lastErrorText!)")
        return
    }

    success = rest.sendReqNoBody(httpVerb: "GET", uriPath: "/api/largefile")
    if success == false {
        print("\(rest.lastErrorText!)")
        return
    }

    var statusCode: Int = rest.readResponseHeader().intValue
    if statusCode < 0 {
        print("\(rest.lastErrorText!)")
        return
    }

    //  Check for the expected success status code.  If the response is not 200, the body is likely
    //  error text formatted as JSON, XML, or HTML rather than the expected content.  In that case read
    //  the body as text, report it, and return.
    if statusCode != 200 {
        let sbError = CkoStringBuilder()!
        success = rest.readRespSb(responseBody: sbError)
        if success == false {
            print("\(rest.lastErrorText!)")
            return
        }

        print("Request failed with status code \(statusCode)")
        print("\(sbError.getAsString()!)")
        return
    }

    //  The status code is 200.  Read the response body in chunks, appending each chunk to the BinData.
    //  Each call waits until at least the requested number of bytes is available, unless the response
    //  ends first.  A return value of 0 means the final bytes were returned and the body is complete;
    //  -1 indicates a read failure.
    let bdBody = CkoBinData()!
    var chunkResult: Int = rest.readRespChunkBd(minSize: 8192, bd: bdBody).intValue
    while chunkResult > 0 {
        chunkResult = rest.readRespChunkBd(minSize: 8192, bd: bdBody).intValue
    }

    if chunkResult < 0 {
        print("\(rest.lastErrorText!)")
        return
    }

    print("Received \(bdBody.numBytes.intValue) bytes.")

}