serenity/AK/Base64.h

/*
 * Copyright (c) 2020, Andreas Kling <kling@serenityos.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <AK/ByteBuffer.h>
#include <AK/Error.h>
#include <AK/String.h>
#include <AK/StringView.h>

namespace AK {

[[nodiscard]] size_t calculate_base64_decoded_length(StringView);

[[nodiscard]] size_t calculate_base64_encoded_length(ReadonlyBytes);

[[nodiscard]] ErrorOr<ByteBuffer> decode_base64(StringView);

[[nodiscard]] String encode_base64(ReadonlyBytes);
}

using AK::decode_base64;
using AK::encode_base64;
AK: Add a simple and inefficient Base64 decoder 2020-04-26 22:49:19 +02:00			`/*`
			`* Copyright (c) 2020, Andreas Kling <kling@serenityos.org>`
			`*`
Everything: Move to SPDX license identifiers in all files. SPDX License Identifiers are a more compact / standardized way of representing file license information. See: https://spdx.dev/resources/use/#identifiers This was done with the `ambr` search and replace tool. ambr --no-parent-ignore --key-from-file --rep-from-file key.txt rep.txt * 2021-04-22 01:24:48 -07:00			`* SPDX-License-Identifier: BSD-2-Clause`
AK: Add a simple and inefficient Base64 decoder 2020-04-26 22:49:19 +02:00			`*/`

Meta: Add a script check the presence of "#pragma once" in header files .. and make travis run it. I renamed check-license-headers.sh to check-style.sh and expanded it so that it now also checks for the presence of "#pragma once" in .h files. It also checks the presence of a (single) blank line above and below the "#pragma once" line. I also added "#pragma once" to all the files that need it: even the ones we are not check. I also added/removed blank lines in order to make the script not fail. I also ran clang-format on the files I modified. 2020-05-28 20:40:53 +02:00			`#pragma once`

Base64: Pre-allocate size of input and output Problem: - Output of decode and encode grow as the decode and encode happen. This is inefficient because a large size will require many reallocations. - `const` qualifiers are missing on variables which are not intended to change. Solution: - Since the size of the decoded or encoded message is known prior to starting, calculate the size and set the output to that size immediately. All appends will not incur the reallocation overhead. - Add `const` qualifiers to show intent. 2020-10-13 10:48:48 -04:00			`#include <AK/ByteBuffer.h>`
AK+Userland: Make AK::decode_hex() return ErrorOr This lets us propagate the reason why it failed up to the caller. :^) 2022-01-20 17:01:39 +00:00			`#include <AK/Error.h>`
Base64: Pre-allocate size of input and output Problem: - Output of decode and encode grow as the decode and encode happen. This is inefficient because a large size will require many reallocations. - `const` qualifiers are missing on variables which are not intended to change. Solution: - Since the size of the decoded or encoded message is known prior to starting, calculate the size and set the output to that size immediately. All appends will not incur the reallocation overhead. - Add `const` qualifiers to show intent. 2020-10-13 10:48:48 -04:00			`#include <AK/String.h>`
			`#include <AK/StringView.h>`
AK: Add a simple and inefficient Base64 decoder 2020-04-26 22:49:19 +02:00
			`namespace AK {`

AK: Add `nodiscard` attribute to Base64 functions 2022-06-26 10:20:09 -06:00			`[[nodiscard]] size_t calculate_base64_decoded_length(StringView);`
Base64: Pre-allocate size of input and output Problem: - Output of decode and encode grow as the decode and encode happen. This is inefficient because a large size will require many reallocations. - `const` qualifiers are missing on variables which are not intended to change. Solution: - Since the size of the decoded or encoded message is known prior to starting, calculate the size and set the output to that size immediately. All appends will not incur the reallocation overhead. - Add `const` qualifiers to show intent. 2020-10-13 10:48:48 -04:00
AK: Add `nodiscard` attribute to Base64 functions 2022-06-26 10:20:09 -06:00			`[[nodiscard]] size_t calculate_base64_encoded_length(ReadonlyBytes);`
Base64: Pre-allocate size of input and output Problem: - Output of decode and encode grow as the decode and encode happen. This is inefficient because a large size will require many reallocations. - `const` qualifiers are missing on variables which are not intended to change. Solution: - Since the size of the decoded or encoded message is known prior to starting, calculate the size and set the output to that size immediately. All appends will not incur the reallocation overhead. - Add `const` qualifiers to show intent. 2020-10-13 10:48:48 -04:00
AK: Add `nodiscard` attribute to Base64 functions 2022-06-26 10:20:09 -06:00			`[[nodiscard]] ErrorOr<ByteBuffer> decode_base64(StringView);`
AK: Add a simple and inefficient Base64 encoder The test cases are taken from RFC 4648. 2020-06-12 22:09:31 -04:00
AK: Add `nodiscard` attribute to Base64 functions 2022-06-26 10:20:09 -06:00			`[[nodiscard]] String encode_base64(ReadonlyBytes);`
AK: Add a simple and inefficient Base64 decoder 2020-04-26 22:49:19 +02:00			`}`

			`using AK::decode_base64;`
AK: Add a simple and inefficient Base64 encoder The test cases are taken from RFC 4648. 2020-06-12 22:09:31 -04:00			`using AK::encode_base64;`