base64.h File Reference

Base64 encoding. More...

#include <stdint.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
static size_t	base64_encoded_len (size_t raw_len)
	Calculate length of base64-encoded string.
void	base64_encode (const char *raw, char *encoded)
	Base64-encode a string.

---

Detailed Description

Base64 encoding.

Definition in file base64.h.

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

static size_t base64_encoded_len

(

size_t

raw_len

)

[inline, static]

Calculate length of base64-encoded string.

Parameters:

raw_len

Raw string length (excluding NUL)

Return values:

encoded_len

Encoded string length (excluding NUL)

Definition at line 20 of file base64.h.

Referenced by base64_encode(), and http_step().

                                                           {
        return ( ( ( raw_len + 3 - 1 ) / 3 ) * 4 );
}

void base64_encode	(	const char *	raw,
		char *	encoded
	)

Base64-encode a string.

Parameters:

	raw	Raw string
	encoded	Buffer for encoded string

The buffer must be the correct length for the encoded string. Use something like

char buf[ base64_encoded_len ( strlen ( raw ) ) + 1 ];

(the +1 is for the terminating NUL) to provide a buffer of the correct size.

Definition at line 49 of file base64.c.

References assert, base64, base64_encoded_len(), DBG, and strlen().

Referenced by http_step().

                                                      {
        const uint8_t *raw_bytes = ( ( const uint8_t * ) raw );
        uint8_t *encoded_bytes = ( ( uint8_t * ) encoded );
        size_t raw_bit_len = ( 8 * strlen ( raw ) );
        unsigned int bit;
        unsigned int tmp;

        for ( bit = 0 ; bit < raw_bit_len ; bit += 6 ) {
                tmp = ( ( raw_bytes[ bit / 8 ] << ( bit % 8 ) ) |
                        ( raw_bytes[ bit / 8 + 1 ] >> ( 8 - ( bit % 8 ) ) ) );
                tmp = ( ( tmp >> 2 ) & 0x3f );
                *(encoded_bytes++) = base64[tmp];
        }
        for ( ; ( bit % 8 ) != 0 ; bit += 6 )
                *(encoded_bytes++) = '=';
        *(encoded_bytes++) = '\0';

        DBG ( "Base64-encoded \"%s\" as \"%s\"\n", raw, encoded );
        assert ( strlen ( encoded ) == base64_encoded_len ( strlen ( raw ) ) );
}