C++ Reference: Standard C++ Library reference: C Library: cstdlib: wctomb
创始人
2024-01-17 16:56:23
0

C++官网参考链接:https://cplusplus.com/reference/cstdlib/wctomb/

函数 

wctomb
int wctomb (char* pmb, wchar_t wc);
宽字符wc被转换为其等效多字节,并存储在pmb指向的数组中。函数在调用后返回由pmb指向的等效多字节序列的字节长度。
wctomb有自己的内部移位状态,只有调用这个函数时才会在必要时对其进行更改。用空指针作为pmb调用函数会重置状态(并返回多字节序列是否依赖于状态)。
此函数的行为取决于所选C区域设置(C locale)的LC_CTYPE类别。

形参
pmb
指向足以容纳多字节序列的数组的指针。
当前区域设置中字符的多字节序列的最大长度是MB_CUR_MAX字节。
或者,可以使用空指针调用函数,在这种情况下,函数将其内部移位状态重置为初始值,并返回多字节序列是否使用依赖于状态的编码。
wc
wchar_t类型的宽字符。

返回值
如果作为pmb传递的实参不是空指针,则返回写入pmb的字符的字节大小。如果没有对应字符,则返回-1。
如果作为pmb传递的实参是空指针,则如果多字节字符编码依赖于状态,则函数返回非零值,否则返回零值。

用例
/* wctomb example */
#include      /* printf */
#include     /* wctomb, wchar_t(C) */

int main() {
  const wchar_t str[] = L"wctomb example";
  const wchar_t* pt;
  char buffer [MB_CUR_MAX];
  int i,length;

  pt = str;
  while (*pt) {
    length = wctomb(buffer,*pt);
    if (length<1) break;
    for (i=0;i     ++pt;
  }

  return 0;
}
该示例使用选定的区域设置(在本例中,是默认的“C”区域设置)打印宽字符串转换为的多字节字符。
输出:

数据竞争
函数修改由pmb指向的数组。
该函数还访问和修改内部状态对象,这可能导致对该函数的并发调用出现数据竞争(有关可能使用外部状态对象的替代方法,请参阅wcrtomb)。
同时更改区域设置还可能导致数据竞争。

异常(C++) 
无抛出保证:此函数不抛出异常。
如果pmb既不是空指针,也不是指向已翻译字符足够长的数组的指针,则会导致未定义的行为。 

另请参考
mblen    Get length of multibyte character (function)
mbtowc    Convert multibyte sequence to wide character (function)
mbstowcs    Convert multibyte string to wide-character string (function)
wcstombs    Convert wide-character string to multibyte string (function) 

相关内容

热门资讯

千岛湖景点导游词 千岛湖景点导游词  作为一位杰出的导游,就有可能用到导游词,一篇完整的导游词,其结构一般包括习惯用语...
南京中山陵导游词 南京中山陵导游词(精选5篇)  导读:南京中山陵美不胜收,远远望去,一大面山,郁郁葱葱。下面是小编整...
烟台的海导游词 烟台的海导游词15篇  作为一名专门为游客提供帮助的导游,很有必要精心设计一份导游词,导游词具有极强...
天津市古文化街导游词 天津市古文化街导游词  来自××的朋友大家好!  首先我代表青年旅行社欢迎各...
杭州西湖中英文导游词 杭州西湖中英文导游词  杭州西湖的导游词怎么写?下面小编为大家推荐2篇中英文的范文,希望对大家有帮助...
西安秦始皇兵马俑博物馆导游词 西安秦始皇兵马俑博物馆导游词  一篇完整的导游词,其结构一般包括习惯用语、概括介绍、重点讲解三个部分...
杭州山沟沟概况导游词 杭州山沟沟概况导游词  作为一名默默奉献的导游,总归要编写导游词,导游词作为一种解说的文体,它的作用...
我是大连小导游作文共60篇 我是大连小导游作文 第一篇亲爱的朋友们,旅途辛苦了,欢迎来到我的家乡—福州永泰,我是今天的小导游,大...
呼和浩特大昭寺导游词 呼和浩特大昭寺导游词  大昭寺成为藏式宗教建筑的千古典范,是旅游的胜地,吸引了很多游客来参观,导游要...
逍遥津导游词 逍遥津导游词位于合肥市旧城的东北角,是一座约20万平方米的城市公园。逍遥津古为淝水上的一个津渡。公园...
导游词开场白 导游词开场白导游词开场白有一句广告词说:心随我动,沟通无限,那我与在座各位朋友的沟通就从我的自我介绍...
苏州盘门三景导游词 苏州盘门三景导游词范例  苏州历史文化名城遐迩闻名在于她的历史悠久、人文荟萃、风景优美。盘门景区位于...
游长城导游词 游长城导游词  长城是世界七大奇迹之一。它像一条巨龙盘踞在中国北方的辽阔的土地上。它是中国古代劳动人...
颐和园导游词400字 颐和园导游词400字  一、颐和园简介  颐和园,中国清朝时期皇家园林,前身为清漪园,坐落在北京西郊...
辽宁省五女山导游词 辽宁省五女山导游词  作为一名具备丰富知识的导游,时常需要用到导游词,导游词的主要特点是口语化,此外...
介绍平遥古城导游词 介绍平遥古城导游词(通用15篇)  作为一位杰出的导游,往往需要进行导游词编写工作,导游词是导游员进...
太乙洞导游词 太乙洞导游词1、[洞口太乙神像]亲爱的游客,大家好!热烈欢迎观光!我们太乙洞有360万年历史,主洞全...
沈阳故宫导游词 沈阳故宫导游词  作为一名专门为游客提供帮助的导游,就有可能用到导游词,导游词具有注重口语化、精简凝...
广化寺导游词 广化寺导游词  广化寺,又称莆田南山广化寺,大家不妨来看看小编推送的广化寺导游词,希望给大家带来帮助...
学校的导游词 学校的导游词  作为一名专门引导游客、助人为乐的导游,就不得不需要编写导游词,导游词事实上是一种对旅...