1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
// Copyright 2014 The Chromium OS Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef LIBBRILLO_BRILLO_DATA_ENCODING_H_
#define LIBBRILLO_BRILLO_DATA_ENCODING_H_
#include <string>
#include <utility>
#include <vector>
#include <brillo/brillo_export.h>
#include <brillo/secure_blob.h>
namespace brillo {
namespace data_encoding {
using WebParamList = std::vector<std::pair<std::string, std::string>>;
// Encode/escape string to be used in the query portion of a URL.
// If |encodeSpaceAsPlus| is set to true, spaces are encoded as '+' instead
// of "%20"
BRILLO_EXPORT std::string UrlEncode(const char* data, bool encodeSpaceAsPlus);
inline std::string UrlEncode(const char* data) {
return UrlEncode(data, true);
}
// Decodes/unescapes a URL. Replaces all %XX sequences with actual characters.
// Also replaces '+' with spaces.
BRILLO_EXPORT std::string UrlDecode(const char* data);
// Converts a list of key-value pairs into a string compatible with
// 'application/x-www-form-urlencoded' content encoding.
BRILLO_EXPORT std::string WebParamsEncode(const WebParamList& params,
bool encodeSpaceAsPlus);
inline std::string WebParamsEncode(const WebParamList& params) {
return WebParamsEncode(params, true);
}
// Parses a string of '&'-delimited key-value pairs (separated by '=') and
// encoded in a way compatible with 'application/x-www-form-urlencoded'
// content encoding.
BRILLO_EXPORT WebParamList WebParamsDecode(const std::string& data);
// Encodes binary data using base64-encoding.
BRILLO_EXPORT std::string Base64Encode(const void* data, size_t size);
// Encodes binary data using base64-encoding and wraps lines at 64 character
// boundary using LF as required by PEM (RFC 1421) specification.
BRILLO_EXPORT std::string Base64EncodeWrapLines(const void* data, size_t size);
// Decodes the input string from Base64.
BRILLO_EXPORT bool Base64Decode(const std::string& input, brillo::Blob* output);
// Helper wrappers to use std::string and brillo::Blob as binary data
// containers.
inline std::string Base64Encode(const brillo::Blob& input) {
return Base64Encode(input.data(), input.size());
}
inline std::string Base64EncodeWrapLines(const brillo::Blob& input) {
return Base64EncodeWrapLines(input.data(), input.size());
}
inline std::string Base64Encode(const std::string& input) {
return Base64Encode(input.data(), input.size());
}
inline std::string Base64EncodeWrapLines(const std::string& input) {
return Base64EncodeWrapLines(input.data(), input.size());
}
inline bool Base64Decode(const std::string& input, std::string* output) {
brillo::Blob blob;
if (!Base64Decode(input, &blob))
return false;
*output = std::string{blob.begin(), blob.end()};
return true;
}
} // namespace data_encoding
} // namespace brillo
#endif // LIBBRILLO_BRILLO_DATA_ENCODING_H_
|
