1 // Copyright 2011 The Chromium Authors
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
13 #include "base/base_export.h"
14 #include "base/containers/span.h"
15 #include "base/strings/string_piece.h"
16 #include "third_party/abseil-cpp/absl/types/optional.h"
20 // Encodes the input binary data in base64.
21 BASE_EXPORT std::string Base64Encode(span<const uint8_t> input);
23 // Encodes the input binary data in base64 and appends it to the output.
24 BASE_EXPORT void Base64EncodeAppend(span<const uint8_t> input,
27 // Encodes the input string in base64.
28 // DEPRECATED, use `std::string Base64Encode(StringPiece input)` instead.
29 // TODO(crbug.com/1486214): Remove this.
30 BASE_EXPORT void Base64Encode(StringPiece input, std::string* output);
32 // Encodes the input string in base64.
33 BASE_EXPORT std::string Base64Encode(StringPiece input);
35 // Decodes the base64 input string. Returns true if successful and false
36 // otherwise. The output string is only modified if successful. The decoding can
38 enum class Base64DecodePolicy {
39 // Input should match the output format of Base64Encode. i.e.
40 // - Input length should be divisible by 4
41 // - Maximum of 2 padding characters
42 // - No non-base64 characters.
45 // Matches https://infra.spec.whatwg.org/#forgiving-base64-decode.
46 // - Removes all ascii whitespace
47 // - Maximum of 2 padding characters
48 // - Allows input length not divisible by 4 if no padding chars are added.
51 BASE_EXPORT bool Base64Decode(
54 Base64DecodePolicy policy = Base64DecodePolicy::kStrict);
56 // Decodes the base64 input string. Returns `absl::nullopt` if unsuccessful.
57 BASE_EXPORT absl::optional<std::vector<uint8_t>> Base64Decode(
62 #endif // BASE_BASE64_H_