wiki.techinc.nl/includes/language/LanguageConverterIcu.php
Peter Ovchyn d8f54cae8b Language: Turn public properties into Getters in LanguageConverter based hierarchy
The main goal is to simplify the construction of the LanguageConverter and
avoid using constructors for derived classes.

In order to hard-deprecate removed property, DeprecationHelper::deprecatePublicPropertyFallback
was introduced.

Bug: T253834
Change-Id: Ib167982e4e872cfdf0fbcb78b7ca597f5ac8d60a
2021-02-03 15:17:42 +02:00

97 lines
2.7 KiB
PHP

<?php
/**
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
/**
* A class that extends LanguageConverterSpecific for converts that use
* ICU rule-based transliterators.
*
* @ingroup Language
*/
abstract class LanguageConverterIcu extends LanguageConverterSpecific {
/**
* @var Transliterator[]
*/
protected $mTransliterators;
/**
* Creates empty tables. mTransliterators will be used instead.
*/
protected function loadDefaultTables() {
$this->mTables = [];
foreach ( $this->getVariants() as $variant ) {
$this->mTables[$variant] = new ReplacementArray();
}
}
public function translate( $text, $variant ) {
$text = parent::translate( $text, $variant );
if ( trim( $text ) ) {
$text = $this->icuTranslate( $text, $variant );
}
return $text;
}
/**
* Translate a string to a variant using ICU transliterator.
*
* @param string $text Text to convert
* @param string $variant Variant language code
* @return string Translated text
*/
public function icuTranslate( $text, $variant ) {
return $this->getTransliterators()[$variant]->transliterate( $text );
}
/**
* Get the array mapping variants to ICU transliteration rules.
* Subclasses must implement this.
*
* @return string[]
*/
abstract protected function getIcuRules();
/**
* Get the array mapping variants to ICU transliterators.
*
* @return Transliterator[]
*/
protected function getTransliterators() {
if ( $this->mTransliterators === null ) {
$this->mTransliterators = [];
foreach ( $this->getIcuRules() as $variant => $rule ) {
$this->mTransliterators[$variant] = Transliterator::createFromRules( $rule );
}
foreach ( $this->getTransliteratorAliases() as $alias => $variant ) {
$this->mTransliterators[$alias] = $this->mTransliterators[$variant];
}
}
return $this->mTransliterators;
}
/**
* Get the array mapping variant aliases to main variant.
*
* @return string[]
*/
protected function getTransliteratorAliases() {
return [];
}
}