dcngettext

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

dcngettext — Plural version of dcgettext

Description

function dcngettext(
    string $domain,
    string $singular,
    string $plural,
    int $count,
    int $category
): string

This function allows you to override the current domain for a single plural message lookup.

Parameters

domain

The domain

singular

plural

count

category

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 singular or plural is longer than 4096 bytes.

Throws a ValueError if category is LC_ALL.

Changelog

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

See Also