dgettext

(PHP 4, PHP 5, PHP 7, PHP 8)

dgettext — Override the current domain

Description

function dgettext(string $domain, string $message): string

The dgettext() function allows you to override the current domain for a single message lookup.

Parameters

domain: The domain
message: The message

Return Values

A string on success.

Errors/Exceptions

Throws a ValueError if domain is the empty string or longer than 1024 bytes.

Throws a ValueError if message is longer than 4096 bytes.

Changelog

Version	Description
8.4.0	Now throws a ValueError if `domain` is the empty string.
8.0.0	Now throws a ValueError if an argument is too long. Previously, an `E_WARNING` was raised and `false` was returned.

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

viral at noeticsolutions dot com ¶

20 years ago

While using this function, remember to call bindtextdomain for as many domains as you want to use in your application.  For example, if I have module1 and module2 as 2 separate domains in the same application, you can do the following:

bindtextdomain("module1", "//path/to/my/locale/folder");
bindtextdomain("module2", "//path/to/my/locale/folder");
textdomain("module1");

echo _("Label1"); // this call will get the message from module1
echo dgettext("module2", "Label1"); // this call will get the message from module2

===
Viral Shah