conv 子例程
用途
转换字符。
库
标准 C 库 (libc.a)
语法
#include <ctype.h> int Character;
int tolower (Character)
int Character;
int _toupper (Character)
int Character;
int _tolower (Character)
int Character;
int toascii (Character)
int Character;
int NCesc ( Pointer, CharacterPointer)
NLchar *Pointer;
char *CharacterPointer;
int NCtoupper ( Xcharacter)
int Xcharacter;
int NCtolower (Xcharacter)
int Xcharacter;
int _NCtoupper (Xcharacter)
int Xcharacter;
int _NCtolower (Xcharacter)
int Xcharacter;
int NCtoNLchar (Xcharacter)
int Xcharacter;
int NCunesc (CharacterPointer, Pointer)
char *CharacterPointer;
NLchar *Pointer;
int NCflatchr (Xcharacter)
int Xcharacter;
描述
toupper和tolower子程序的域为int,可表示为无符号字符或EOF 的值:-1到 255。
如果 toupper 子例程的参数表示小写字母,并且有相应的大写字母 (如 LC_CTYPE所定义) ,那么结果是相应的大写字母。 如果 tolower 子例程的参数表示大写字母,并且存在相应的小写字母 (如 LC_CTYPE所定义) ,那么结果是相应的小写字母。 域中的所有其他值将保持不变返回。 如果未在当前语言环境中定义大小写转换信息,那么这些子例程将根据 "C" 语言环境确定字符大小写。
_toupper 和 _tolower 子例程完成与 toupper 和 tolower 子例程相同的任务,但它们具有受限域。 _toupper 例程需要一个小写字母作为其参数; 其结果是相应的大写字母。 _tolower 例程需要大写字母作为其参数; 其结果是相应的小写字母。 域外的值会导致未定义的结果。
NCxxxxxx 子例程将所有字符 (包括扩展字符) 转换为代码点。 其他子例程仅转换传统 ASCII 字符。 NCxxxxxx 子例程已过时,如果涉及可移植性和未来兼容性,那么不应使用这些子例程。
Xcharacter 参数的值位于任何合法 NLchar 数据类型的域中。 它还可以有一个特殊值-1,代表文件结束(EOF)。
如果 NCtoupper 子例程的参数根据当前整理顺序配置表示小写字母,那么结果是相应的大写字母。 如果 NCtolower 子例程的参数根据当前整理顺序配置表示大写字母,那么结果是相应的小写字母。 域中的所有其他值将保持不变返回。
_NCtoupper 和 _NCtolower 例程是与 NCtoupper 和 NCtolower 子例程执行相同功能的宏,但具有受限域并且速度更快。 _NCtoupper 宏需要一个小写字母作为其参数; 其结果是相应的大写字母。 _NCtolower 宏需要大写字母作为其参数; 其结果是相应的小写字母。 域外的值会导致未定义的结果。
NCtoNLchar 子例程生成其参数的值,并且关闭了不属于 NLchar 数据类型的所有位。
NCesc 子例程将 Pointer 参数的 NLchar 值转换为存储在 CharacterPointer 参数指向的字符数组中的一个或多个 ASCII 字节。 如果 NLchar 数据类型表示扩展字符,那么会将其转换为唯一标识扩展字符的可打印 ASCII 转义序列。 NCesc 返回其写入的字节数。 显示符号表列出每个字符的转义序列。
相反的转换由 NCunesc 宏执行,该宏将从 CharacterPointer 开始的普通 ASCII 字节或转义序列转换为位于 Pointer的单个 NLchar 。 NCunesc 返回它读取的字节数。
NCflatchr 子例程将其参数值转换为与外观上的参数字符最相似的单个 ASCII 字节。 如果不存在 ASCII 等效项,那么它会将参数值转换为? (问号)。
参数
| 项 | 描述 |
|---|---|
| 字符 | 指定要转换的字符。 |
| Xcharacter | 指定要转换的 NLchar 值。 |
| CharacterPointer | 指定指向单字节字符数组的指针。 |
| POINTER | 指定指向转义序列的指针。 |