功能

GLibmarkup_escape_text

声明 [src]

gchar*
g_markup_escape_text (
  const gchar* text,
  gssize length
)

说明 [src]

转义文本,以便标记解析器逐字逐句地解析它。小于、大于、与号(&)等符号被替换为相应的实体。此功能通常用于写出要由标记解析器解析的文件时。

请注意,此功能不会阻止空格和换行符根据行尾归一化和属性值的 XML 规则进行处理。

还要注意,此功能将为范围内的所有控制序列(制表符、换行符和回车符除外)产生字符引用 … 。此范围内的字符引用在 XML 1.0 中无效,但在 XML 1.1 中有效,并且 GMarkup 解析器将接受它们。

参数

文本

类型: const gchar*

一些有效的 UTF-8 文本。

数据归函数的调用者所有。
该值是空终止的 UTF-8 字符串。
长度

类型: gssize

text 的长度(以字节为单位),如果文本为 null 终止,则为 -1。

返回值

类型: gchar*

一个转义后的文本的新分配的字符串。

函数的调用者拥有数据的所有权,并负责释放它。
该值是空终止的 UTF-8 字符串。