package core:encoding/base64

Source

Decode_Error :: enum int {
	None, 
	Invalid_Character, 
	Invalid_Padding, 
	Non_Canonical, 
}

Decode_Option :: enum int {
	// Strict requires canonical input as described in RFC 4648 section 3.5:
	// trailing padding bits must be zero, padding must be exact, and padding
	// characters may only appear at the end.
	Strict, 
	// No_Padding rejects the padding character, requiring unpadded input.
	No_Padding, 
}

Decode_Options :: bit_set[Decode_Option; u8]

Encode_Option :: enum int {
	// No_Padding omits the padding character from the output (RFC 4648
	// section 3.2), producing the canonical unpadded ("raw") form.
	// Combine with ENC_URL_TABLE for unpadded base64url, as used by JOSE.
	No_Padding, 
}

Encode_Options :: bit_set[Encode_Option; u8]

Error :: union {
	runtime.Allocator_Error, 
	io.Error, 
	Decode_Error, 
}

PADDING :: '='

@(rodata)
DEC_TABLE: [256]i8 = …

@(rodata)
DEC_URL_TABLE: [256]i8 = …

@(rodata)
ENC_TABLE: [64]u8 = …

@(rodata)
ENC_URL_TABLE: [64]u8 = …

decode :: proc(
	data:      string, 
	DEC_TBL:   [256]i8 = DEC_TABLE, 
	dst:       []u8 = nil, 
	allocator := context.allocator, 
	options:   bit_set[Decode_Option; u8] = Decode_Options{}, 
) -> (decoded: []u8, err: Error) {…}

decode_into :: proc(
	w:       io.Stream, 
	data:    string, 
	DEC_TBL: [256]i8 = DEC_TABLE, 
	options: bit_set[Decode_Option; u8] = Decode_Options{}, 
) -> Error {…}

decode_into_buf :: proc(
	dst:     []u8, 
	data:    string, 
	DEC_TBL: [256]i8 = DEC_TABLE, 
	options: bit_set[Decode_Option; u8] = Decode_Options{}, 
) -> (decoded: []u8, err: Error) {…}

decoded_len :: proc(data: string) -> int {…}

encode :: proc(
	data:      []u8, 
	ENC_TBL:   [64]u8 = ENC_TABLE, 
	allocator := context.allocator, 
	options:   bit_set[Encode_Option; u8] = Encode_Options{}, 
) -> (encoded: string, err: runtime.Allocator_Error) #optional_ok {…}

encode_into :: proc(
	w:       io.Stream, 
	data:    []u8, 
	ENC_TBL: [64]u8 = ENC_TABLE, 
	options: bit_set[Encode_Option; u8] = Encode_Options{}, 
) -> io.Error {…}

encode_into_buf :: proc(
	dst, data: []u8, 
	ENC_TBL:   [64]u8 = ENC_TABLE, 
	options:   bit_set[Encode_Option; u8] = Encode_Options{}, 
) -> (encoded: []u8, err: Error) {…}

encoded_len :: proc(data: []u8, options: bit_set[Encode_Option; u8] = Encode_Options{}) -> int {…}