TC官方文档翻译12----编码API(Tokyo Cabinet/Tokyo Tyarnt 文档系列)

来源：互联网发布：如何查看linux源代码编辑：程序博客网时间：2024/05/22 00:42

/**
* 转载请注明出处, 由于个人技术能力有限, 英语水平欠缺,
* 有翻译不合适或错误的地方, 请纠正,
* 希望不要因为我的错误误导您, 希望您的智慧可以加入.
* @translator: selfimpr
* @mail: lgg860911@yahoo.com.cn
* @blog: http://blog.csdn.net/lgg201
*/

由于能力有限, 自己对TC的文件数据库部分尚未理解, 所以暂时到此为止.

编码API

char *tcurlencode(const char *ptr, intsize);

使用URL编码规则编码一个序列化对象.

char *tcurldecode(const char *str, int*sp);

使用URL编码规则解码str, sp记录解码后返回值长度

TCMAP *tcurlbreak(const char *str);

把个顶的url字符串str按照URL规则分裂成为一个TCMAP对象, 返回的TCMAP对象中有以下key:

self:URL自身

scheme:协议, 支持HTTP, HTTPS, FTP, FILE等

host:主机名或IP

port:主机端口号

authority:站点信息(不是很清楚, 有懂的朋友麻烦邮件lgg860911@yahoo.com.cn,共同学习, 谢谢)

path:资源路径

file:访问文件名(无目录)

query:查询字符串

fragment:url最后的#后面的东西, 通常是访问锚点. BOM中的window.location.hash

char *tcurlresolve(const char *base, constchar *target);

用一个绝对路径的URL解析一个相对路径的URL, 如果target是相对的, 返回的是相对base的域的URL, 否则返回target的拷贝.

char *tcbaseencode(const char *ptr, intsize);

base64编码一个序列化对象

char *tcbasedecode(const char *str, int*sp);

base64编码解码

char *tcquoteencode(const char *ptr, intsize);

Quoted-printable编码一个序列化对象

char *tcquotedecode(const char *str, int*sp);

Quoted-printable编码解码

char *tcmimeencode(const char *str, constchar *encname, bool base);

MIME编码, encname指定编码名字, base指定是否使用base64进行编码, 如果是false使用Quoted-printable编码

char *tcmimedecode(const char *str, char*enp);

MIME解码, 解码后, enp将会记录tcmimeencode中的encname类型名

char *tcmimebreak(const char *ptr, intsize, TCMAP *headers, int *sp);

把ptr给定的MIME内容拆分成head和body, body作为函数的内容返回, sp将记录body的大小, 对于拆分得到的头, 组装成TCMAP记录到headers中, headers中有如下key

TYPE:Content-Type

CHARSET:Content-Transfer-Encoding

BOUNDARY:Content-Type标头的边界参数值

DISPOSITION:MIME协议的Content-Disposition标头

FILENAME:文件名

NAME:属性名

TCLIST *tcmimeparts(const char *ptr, intsize, const char *boundary);

根据boundary分割ptr指定的MIME数据为一个TCLIST

char *tchexencode(const char *ptr, intsize);

把一个序列化对象编码成16进制, 内部是没读取一个字节, 用sprintf输入到新的字符串中, 最终返回新字符串

char *tcpackencode(const char *ptr, intsize, int *sp);

使用Packbits算法压缩序列化对象, sp记录压缩后大小

char *tcpackdecode(const char *ptr, intsize, int *sp);

使用Packbits算法解压缩

char *tcbsencode(const char *ptr, int size,int *sp);

使用TCBS算法压缩序列化对象, sp记录压缩后大小

char *tcbsendecode(const char *ptr, intsize, int *sp);

使用TCBS算法解压

char *tcdeflate(const char *ptr, int size,int *sp);

使用Deflate算法压缩序列化对象, sp记录压缩后大小

char *tcinflate(const char *ptr, int size,int *sp);

使用Deflate算法解压缩

char *tcgzipencode(const char *ptr, intsize, int *sp);

gzip压缩

char *tcgzipdecode(const char *ptr, intsize, int *sp);

gzip解压缩

unsigned int tcgetcrc(const char *ptr, intsize);

获取CRC32校验和

char *tcbzipencode(const char *ptr, intsize, int *sp);

使用BZIP2压缩

char *tcbzipdecode(const char *ptr, intsize, int *sp);

BZIP2解压缩

char *tcberencode(const unsigned int *ary,int anum, int *sp);

使用BER编码一个无符号整数数组

unsigned int *tcberdecode(const char *ptr,int size, int *np);

从一个字符串利用BER算法解码出一个无符号整数数组, np记录数组大小

char *tcxmlescape(const char *str);

用来将给定的xml字符串str中的特殊字符(xml中定义的)进行转义, 该函数只会转义’&’, ‘<’, ‘>’,‘”’等4个字符

char *tcxmlunescape(const char *str);

将给定的xml字符串str中的实体字符(xml中定义的)还原成原始字符, 该函数只会转义’&’, ‘&lt’,‘>’, ‘quot;’等