Zig Requires Chilkat v11.7.0+

Handle QR Code Errors

See more QR Code Examples

Demonstrates what happens when a request is refused. QrCode returns false and the response holds errors[0] with three members: a code that does not change between versions, the path of the request member at fault (a JSON Pointer such as /encoding/qr/version), and a message. Requests are checked strictly, so a misspelled option is an error rather than being silently ignored. LastErrorText has the same information in more detail. Zig

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

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

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    const fmt = try chilkat.Formats.init();
    defer fmt.deinit();
    const json = try chilkat.JsonObject.init();
    defer json.deinit();
    const json_out = try chilkat.JsonObject.init();
    defer json_out.deinit();

    // 1. A misspelled option: "moduleSise" for "moduleSize".
    json.updateString("payload.text", "https://www.chilkatsoft.com/") catch {};
    json.updateInt("render.moduleSise", 8) catch {};
    fmt.qrCode("generate", json, json_out) catch {
        std.debug.print("code: {s}\n", .{try json_out.stringOf(alloc, "errors[0].code")});
        std.debug.print("path: {s}\n", .{try json_out.stringOf(alloc, "errors[0].path")});
        std.debug.print("message: {s}\n", .{try json_out.stringOf(alloc, "errors[0].message")});
    };

    // 2. A value out of range: QR versions are 1 to 40.
    json.clear();
    json.updateString("payload.text", "https://www.chilkatsoft.com/") catch {};
    json.updateInt("encoding.qr.version", 41) catch {};
    fmt.qrCode("generate", json, json_out) catch {
        std.debug.print("code: {s}\n", .{try json_out.stringOf(alloc, "errors[0].code")});
        std.debug.print("path: {s}\n", .{try json_out.stringOf(alloc, "errors[0].path")});
        std.debug.print("message: {s}\n", .{try json_out.stringOf(alloc, "errors[0].message")});
    };

    // 3. Too much data: this text does not fit a version 1 symbol.
    json.clear();
    json.updateString("payload.text", "https://www.chilkatsoft.com/barcode_overview.asp") catch {};
    json.updateInt("encoding.qr.version", 1) catch {};
    fmt.qrCode("generate", json, json_out) catch {
        std.debug.print("code: {s}\n", .{try json_out.stringOf(alloc, "errors[0].code")});
        std.debug.print("path: {s}\n", .{try json_out.stringOf(alloc, "errors[0].path")});
        std.debug.print("message: {s}\n", .{try json_out.stringOf(alloc, "errors[0].message")});
    };

    // A program can act on the code.
    if (std.mem.eql(u8, try json_out.stringOf(alloc, "errors[0].code"), "capacityExceeded")) {
        std.debug.print("The text is too long for the symbol size allowed.\n", .{});
    }

    // Sample output:

    // code: unknownOption
    // path: /render/moduleSise
    // message: unknown option
    // code: outOfRange
    // path: /encoding/qr/version
    // message: the value is out of range
    // code: capacityExceeded
    // path: /payload
    // message: the payload does not fit the requested QR version at the requested error-correction level
    // The text is too long for the symbol size allowed.
}