16 #ifndef INCLUDE_NN_NLIB_BASE64_H_ 17 #define INCLUDE_NN_NLIB_BASE64_H_ 26 BASE64_PLUS_SLASH = 0,
35 BASE64_DEFAULT = BASE64_PLUS_SLASH,
36 BASE64_URL_SAFE = BASE64_MINUS_UNDERSCORE
41 return ((srcsize + 2) / 3) * 4 + 1;
43 static errno_t Encode(
char* dst,
55 return Encode(dst, N, src, srcsize, char_option, padding);
57 #ifdef NLIB_CXX11_DEFAULT_TEMPLATE_ARGUMENT_FOR_FUNCTION_TEMPLATES 58 template<
class DUMMY =
void>
66 size_t dstsize = GetRequiredSize(srcsize);
68 char* p =
new (std::nothrow)
char[dstsize];
69 if (!p)
return ENOMEM;
70 errno_t e = Encode(p, dstsize, src, srcsize, char_option, padding);
94 size_t srcsize) NLIB_NOEXCEPT {
95 return StepEncode(written, dst, N, src, srcsize);
108 bool padding) NLIB_NOEXCEPT {
109 return Close(written, dst, N, padding);
122 BASE64_PLUS_SLASH = 0,
124 BASE64_MINUS_UNDERSCORE,
126 BASE64_UNDERSCORE_COLON,
127 BASE64_UNDERSCORE_MINUS,
128 BASE64_DOT_UNDERSCORE,
129 BASE64_EXCLAMATION_MINUS,
131 BASE64_DEFAULT = BASE64_PLUS_SLASH,
132 BASE64_URL_SAFE = BASE64_MINUS_UNDERSCORE
137 return ((srcsize + 3) / 4) * 3;
143 CharOption char_option = BASE64_DEFAULT) NLIB_NOEXCEPT {
144 return Decode_(written, dst, dstsize, src,
nlib_strlen(src), char_option);
150 CharOption char_option = BASE64_DEFAULT) NLIB_NOEXCEPT {
151 return Decode_(written, dst, N, src,
nlib_strlen(src), char_option);
153 #ifdef NLIB_CXX11_DEFAULT_TEMPLATE_ARGUMENT_FOR_FUNCTION_TEMPLATES 154 template<
class DUMMY =
void>
157 size_t* dstsize,
const char* src,
158 CharOption char_option = BASE64_DEFAULT) NLIB_NOEXCEPT {
161 size_t dstsize_ = GetRequiredSize(srcsize);
163 uint8_t* p =
new (std::nothrow) uint8_t[dstsize_];
164 if (!p)
return ENOMEM;
166 errno_t e = Decode_(&written, p, dstsize_, src, srcsize, char_option);
195 size_t srcsize) NLIB_NOEXCEPT {
196 return StepDecode(written, dst, N, src, srcsize);
205 uint8_t (&dst)[N]) NLIB_NOEXCEPT {
206 return Close(written, dst, N);
211 static errno_t Decode_(
size_t* written,
220 #if defined(NLIB_SIMD) && defined(NLIB_LITTLE_ENDIAN) 229 #endif // INCLUDE_NN_NLIB_BASE64_H_ static errno_t Decode(size_t *written, uint8_t(&dst)[N], const char *src, CharOption char_option=BASE64_DEFAULT) noexcept
Decode(written, dst, N, src, srcsize, char_option)を実行します。
errno_t StepEncode(size_t *written, char(&dst)[N], const void *src, size_t srcsize) noexcept
StepEncode(written, dst, N, src, srcsize)を実行します。
CharOption
Base64Encoder::CharOptionを参照してください。
62番目の文字に'-'、63番目の文字に'_'を指定します。
~Base64Encoder() noexcept
デストラクタです。
62番目の文字に'!'、63番目の文字に'-'を指定します。
Base64のデコードを行います。Base64の各種変形版をサポートします。
#define NLIB_SAFE_BOOL(class_name, exp)
クラス内に安全なoperator bool()を定義します。 可能であればC++11のexplicit boolを利用します。 ...
~Base64Decoder() noexcept
デストラクタです。
static errno_t Encode(char(&dst)[N], const void *src, size_t srcsize, CharOption char_option=BASE64_DEFAULT, bool padding=false) noexcept
Encode(dst, N, src, srcsize, char_option, padding)を実行します。
static errno_t Decode(UniquePtr< uint8_t[]> &dst, size_t *dstsize, const char *src, CharOption char_option=BASE64_DEFAULT) noexcept
データを一括してデコードします。
UniquePtrはポインタの所有権を保持し、UniquePtrがスコープから出るときにデストラクタでポインタをDELで指...
std::unique_ptrに相当するクラスが定義されています。
CharOption
Base64の62番目と63番目の文字のバリエーションを指定できます。
errno_t Close(size_t *written, char(&dst)[N], bool padding) noexcept
Base64Encoder::Close(written, dst, N, padding)を実行します。
62番目の文字に'.'、63番目の文字に'_'を指定します。
Base64のエンコードを行います。Base64の各種変形版をサポートします。
errno_t StepDecode(size_t *written, uint8_t(&dst)[N], const char *src, size_t srcsize) noexcept
StepDecode(written, dst, N, src, srcsize)を実行します。
62番目の文字に'_'、63番目の文字に'-'を指定します。
#define NLIB_NOEXCEPT
環境に合わせてnoexcept 又は同等の定義がされます。
static size_t GetRequiredSize(size_t srcsize) noexcept
データのデコードに必要な領域のサイズを計算します。
static errno_t Decode(size_t *written, uint8_t *dst, size_t dstsize, const char *src, CharOption char_option=BASE64_DEFAULT) noexcept
データを一括してデコードします。
static errno_t Encode(UniquePtr< char[]> &dst, const void *src, size_t srcsize, CharOption char_option=BASE64_DEFAULT, bool padding=false) noexcept
データを一括してエンコードします。
62番目の文字に'+'、63番目の文字に'-'を指定します。
62番目の文字に'_'、63番目の文字に':'を指定します。
#define NLIB_FINAL
利用可能であればfinalが定義されます。そうでない場合は空文字列です。
Base64Decoder() noexcept
デフォルトコンストラクタです。
static size_t GetRequiredSize(size_t srcsize) noexcept
データのエンコードに必要な領域のサイズを計算します。
62番目の文字に'.'、63番目の文字に'-'を指定します。
Base64Encoder() noexcept
デフォルトコンストラクタです。