wiki.techinc.nl/includes/language/LanguageConverterIcu.php
Reedy 40f7d7632a Language: minor cleanup
* Remove unnecessary duplicate documentation
* Code tweaks

Change-Id: I9c8c190bee58195eace08cba18a51e4572896ef7
2023-10-02 13:34:11 +00:00

100 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.
*
* @return array
*/
protected function loadDefaultTables(): array {
$tables = [];
foreach ( $this->getVariants() as $variant ) {
$tables[$variant] = new ReplacementArray();
}
return $tables;
}
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 the main variant.
*
* @return string[]
*/
protected function getTransliteratorAliases() {
return [];
}
}