Receive a Bounded String from a Socket

See more Socket/SSL/TLS Examples

Demonstrates Socket.ReceiveStringMaxN, which receives and decodes text like ReceiveString but reads at most a given number of input bytes.

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    const socket = try chilkat.Socket.init();
    defer socket.deinit();

    // Connect to the server using TLS.  The 3rd argument enables the TLS handshake after the TCP
    // connection succeeds; the 4th is the maximum time to wait, in milliseconds.
    const b_tls = true;
    const max_wait_ms = 5000;
    socket.connect("example.com", 5000, b_tls, max_wait_ms) catch {
        std.debug.print("{s}\n", .{try socket.getLastErrorText(alloc)});
        return;
    };

    // StringCharset controls the character encoding used when sending and receiving text.
    socket.setStringCharset("utf-8");
    // Send a request using a simple application-defined text protocol in which each message ends with a
    // CRLF.
    const command = "STATUS\r\n";
    socket.sendString(command) catch {
        std.debug.print("{s}\n", .{try socket.getLastErrorText(alloc)});
        return;
    };

    // Receive and decode text like ReceiveString, but read at most the given number of input bytes.
    // The limit is measured in bytes, not Unicode characters.
    const first_chunk = socket.receiveStringMaxN(alloc, 64) catch {
        std.debug.print("{s}\n", .{try socket.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("{s}\n", .{first_chunk});
}