函数

PangoScriptget_sample_language

since: 1.4

声明 [src]

PangoLanguage*
pango_script_get_sample_language (
  PangoScript script
)

描述 [src]

找到一个代表 script 的语言标签。

该语言通常是使用该脚本书写的最广泛的语言：例如，对于 PANGO_SCRIPT_CYRILLIC 的示例语言是 ru（俄语），对于 PANGO_SCRIPT_ARABIC 的示例语言是 ar。

对于某些脚本，可能不会返回示例语言，因为没有足够代表性的语言。最好的例子是 PANGO_SCRIPT_HAN，其中不同的书写汉语、日语和朝鲜语的变体使用了显著不同的汉字集合和共享字符的形式。很多历史脚本也无法提供示例语言。

截至 1.18，此函数首先检查环境变量 PANGO_LANGUAGE 和 LANGUAGE（按此顺序检查）。如果其中一个被设置，它会被解析为一个由冒号或其他分隔符分隔的语言标签列表。此函数将返回 Pango 认为可能使用 script 进行书写的解析列表中的第一个语言。此最后的谓词是使用 pango_language_includes_script() 测试的。这可以用来控制 Pango 的非主要语言的字体选择。例如，将 PANGO_LANGUAGE 环境变量设置为 “en:fa” 时，当在非阿拉伯文文本中找到一个阿拉伯文文本段时，Pango 将选择适用于波斯语（fa）而不是阿拉伯语（ar）的字体。相同的技巧可以在无法设置上下文语言时为 PANGO_SCRIPT_HAN 选择默认语言。

Available since: 1.4

参数

script

类型： PangoScript

A PangoScript。

返回值

类型： PangoLanguage

A PangoLanguage that is representative of the script.

函数的调用者负责数据的所有权，并负责释放它。

返回值可以是 NULL。