wstring 子例程

用途

对宽字符字符串执行操作。

库

标准 C 库 (libc.a)

语法

描述

字符串 子例程会复制，比较和追加内存中的字符串，并确定内存中字符串的位置，大小和存在性。 对于这些子例程，字符串是由 wchar_t 个字符组成的数组，以空字符结尾。 字符串 子例程与 串 子例程并行，但对类型为 wchar_t 而不是 字符的字符串进行操作，但以下特别说明的情况除外。

参数 XString1， XString2和 XString 指向类型为 wchar_t 的字符串 (以 wchar_t 空字符结尾的 世界 个字符的数组)。

子例程 世界， 弗斯特恩卡特， 韦斯特奇皮和 韦斯特恩皮 都将改变 XString1 参数。 他们不会检查 XString1所指向的数组是否溢出。 所有字符串移动都是按宽字符执行的。 按预期向左侧工作重叠移动，但向右侧重叠移动可能产生意外结果。 所有这些子例程都在 wstring.h 文件中声明。

世界 子例程将 XString2 参数所指向的 wchar_t 字符串的副本追加到 XString1 参数所指向的 wchar_t 字符串的末尾。 世界 子例程返回指向以 null 结束的结果的指针。

弗斯特恩卡特 子例程最多将 XString2 参数中 wchar _ t 个字符的 数字 参数的值复制到 XString1 参数所指向的 wchar_t 字符串的末尾。 如果在 XString2 参数指向的字符串中迂到空字符，那么复制将在 数字 wchar_t 字符之前停止。 弗斯特恩卡特 子例程返回指向以 null 结束的结果的指针。

韦斯特峰 子例程按字典顺序将 XString1 参数所指向的 wchar_t 字符串与 XString2 参数所指向的 wchar_t 字符串进行比较。 韦斯特峰 子例程返回的值为:

• 如果 XString1 0 XString2 ，那么小于 0
• 0 如果 XString1 等于 XString2 ，那么等于 0
• 如果 XString1 大于 XString2 ，那么大于 0

韦斯特恩峰 子例程与 韦斯特峰进行相同的比较，但它最多会比较 世界 字符对的 数字 参数的值。 这些比较基于由语言环境类别 LC_COLLATE 和 LANG 变量所确定的整理值。

韦斯特奇皮 子例程将 XString2 参数所指向的字符串复制到 XString1 参数所指向的数组中。 复制 wchar_t 空值时，复制将停止。 韦斯特奇皮 子例程将返回 XString1 参数的值。

韦斯特恩皮 子例程将 数字 参数的值 ( wchar_t 个字符) 从 XString2 参数指向的字符串复制到 XString1 参数指向的 世界_特 数组。 如果 XString2 长度小于 数字 wchar_t 个字符，那么 韦斯特恩皮 填充 XString1 尾部空字符以填充 数字 wchar_t 个字符。 如果 XString2 的长度为 数字 或更多 wchar_t 个字符，那么仅复制前 数字 wchar_t 个字符; 结果不会以空字符终止。 韦斯特恩皮 子例程将返回 XString1 参数的值。

韦斯特伦 子例程返回 XString 参数所指向的字符串中的 wchar_t 个字符的数目，不包括终止 wchar_t null。

韦斯特赫尔 子例程返回一个指针，该指针指向 XString 参数所指向的 wchar_t 字符串中 数字 参数指定的 wchar_t 的第一次出现。 如果在 wchar_t 字符串中未出现 wchar_t ，那么将返回空指针。 用于终止字符串的 wchar_t 空值被视为 wchar_t 字符串的一部分。

韦斯特尔河 子例程返回一个指针，该指针指向由 XString 参数指向的 wchar_t 字符串中 数字 参数指定的字符的最后一次出现。 如果在 wchar_t 字符串中未出现 wchar_t ，那么将返回空指针。 用于终止字符串的 wchar_t 空值被视为 wchar_t 字符串的一部分。

韦斯特普布尔克 子例程返回一个指针，该指针指向 XString2 参数指向的字符串中任何代码点的 XString1 参数所指向的 wchar_t 字符串中的第一次出现。 如果没有任何字符匹配，那么将返回空指针。

韦斯特斯普恩 子例程返回由 XString1 参数指向的字符串的初始段的长度，该字符串完全由 XString2 参数指向的 wchar_t 字符串中的代码点组成。

韦斯特茨普恩 子例程返回 XString1 参数所指向的 wchar_t 字符串的初始段的长度，该字符串完全由 XString2 参数所指向的 wchar_t 字符串中的代码点 不 组成。

韦斯特托克 子例程返回一个指针，该指针指向 XString1 参数所指向的字符串中出现的文本标记。 XString2 参数将一组代码点指定为标记定界符。 如果 XString1 参数不是空值，那么 韦斯特托克 子例程将读取 XString1 参数指向的字符串，直到它找到 XString2 参数指定的其中一个定界符代码点为止。 然后，它将 wchar_t null 存储到 wchar_t 字符串中，替换定界符代码点，并返回指向文本标记的第一个 wchar_t 的指针。 韦斯特托克 子例程跟踪其在 wchar_t 字符串中的位置，以便后续使用空 XString1 参数的调用通过 wchar_t 字符串进行单步执行。 对于对 韦斯特托克的后续调用，可以更改 XString2 参数指定的定界符。 当 XString1 参数指向的 wchar_t 字符串中不存在任何标记时， 韦斯特托克 子例程将返回空指针。

世界 子例程返回一个指向 wchar_t 字符串的指针，该字符串是 XString1 参数指向的 wchar_t 字符串的重复项。 新字符串的空间是使用 马洛克 子例程分配的。 当无法创建新字符串时，会返回空指针。