ladybird/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/Optional.h>
#include <AK/String.h>
#include <AK/StringView.h>

namespace AK {

size_t calculate_base64_decoded_length(StringView);

size_t calculate_base64_encoded_length(ReadonlyBytes);

Optional<ByteBuffer> decode_base64(StringView);

String encode_base64(ReadonlyBytes);

}

using AK::decode_base64;
using AK::encode_base64;
AK: Add a simple and inefficient Base64 decoder 2020-04-26 20:49:19 +00: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 08:24:48 +00:00			`* SPDX-License-Identifier: BSD-2-Clause`
AK: Add a simple and inefficient Base64 decoder 2020-04-26 20:49:19 +00: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 18:40:53 +00: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 14:48:48 +00:00			`#include <AK/ByteBuffer.h>`
AK+Everywhere: Make Base64 decoding fallible 2021-10-23 13:43:59 +00:00			`#include <AK/Optional.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 14:48:48 +00:00			`#include <AK/String.h>`
			`#include <AK/StringView.h>`
AK: Add a simple and inefficient Base64 decoder 2020-04-26 20:49:19 +00:00
			`namespace AK {`

Everywhere: Pass AK::StringView by value 2021-11-10 23:55:02 +00:00			`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 14:48:48 +00:00
			`size_t calculate_base64_encoded_length(ReadonlyBytes);`

Everywhere: Pass AK::StringView by value 2021-11-10 23:55:02 +00:00			`Optional<ByteBuffer> decode_base64(StringView);`
AK: Add a simple and inefficient Base64 decoder 2020-04-26 20:49:19 +00:00
AK: Change the signature of AK::encode_base64() to use Span. 2020-07-27 12:16:33 +00:00			`String encode_base64(ReadonlyBytes);`
AK: Add a simple and inefficient Base64 encoder The test cases are taken from RFC 4648. 2020-06-13 02:09:31 +00:00
AK: Add a simple and inefficient Base64 decoder 2020-04-26 20:49:19 +00:00			`}`

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