[C/C++] The b64 namespace, within which the core library types and functions reside in C++ compilation. In C compilation, they all reside in the global namespace. More...
Typedefs | |
typedef enum B64_RC | B64_RC |
typedef enum B64_FLAGS | B64_FLAGS |
Enumerations | |
enum | B64_RC { B64_RC_OK = 0, B64_RC_INSUFFICIENT_BUFFER = 1, B64_RC_TRUNCATED_INPUT = 2, B64_RC_DATA_ERROR, B64_max_RC_value } |
Return codes (from b64_encode2() / b64_decode2()). More... | |
enum | B64_FLAGS { B64_F_LINE_LEN_USE_PARAM = 0x0000, B64_F_LINE_LEN_INFINITE = 0x0001, B64_F_LINE_LEN_64 = 0x0002, B64_F_LINE_LEN_76 = 0x0003, B64_F_LINE_LEN_MASK = 0x000f, B64_F_STOP_ON_NOTHING = 0x0000, B64_F_STOP_ON_UNKNOWN_CHAR = 0x0100, B64_F_STOP_ON_UNEXPECTED_WS = 0x0200, B64_F_STOP_ON_BAD_CHAR = 0x0300 } |
Coding behaviour modification flags (for b64_encode2() / b64_decode2()). More... | |
Functions | |
size_t | b64_encode (void const *src, size_t srcSize, char *dest, size_t destLen) |
Encodes a block of binary data into Base-64. | |
size_t | b64_encode2 (void const *src, size_t srcSize, char *dest, size_t destLen, unsigned flags, int lineLen, B64_RC *rc) |
Encodes a block of binary data into Base-64. | |
size_t | b64_decode (char const *src, size_t srcLen, void *dest, size_t destSize) |
Decodes a sequence of Base-64 into a block of binary data. | |
size_t | b64_decode2 (char const *src, size_t srcLen, void *dest, size_t destSize, unsigned flags, char const **badChar, B64_RC *rc) |
Decodes a sequence of Base-64 into a block of binary data. | |
char const * | b64_getErrorString (B64_RC code) |
Returns the textual description of the error. | |
size_t | b64_getErrorStringLength (B64_RC code) |
Returns the length of the textual description of the error. |
[C/C++] The b64 namespace, within which the core library types and functions reside in C++ compilation. In C compilation, they all reside in the global namespace.
Coding behaviour modification flags (for b64_encode2() / b64_decode2()).
B64_F_LINE_LEN_USE_PARAM |
Uses the lineLen parameter to b64_encode2(). Ignored by b64_decode2(). |
B64_F_LINE_LEN_INFINITE |
Ignores the lineLen parameter to b64_encode2(). Line length is infinite. Ignored by b64_decode2(). |
B64_F_LINE_LEN_64 |
Ignores the lineLen parameter to b64_encode2(). Line length is 64. Ignored by b64_decode2(). |
B64_F_LINE_LEN_76 |
Ignores the lineLen parameter to b64_encode2(). Line length is 76. Ignored by b64_decode2(). |
B64_F_LINE_LEN_MASK |
Mask for testing line length flags to b64_encode2(). Ignored by b64_encode2(). |
B64_F_STOP_ON_NOTHING |
Decoding ignores all invalid characters in the input data. Ignored by b64_encode2(). |
B64_F_STOP_ON_UNKNOWN_CHAR |
Causes decoding to break if any non-Base-64 [a-zA-Z0-9=+/], non-whitespace character is encountered. Ignored by b64_encode2(). |
B64_F_STOP_ON_UNEXPECTED_WS |
Causes decoding to break if any unexpected whitespace is encountered. Ignored by b64_encode2(). |
B64_F_STOP_ON_BAD_CHAR |
Causes decoding to break if any non-Base-64 [a-zA-Z0-9=+/] character is encountered. Ignored by b64_encode2(). |
Return codes (from b64_encode2() / b64_decode2()).
size_t B64_NAMESPACE::b64_decode | ( | char const * | src, | |
size_t | srcLen, | |||
void * | dest, | |||
size_t | destSize | |||
) |
Decodes a sequence of Base-64 into a block of binary data.
src | Pointer to the Base-64 block to be decoded. May not be NULL, except when dest is NULL, in which case it is ignored. If dest is NULL, and src is not NULL, then the returned value is calculated exactly, otherwise a value is returned that is guaranteed to be large enough to hold the decoded block. | |
srcLen | Length of block to be encoded. Must be an integral of 4, the Base-64 encoding quantum, otherwise the Base-64 block is assumed to be invalid | |
dest | Pointer to the buffer into which the result is to be written. May be NULL, in which case the function returns the required length | |
destSize | Length of the buffer into which the result is to be written. Must be at least as large as that indicated by the return value from b64_decode(src, srcSize, NULL, 0) , even in the case where the encoded form contains a number of characters that will be ignored, resulting in a lower total length of converted form. |
destSize
dest
is NULL. The returned size might be larger than the actual required size, but will never be smaller.References B64_F_STOP_ON_NOTHING.
size_t B64_NAMESPACE::b64_decode2 | ( | char const * | src, | |
size_t | srcLen, | |||
void * | dest, | |||
size_t | destSize, | |||
unsigned | flags, | |||
char const ** | badChar, | |||
B64_RC * | rc | |||
) |
Decodes a sequence of Base-64 into a block of binary data.
src | Pointer to the Base-64 block to be decoded. May not be NULL, except when dest is NULL, in which case it is ignored. If dest is NULL, and src is not NULL, then the returned value is calculated exactly, otherwise a value is returned that is guaranteed to be large enough to hold the decoded block. | |
srcLen | Length of block to be encoded. Must be an integral of 4, the Base-64 encoding quantum, otherwise the Base-64 block is assumed to be invalid | |
dest | Pointer to the buffer into which the result is to be written. May be NULL, in which case the function returns the required length | |
destSize | Length of the buffer into which the result is to be written. Must be at least as large as that indicated by the return value from b64_decode(src, srcSize, NULL, 0) , even in the case where the encoded form contains a number of characters that will be ignored, resulting in a lower total length of converted form. | |
flags | A combination of the B64_FLAGS enumeration, that moderate the behaviour of the function. | |
rc | The return code representing the status of the operation. May be NULL. | |
badChar | If the flags parameter does not contain B64_F_STOP_ON_NOTHING, this parameter specifies the address of a pointer that will be set to point to any character in the sequence that stops the parsing, as dictated by the flags parameter. May be NULL. |
destSize
, or a bad character stopped parsing.dest
is NULL. The returned size might be larger than the actual required size, but will never be smaller.size_t B64_NAMESPACE::b64_encode | ( | void const * | src, | |
size_t | srcSize, | |||
char * | dest, | |||
size_t | destLen | |||
) |
Encodes a block of binary data into Base-64.
src | Pointer to the block to be encoded. May not be NULL, except when dest is NULL, in which case it is ignored. | |
srcSize | Length of block to be encoded | |
dest | Pointer to the buffer into which the result is to be written. May be NULL, in which case the function returns the required length | |
destLen | Length of the buffer into which the result is to be written. Must be at least as large as that indicated by the return value from b64_encode(NULL, srcSize, NULL, 0). |
destLen
dest
is NULLdest
is NULL. The returned size might be larger than the actual required size, but will never be smaller.size_t B64_NAMESPACE::b64_encode2 | ( | void const * | src, | |
size_t | srcSize, | |||
char * | dest, | |||
size_t | destLen, | |||
unsigned | flags, | |||
int | lineLen, | |||
B64_RC * | rc | |||
) |
Encodes a block of binary data into Base-64.
src | Pointer to the block to be encoded. May not be NULL, except when dest is NULL, in which case it is ignored. | |
srcSize | Length of block to be encoded | |
dest | Pointer to the buffer into which the result is to be written. May be NULL, in which case the function returns the required length | |
destLen | Length of the buffer into which the result is to be written. Must be at least as large as that indicated by the return value from b64_encode2(NULL, srcSize, NULL, 0, flags, lineLen, rc). | |
flags | A combination of the B64_FLAGS enumeration, that moderate the behaviour of the function | |
lineLen | If the flags parameter contains B64_F_LINE_LEN_USE_PARAM, then this parameter represents the length of the lines into which the encoded form is split, with a hard line break ('\r\n'). If this value is 0, then the line is not split. If it is <0, then the RFC-1113 recommended line length of 64 is used | |
rc | The return code representing the status of the operation. May be NULL. |
destLen
dest
is NULL. The returned size might be larger than the actual required size, but will never be smaller.char const* B64_NAMESPACE::b64_getErrorString | ( | B64_RC | code | ) |
Returns the textual description of the error.
code | The error code |
size_t B64_NAMESPACE::b64_getErrorStringLength | ( | B64_RC | code | ) |
Returns the length of the textual description of the error.
code | The error code |