Zig 0.17.0-dev (Split by item) This is an example of documentation generated by
ZigDoc , an alternative to Zig's built-in
Auto Doc feature. See also
examples in other modes/formats . The project being documented here (as the example) is the Zig standard library.
std › unicode › testRoundtripWtf8 Private Function testRoundtripWtf8 Doc Source Private Function std.unicode.testRoundtripWtf8
fn testRoundtripWtf8 (wtf8 : []const u8 ) !void Params File unicode.zig: 2056
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090 fn testRoundtripWtf8 (wtf8 : []const u8 ) !void {
// Buffer
{
var wtf16_buf : [32 ]u16 = undefined ;
const wtf16_len = try wtf8ToWtf16Le (&wtf16_buf , wtf8 );
try testing .expectEqual (wtf16_len , calcWtf16LeLen (wtf8 ));
const wtf16 = wtf16_buf [0 ..wtf16_len ];
var roundtripped_buf : [32 ]u8 = undefined ;
const roundtripped_len = wtf16LeToWtf8 (&roundtripped_buf , wtf16 );
const roundtripped = roundtripped_buf [0 ..roundtripped_len ];
try testing .expectEqualSlices (u8 , wtf8 , roundtripped );
}
// Alloc
{
const wtf16 = try wtf8ToWtf16LeAlloc (testing .allocator , wtf8 );
defer testing .allocator .free (wtf16 );
const roundtripped = try wtf16LeToWtf8Alloc (testing .allocator , wtf16 );
defer testing .allocator .free (roundtripped );
try testing .expectEqualSlices (u8 , wtf8 , roundtripped );
}
// AllocZ
{
const wtf16 = try wtf8ToWtf16LeAllocZ (testing .allocator , wtf8 );
defer testing .allocator .free (wtf16 );
const roundtripped = try wtf16LeToWtf8AllocZ (testing .allocator , wtf16 );
defer testing .allocator .free (roundtripped );
try testing .expectEqualSlices (u8 , wtf8 , roundtripped );
}
}