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 › crypto › Certificate › der › Element Public Struct Element Doc Source Public Struct std.crypto.Certificate.der.Element
pub const Element = struct Fields Structs Values Functions File crypto/Certificate.zig: 958
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006 pub const Element = struct {
identifier : Identifier ,
slice : Slice ,
pub const Slice = struct {
start : u32 ,
end : u32 ,
pub const empty : Slice = .{ .start = 0 , .end = 0 };
};
pub const ParseError = error {CertificateFieldHasInvalidLength };
pub fn parse (bytes : []const u8 , index : u32 ) Element .ParseError !Element {
var i = index ;
const identifier : Identifier = @bitCast (bytes [i ]);
i += 1 ;
const size_byte = bytes [i ];
i += 1 ;
if ((size_byte >> 7 ) == 0 ) {
return .{
.identifier = identifier ,
.slice = .{
.start = i ,
.end = i + size_byte ,
},
};
}
const len_size : u7 = @truncate (size_byte );
if (len_size > @sizeOf (u32 )) {
return error .CertificateFieldHasInvalidLength ;
}
const end_i = i + len_size ;
var long_form_size : u32 = 0 ;
while (i < end_i ) : (i += 1 ) {
long_form_size = (long_form_size << 8 ) | bytes [i ];
}
return .{
.identifier = identifier ,
.slice = .{
.start = i ,
.end = i + long_form_size ,
},
};
}
}