openssl之BIO系列之21---Base64类型的BIO

Base64类型BIO

    ---根据openssl doc\crypto\bio_f_base64.pod翻译和自己的理解写成

    （作者：DragonKing, Mail: wzhah@263.net ,发布于：http://gdwzh.126.com之o

penssl专业论坛）

    该类型为过滤（filter）类型BIO，其定义如下（openssl\bio.h,openssl\evp.h）

：

     BIO_METHOD * BIO_f_base64(void);

    【BIO_f_base64】

    该函数返回一个Base64类型的BIO_METHOD结构，该结构定义如下（evp\bio_b64.c）

：

    static BIO_METHOD methods_b64=

    {

     BIO_TYPE_BASE64,

     "base64 encoding",

     b64_write,

     b64_read,

     NULL, /* b64_puts, */

     NULL, /* b64_gets, */

     b64_ctrl,

     b64_new,

     b64_free,

     b64_callback_ctrl,

    };

    应该注意的是，该类型的BIO其定义并不在bio目录下，而是在evp目录下。

    当往该BIO写入数据时，数据被Base64编码，当从该BIO读数据时，数据被Base64解

码。该BIO不支持BIO_gets和BIO_puts的功能。

    BIO_flush在该类型BIO被调用的时候，表示需要写入的数据已经写完，用来把最后

的一段数据写入到BIO里面去。

    【BIO_set_flags】

    该函数可以用来设置标记BIO_FLAGS_BASE64_NO_NL，该标记设置后，将把所有数据

编码成为一行或者说期望所有数据都在一行上。需要注意的是，由于base64编码本身格

式的原因，不能准确可靠的决定编码后的数据块的结束位置，大家使用的时候自己需要

注意数据的长度问题。

    【例子】

    下面的程序将字符串"Hello World\n"进行base64编码并写入到标准输出设备。

     BIO *bio, *b64;

     char message[] = "Hello World \n";

     b64 = BIO_new(BIO_f_base64());

     bio = BIO_new_fp(stdout, BIO_NOCLOSE);

     bio = BIO_push(b64, bio);

     BIO_write(bio, message, strlen(message));

     BIO_flush(bio);

     BIO_free_all(bio);

    下面的程序将base64编码的数据从标准输入设备读出并将解码数据输出到标准输出

设备：

     BIO *bio, *b64, bio_out;

     char inbuf[512];

     int inlen;

     char message[] = "Hello World \n";

     b64 = BIO_new(BIO_f_base64());

     bio = BIO_new_fp(stdin, BIO_NOCLOSE);

     bio_out = BIO_new_fp(stdout, BIO_NOCLOSE);

     bio = BIO_push(b64, bio);

     while((inlen = BIO_read(bio, inbuf, strlen(message))) > 0)

     BIO_write(bio_out, inbuf, inlen);

     BIO_free_all(bio);