base64: XML Security Library Reference Manual

base64

base64 — Base64 encoding/decoding functions and base64 transform implementation.

Stability Level

Stable, unless otherwise indicated

Functions

int	xmlSecBase64GetDefaultLineSize ()
void	xmlSecBase64SetDefaultLineSize ()
xmlSecBase64CtxPtr	xmlSecBase64CtxCreate ()
void	xmlSecBase64CtxDestroy ()
int	xmlSecBase64CtxInitialize ()
void	xmlSecBase64CtxFinalize ()
int	xmlSecBase64CtxUpdate ()
int	xmlSecBase64CtxFinal ()
xmlChar *	xmlSecBase64Encode ()
int	xmlSecBase64Decode ()

Types and Values

#define

XMLSEC_BASE64_LINESIZE

Description

Functions

xmlSecBase64GetDefaultLineSize ()

int
xmlSecBase64GetDefaultLineSize (void);

Gets the current default line size.

Returns

the current default line size.

xmlSecBase64SetDefaultLineSize ()

void
xmlSecBase64SetDefaultLineSize (int columns);

Sets the current default line size.

Parameters

columns

number of columns

xmlSecBase64CtxCreate ()

xmlSecBase64CtxPtr
xmlSecBase64CtxCreate (int encode,
                       int columns);

Allocates and initializes new base64 context.

Parameters

encode	the encode/decode flag (1 - encode, 0 - decode)
columns	the max line length.

Returns

a pointer to newly created xmlSecBase64Ctx structure or NULL if an error occurs.

xmlSecBase64CtxDestroy ()

void
xmlSecBase64CtxDestroy (xmlSecBase64CtxPtr ctx);

Destroys base64 context.

Parameters

ctx

the pointer to xmlSecBase64Ctx structure.

xmlSecBase64CtxInitialize ()

int
xmlSecBase64CtxInitialize (xmlSecBase64CtxPtr ctx,
                           int encode,
                           int columns);

Initializes new base64 context.

Parameters

ctx	the pointer to xmlSecBase64Ctx structure,
encode	the encode/decode flag (1 - encode, 0 - decode)
columns	the max line length.

Returns

0 on success and a negative value otherwise.

xmlSecBase64CtxFinalize ()

void
xmlSecBase64CtxFinalize (xmlSecBase64CtxPtr ctx);

Frees all the resources allocated by ctx .

Parameters

ctx

the pointer to xmlSecBase64Ctx structure,

xmlSecBase64CtxUpdate ()

int
xmlSecBase64CtxUpdate (xmlSecBase64CtxPtr ctx,
                       const xmlSecByte *in,
                       xmlSecSize inSize,
                       xmlSecByte *out,
                       xmlSecSize outSize);

Encodes or decodes the next piece of data from input buffer.

Parameters

ctx	the pointer to xmlSecBase64Ctx structure
in	the input buffer
inSize	the input buffer size
out	the output buffer
outSize	the output buffer size

Returns

the number of bytes written to output buffer or -1 if an error occurs.

xmlSecBase64CtxFinal ()

int
xmlSecBase64CtxFinal (xmlSecBase64CtxPtr ctx,
                      xmlSecByte *out,
                      xmlSecSize outSize);

Encodes or decodes the last piece of data stored in the context and finalizes the result.

Parameters

ctx	the pointer to xmlSecBase64Ctx structure
out	the output buffer
outSize	the output buffer size

Returns

the number of bytes written to output buffer or -1 if an error occurs.

xmlSecBase64Encode ()

xmlChar *
xmlSecBase64Encode (const xmlSecByte *buf,
                    xmlSecSize len,
                    int columns);

Encodes the data from input buffer and allocates the string for the result. The caller is responsible for freeing returned buffer using xmlFree() function.

Parameters

buf	the input buffer.
len	the input buffer size.
columns	the output max line length (if 0 then no line breaks would be inserted)

Returns

newly allocated string with base64 encoded data or NULL if an error occurs.

xmlSecBase64Decode ()

int
xmlSecBase64Decode (const xmlChar *str,
                    xmlSecByte *buf,
                    xmlSecSize len);

Decodes input base64 encoded string and puts result into the output buffer.

Parameters

str	the input buffer with base64 encoded string
buf	the output buffer
len	the output buffer size

Returns

the number of bytes written to the output buffer or a negative value if an error occurs

Types and Values

XMLSEC_BASE64_LINESIZE

#define XMLSEC_BASE64_LINESIZE                          64

The default maximum base64 encoded line size.