mirror of
https://github.com/SerenityOS/serenity
synced 2024-07-01 11:19:21 +00:00
e9b16970fe
This encoding scheme comes from section 5 of RFC 4648, as an alternative to the standard base64 encode/decode methods. The only difference is that the last two characters are replaced with '-' and '_', as '+' and '/' are not safe in URLs or filenames.
78 lines
2.1 KiB
C++
78 lines
2.1 KiB
C++
/*
|
|
* Copyright (c) 2020, Andreas Kling <kling@serenityos.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/Array.h>
|
|
#include <AK/ByteBuffer.h>
|
|
#include <AK/Error.h>
|
|
#include <AK/String.h>
|
|
#include <AK/StringView.h>
|
|
|
|
namespace AK {
|
|
|
|
// https://datatracker.ietf.org/doc/html/rfc4648#section-4
|
|
constexpr Array base64_alphabet = {
|
|
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H',
|
|
'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
|
|
'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X',
|
|
'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f',
|
|
'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n',
|
|
'o', 'p', 'q', 'r', 's', 't', 'u', 'v',
|
|
'w', 'x', 'y', 'z', '0', '1', '2', '3',
|
|
'4', '5', '6', '7', '8', '9', '+', '/'
|
|
};
|
|
|
|
// https://datatracker.ietf.org/doc/html/rfc4648#section-5
|
|
constexpr Array base64url_alphabet = {
|
|
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H',
|
|
'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
|
|
'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X',
|
|
'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f',
|
|
'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n',
|
|
'o', 'p', 'q', 'r', 's', 't', 'u', 'v',
|
|
'w', 'x', 'y', 'z', '0', '1', '2', '3',
|
|
'4', '5', '6', '7', '8', '9', '-', '_'
|
|
};
|
|
|
|
consteval auto base64_lookup_table()
|
|
{
|
|
Array<i16, 256> table;
|
|
table.fill(-1);
|
|
for (size_t i = 0; i < base64_alphabet.size(); ++i) {
|
|
table[base64_alphabet[i]] = static_cast<i16>(i);
|
|
}
|
|
return table;
|
|
}
|
|
|
|
consteval auto base64url_lookup_table()
|
|
{
|
|
Array<i16, 256> table;
|
|
table.fill(-1);
|
|
for (size_t i = 0; i < base64url_alphabet.size(); ++i) {
|
|
table[base64url_alphabet[i]] = static_cast<i16>(i);
|
|
}
|
|
return table;
|
|
}
|
|
|
|
[[nodiscard]] size_t calculate_base64_decoded_length(StringView);
|
|
|
|
[[nodiscard]] size_t calculate_base64_encoded_length(ReadonlyBytes);
|
|
|
|
[[nodiscard]] ErrorOr<ByteBuffer> decode_base64(StringView);
|
|
[[nodiscard]] ErrorOr<ByteBuffer> decode_base64url(StringView);
|
|
|
|
[[nodiscard]] ErrorOr<String> encode_base64(ReadonlyBytes);
|
|
[[nodiscard]] ErrorOr<String> encode_base64url(ReadonlyBytes);
|
|
}
|
|
|
|
#if USING_AK_GLOBALLY
|
|
using AK::decode_base64;
|
|
using AK::decode_base64url;
|
|
using AK::encode_base64;
|
|
using AK::encode_base64url;
|
|
#endif
|