API15:JLanguage/

This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.

Description

Translate function, mimics the php gettext (alias _) function

<! removed transcluded page call, red link never existed >

Syntax

_($string, $jsSafe=false)

Parameter Name	Default Value	Description
$string		$string The string to translate
$jsSafe	false	$jsSafe Make the result javascript safe

Returns

string The translation of the string

Defined in

libraries/joomla/language/language.php

Importing

jimport( 'joomla.language.language' );

Source Body

function _($string, $jsSafe = false)
{
        //$key = str_replace( ' ', '_', strtoupper( trim( $string ) ) );echo '<br />'.$key;
        $key = strtoupper($string);
        $key = substr($key, 0, 1) == '_' ? substr($key, 1) : $key;
 
        if (isset ($this->_strings[$key]))
        {
                $string = $this->_debug ? "&bull;".$this->_strings[$key]."&bull;" : $this->_strings[$key];
 
                // Store debug information
                if ( $this->_debug )
                {
                        $caller = $this->_getCallerInfo();
 
                        if ( ! array_key_exists($key, $this->_used ) ) {
                                $this->_used[$key] = array();
                        }
 
                        $this->_used[$key][] = $caller;
                }
 
        }
        else
        {
                if (defined($string))
                {
                        $string = $this->_debug ? '!!'.constant($string).'!!' : constant($string);
 
                        // Store debug information
                        if ( $this->_debug )
                        {
                                $caller = $this->_getCallerInfo();
 
                                if ( ! array_key_exists($key, $this->_used ) ) {
                                        $this->_used[$key] = array();
                                }
 
                                $this->_used[$key][] = $caller;
                        }
                }
                else
                {
                        if ($this->_debug)
                        {
                                $caller = $this->_getCallerInfo();
                                $caller['string'] = $string;
 
                                if ( ! array_key_exists($key, $this->_orphans ) ) {
                                        $this->_orphans[$key] = array();
                                }
 
                                $this->_orphans[$key][] = $caller;
 
                                $string = '??'.$string.'??';
                        }
                }
        }
 
        if ($jsSafe) {
                $string = addslashes($string);
        }
 
        return $string;
}

<! removed transcluded page call, red link never existed >

Examples

<CodeExamplesForm />