[函数]dgettext()函数—用法及示例

函数名称：dgettext()

函数描述：dgettext() 函数用于在指定的域中翻译一个字符串并返回结果。

用法：

string dgettext ( string $domain , string $message )

参数：

• $domain: 字符串，表示要翻译的域的名称。通常是一个 gettext 文本域。
• $message: 字符串，表示待翻译的消息。

返回值：

• 如果翻译成功，则返回翻译后的字符串；若翻译未找到，则返回原始的 $message 字符串。

示例：

<?php
  // 设定域为 "messages"
  $domain = "messages";

  // 设置域的整体路径
  bindtextdomain($domain, "./locale");

  // 指定当前使用的域
  textdomain($domain);

  // 翻译消息 "Hello World！"
  $translated_message = dgettext($domain, "Hello World!");

  // 显示翻译结果
  echo $translated_message;
?>

在上面的示例中，我们首先通过 bindtextdomain() 函数设置了域 "messages" 的路径。然后，通过 textdomain() 函数将当前使用的域设置为 "messages"。最后，使用 dgettext() 函数来翻译消息 "Hello World!"。如果找到了该翻译，则返回翻译后的字符串；否则，返回原始消息字符串。

注意：在使用 dgettext() 函数前，还需要使用 bindtextdomain() 和 textdomain() 函数来设置和指定要使用的域。