iconv函数详细解释

最近在使用iconv函数，感觉iconv的函数参数很奇怪。仔细研究了一下，发现iconv实际上一个返回多个值的函数。此函数利用函数参数，同时返回了好几个值，每个函数参数既是入参，也是出参。详细解释如下：

iconv的原型如下：
size_t iconv(iconv_t cd,char **inbuf,size_t *inbytesleft,char **outbuf,size_t *outbytesleft);

函数参数比较奇怪的地方有：

 1.inbuf 为什么是二级指针，而不是一级指针。

 2.inbytesleft为什么是指针，而不是普通变量。

 3.outbuf 为什么是二级指针，而不是一级指针。

 4.outbytesleft 为什么是指针，而不是普通变量

 

原来，函数执行后，由于各种原因（输出缓冲区太小，输入字符串不是一种编码，而是含有多种编码)，可能只转换了部分编码。这时返回值为-1，这时会改变后四个参数的值。另外，即使全部转换成功，这四个参数的值也要发生变化。

作为入参
第一个参数cd是转换句柄。
第二个参数inbuf是输入字符串的地址的地址。
第三个参数inbytesleft是输入字符串的长度。
第四个参数outbuf是输出缓冲区的首地址
第五个参数outbytesLeft 是输出缓冲区的长度。

作为出参
第一个参数cd是转换句柄。
第二个参数inbuf指向剩余字符串的地址
第三个参数inbytesleft是剩余字符串的长度。
第四个参数outbuf是输出缓冲区剩余空间的首地址
第五个参数outbytesLeft 是输出缓冲区剩余空间的长度。

这下，同学们应该明白为什么后四个参数，为什么要多取一级地址了吧。

下面是几个例子：

int UTF8ToGBK(char* input, size_t& charInPutLen, char* output, size_t& charOutPutLen)
{

int ret =0;
iconv_t cd;
cd = iconv_open("GBK","utf-8");
ret = iconv(cd, &input, &charInPutLen, &output, &charOutPutLen);
iconv_close(cd);
return ret;
}

int UTF8ToGBK(const string& input, string& output)
{
int ret =0;
size_t charInPutLen = input.length();
if( charInPutLen == 0)
return 0;
char *pSource =(char *)input.c_str();
size_t charOutPutLen = 2*charInPutLen;
char *pTemp = new char[charOutPutLen];
memset(pTemp,0,2*charInPutLen);

iconv_t cd;
char *pSource =(char *)input.c_str();
char *pOut = pTemp ;
cd = iconv_open("utf-8", "GBK");
ret = iconv(cd, &pSource, &charInPutLen, &pTemp, &charOutPutLen);
iconv_close(cd);
output = pOut;
delete []pOut;//注意这里，不能使用delete []pTemp, iconv函数会改变指针pTemp的值
return ret;
}

int  GBKToUTF8(char* input, size_t charInPutLen, char* output, size_t &charOutPutLen)
{
int ret = 0;
iconv_t cd;
cd = iconv_open("utf-8", "GBK");
ret = iconv(cd, &input, &charInPutLen, &output, &charOutPutLen);
iconv_close(cd);
return ret;
}

int  GBKToUTF8(const string& input, string& output)
{
int ret = 0;
size_t charInPutLen = input.length();
if( charInPutLen == 0)
return 0;

size_t charOutPutLen = 2*charInPutLen+1;
char *pTemp = new char[charOutPutLen];
memset(pTemp,0,charOutPutLen);
iconv_t cd;
char *pSource =(char *)input.c_str();
char *pOut = pTemp;
cd = iconv_open("utf-8", "GBK");
ret = iconv(cd, &pSource, &charInPutLen, &pTemp, &charOutPutLen);
iconv_close(cd);
output= pOut;
delete []pOut; //注意这里，不能使用delete []pTemp, iconv函数会改变指针pTemp的值
return ret;
}