_c()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
_c( string $text, string $domain = 'default' ): stringОписание
Довольно часто возникают коллизии, когда одинаковый переводимый текст встречается более чем в двух местах, но с разным контекстом перевода.
Чтобы использовать отдельные контексты, применяется функция _c(), а в переводимой строке используется вертикальная черта ('|'), указывающая контекст, в котором находится строка.
При возврате переведённой строки берётся всё, что стоит перед вертикальной чертой, не включая сам символ черты. Если в переведённом тексте нет вертикальной черты, возвращается весь текст.
См. also_x()
Оригинал (английский)
Quite a few times, there will be collisions with similar translatable text found in more than two places but with different translated context.
In order to use the separate contexts, the _c() function is used and the translatable string uses a pipe (‘|’) which has the context the string is in.
When the translated string is returned, it is everything before the pipe, not including the pipe character. If there is no pipe in the translated text then everything is returned.
Параметры
$text
string
обязательный
$domain
string
необязательный
= 'default'
Возвращаемое значение
string
Исходный код
wp-includes/deprecated.php:1776
function _c( $text, $domain = 'default' ) {
_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
return before_last_bar( translate( $text, $domain ) );
}История изменений
| Версия | Описание |
|---|---|
| 2.9.0 | Deprecated. Use _x() |
| 2.2.0 | Introduced. |
