B64_NAMESPACE Namespace Reference

[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.

Detailed Description

[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.



Enumeration Type Documentation

Coding behaviour modification flags (for b64_encode2() / b64_decode2()).

Enumerator:
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()).

Enumerator:
B64_RC_OK 

Operation was successful.

B64_RC_INSUFFICIENT_BUFFER 

The given translation buffer was not of sufficient size.

B64_RC_TRUNCATED_INPUT 

The input did not represent a fully formed stream of octet couplings.

B64_RC_DATA_ERROR 

Invalid data.


Function Documentation

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.

Parameters:
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.
Returns:
0 if the size of the buffer was insufficient, or the length of the converted buffer was longer than destSize
Note:
The function returns the required length if dest is NULL. The returned size might be larger than the actual required size, but will never be smaller.
The behaviour of both b64_encode2() and b64_decode2() are undefined if the line length is not a multiple of 4.
Threading: The function is fully re-entrant.
See also:
b64::decode()

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.

Parameters:
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.
Returns:
0 if the size of the buffer was insufficient, or the length of the converted buffer was longer than destSize, or a bad character stopped parsing.
Note:
The function returns the required length if dest is NULL. The returned size might be larger than the actual required size, but will never be smaller.
The behaviour of both b64_encode2() and b64_decode2() are undefined if the line length is not a multiple of 4.
Threading: The function is fully re-entrant.
See also:
b64::decode()
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.

Parameters:
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).
Returns:
0 if the size of the buffer was insufficient, or the length of the converted buffer was longer than destLen
Note:
The function returns the required length if dest is NULL
The function returns the required length if dest is NULL. The returned size might be larger than the actual required size, but will never be smaller.
Threading: The function is fully re-entrant.
See also:
b64::encode()
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.

Parameters:
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.
Returns:
0 if the size of the buffer was insufficient, or the length of the converted buffer was longer than destLen
Note:
The function returns the required length if dest is NULL. The returned size might be larger than the actual required size, but will never be smaller.
Threading: The function is fully re-entrant.
See also:
b64::encode()
char const* B64_NAMESPACE::b64_getErrorString ( B64_RC  code  ) 

Returns the textual description of the error.

Parameters:
code The error code
size_t B64_NAMESPACE::b64_getErrorStringLength ( B64_RC  code  ) 

Returns the length of the textual description of the error.

See also:
b64_getErrorString()
Parameters:
code The error code

Generated on Wed Sep 2 18:53:37 2009 for oRTP by  doxygen 1.6.1