W3cubDocs

/WordPress

_c( string $text, string $domain = ‘default’ ): string

Retrieve translated string with vertical bar context

Description

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.

See also

Parameters

$textstringrequired
Text to translate.
$domainstringoptional
Domain to retrieve the translated text.

Default:'default'

Return

string Translated context string without pipe.

Source

function _c( $text, $domain = 'default' ) {
	_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
	return before_last_bar( translate( $text, $domain ) );
}

Changelog

Version Description
2.9.0 Use _x()
2.2.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/_c