_c()WP 2.2.0

Deprecated from version 2.9.0. It is no longer supported and can be removed in future releases. Use _x() instead.

Retrieve translated string with vertical bar context

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.

No Hooks.

Return

String. Translated context string without pipe.

Usage

_c( $text, $domain );
$text(string) (required)
Text to translate.
$domain(string)
Domain to retrieve the translated text.
Default: 'default'

Notes

  • See: _x()

Changelog

Since 2.2.0 Introduced.
Deprecated since 2.9.0 Use _x()

_c() code WP 6.7.1

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