class PoItem

Same name in other branches
  1. 9 core/lib/Drupal/Component/Gettext/PoItem.php \Drupal\Component\Gettext\PoItem
  2. 8.9.x core/lib/Drupal/Component/Gettext/PoItem.php \Drupal\Component\Gettext\PoItem
  3. 11.x core/lib/Drupal/Component/Gettext/PoItem.php \Drupal\Component\Gettext\PoItem

PoItem handles one translation.

@todo This class contains some really old legacy code.

Hierarchy

  • class \Drupal\Component\Gettext\PoItem

Expanded class hierarchy of PoItem

See also

https://www.drupal.org/node/1637662

16 files declare their use of PoItem
locale.module in core/modules/locale/locale.module
Enables the translation of the user interface to languages other than English.
LocaleJavascriptTranslationTest.php in core/modules/locale/tests/src/Functional/LocaleJavascriptTranslationTest.php
LocaleLocaleLookupTest.php in core/modules/locale/tests/src/Functional/LocaleLocaleLookupTest.php
LocaleLookup.php in core/modules/locale/src/LocaleLookup.php
LocaleLookupTest.php in core/modules/locale/tests/src/Unit/LocaleLookupTest.php

... See full list

File

core/lib/Drupal/Component/Gettext/PoItem.php, line 11

Namespace

Drupal\Component\Gettext
View source
class PoItem {
    
    /**
     * The delimiter used to split plural strings.
     *
     * This is the ETX (End of text) character and is used as a minimal means to
     * separate singular and plural variants in source and translation text. It
     * was found to be the most compatible delimiter for the supported databases.
     */
    const DELIMITER = "\x03";
    
    /**
     * The language code this translation is in.
     *
     * @var string
     */
    protected $langcode;
    
    /**
     * The context this translation belongs to.
     *
     * @var string
     */
    protected $context = '';
    
    /**
     * The source string or array of strings if it has plurals.
     *
     * @var string|array
     *
     * @see $plural
     */
    protected $source;
    
    /**
     * Flag indicating if this translation has plurals.
     *
     * @var bool
     */
    protected $plural;
    
    /**
     * The comment of this translation.
     *
     * @var string
     */
    protected $comment;
    
    /**
     * The translation string or array of strings if it has plurals.
     *
     * @var string|array
     * @see $plural
     */
    protected $translation;
    
    /**
     * Gets the language code of the currently used language.
     *
     * @return string with langcode
     */
    public function getLangcode() {
        return $this->langcode;
    }
    
    /**
     * Set the language code of the current language.
     *
     * @param string $langcode
     *   The language code of the current language.
     */
    public function setLangcode($langcode) {
        $this->langcode = $langcode;
    }
    
    /**
     * Gets the context this translation belongs to.
     *
     * @return string $context
     */
    public function getContext() {
        return $this->context;
    }
    
    /**
     * Set the context this translation belongs to.
     *
     * @param string $context
     *   The context this translation belongs to.
     */
    public function setContext($context) {
        $this->context = $context;
    }
    
    /**
     * Gets the source string(s) if the translation has plurals.
     *
     * @return string|array
     *   The source string or array of strings if it has plurals.
     */
    public function getSource() {
        return $this->source;
    }
    
    /**
     * Sets the source string(s) if the translation has plurals.
     *
     * @param string|array $source
     *   The source string or the array of strings if the translation has plurals.
     */
    public function setSource($source) {
        $this->source = $source;
    }
    
    /**
     * Gets the translation string(s) if the translation has plurals.
     *
     * @return string|array
     *   The translation string or array of strings if it has plurals.
     */
    public function getTranslation() {
        return $this->translation;
    }
    
    /**
     * Sets the translation string(s) if the translation has plurals.
     *
     * @param string|array $translation
     *   The translation string or the array of strings if the translation has
     *   plurals.
     */
    public function setTranslation($translation) {
        $this->translation = $translation;
    }
    
    /**
     * Set if the translation has plural values.
     *
     * @param bool $plural
     *   TRUE, if the translation has plural values. FALSE otherwise.
     */
    public function setPlural($plural) {
        $this->plural = $plural;
    }
    
    /**
     * Get if the translation has plural values.
     *
     * @return bool
     */
    public function isPlural() {
        return $this->plural;
    }
    
    /**
     * Gets the comment of this translation.
     *
     * @return String $comment
     */
    public function getComment() {
        return $this->comment;
    }
    
    /**
     * Set the comment of this translation.
     *
     * @param string $comment
     *   The comment of this translation.
     */
    public function setComment($comment) {
        $this->comment = $comment;
    }
    
    /**
     * Create the PoItem from a structured array.
     *
     * @param array $values
     *   A structured array to create the PoItem from.
     */
    public function setFromArray(array $values = []) {
        if (isset($values['context'])) {
            $this->setContext($values['context']);
        }
        if (isset($values['source'])) {
            $this->setSource($values['source']);
        }
        if (isset($values['translation'])) {
            $this->setTranslation($values['translation']);
        }
        if (isset($values['comment'])) {
            $this->setComment($values['comment']);
        }
        if (isset($this->source) && str_contains($this->source, self::DELIMITER)) {
            $this->setSource(explode(self::DELIMITER, $this->source));
            $this->setTranslation(explode(self::DELIMITER, $this->translation ?? ''));
            $this->setPlural(count($this->source) > 1);
        }
    }
    
    /**
     * Output the PoItem as a string.
     */
    public function __toString() {
        return $this->formatItem();
    }
    
    /**
     * Format the POItem as a string.
     */
    private function formatItem() {
        $output = '';
        // Format string context.
        if (!empty($this->context)) {
            $output .= 'msgctxt ' . $this->formatString($this->context);
        }
        // Format translation.
        if ($this->plural) {
            $output .= $this->formatPlural();
        }
        else {
            $output .= $this->formatSingular();
        }
        // Add one empty line to separate the translations.
        $output .= "\n";
        return $output;
    }
    
    /**
     * Formats a plural translation.
     */
    private function formatPlural() {
        $output = '';
        // Format source strings.
        $output .= 'msgid ' . $this->formatString($this->source[0]);
        $output .= 'msgid_plural ' . $this->formatString($this->source[1]);
        foreach ($this->translation as $i => $trans) {
            if (isset($this->translation[$i])) {
                $output .= 'msgstr[' . $i . '] ' . $this->formatString($trans);
            }
            else {
                $output .= 'msgstr[' . $i . '] ""' . "\n";
            }
        }
        return $output;
    }
    
    /**
     * Formats a singular translation.
     */
    private function formatSingular() {
        $output = '';
        $output .= 'msgid ' . $this->formatString($this->source);
        $output .= 'msgstr ' . (isset($this->translation) ? $this->formatString($this->translation) : '""');
        return $output;
    }
    
    /**
     * Formats a string for output on multiple lines.
     */
    private function formatString($string) {
        // Escape characters for processing.
        $string = addcslashes($string, "\x00..\x1f\\\"");
        // Always include a line break after the explicit \n line breaks from
        // the source string. Otherwise wrap at 70 chars to accommodate the extra
        // format overhead too.
        $parts = explode("\n", wordwrap(str_replace('\\n', "\\n\n", $string), 70, " \n"));
        // Multiline string should be exported starting with a "" and newline to
        // have all lines aligned on the same column.
        if (count($parts) > 1) {
            return "\"\"\n\"" . implode("\"\n\"", $parts) . "\"\n";
        }
        else {
            return "\"{$parts[0]}\"\n";
        }
    }

}

Members

Title Sort descending Modifiers Object type Summary
PoItem::$comment protected property The comment of this translation.
PoItem::$context protected property The context this translation belongs to.
PoItem::$langcode protected property The language code this translation is in.
PoItem::$plural protected property Flag indicating if this translation has plurals.
PoItem::$source protected property The source string or array of strings if it has plurals.
PoItem::$translation protected property The translation string or array of strings if it has plurals.
PoItem::DELIMITER constant The delimiter used to split plural strings.
PoItem::formatItem private function Format the POItem as a string.
PoItem::formatPlural private function Formats a plural translation.
PoItem::formatSingular private function Formats a singular translation.
PoItem::formatString private function Formats a string for output on multiple lines.
PoItem::getComment public function Gets the comment of this translation.
PoItem::getContext public function Gets the context this translation belongs to.
PoItem::getLangcode public function Gets the language code of the currently used language.
PoItem::getSource public function Gets the source string(s) if the translation has plurals.
PoItem::getTranslation public function Gets the translation string(s) if the translation has plurals.
PoItem::isPlural public function Get if the translation has plural values.
PoItem::setComment public function Set the comment of this translation.
PoItem::setContext public function Set the context this translation belongs to.
PoItem::setFromArray public function Create the PoItem from a structured array.
PoItem::setLangcode public function Set the language code of the current language.
PoItem::setPlural public function Set if the translation has plural values.
PoItem::setSource public function Sets the source string(s) if the translation has plurals.
PoItem::setTranslation public function Sets the translation string(s) if the translation has plurals.
PoItem::__toString public function Output the PoItem as a string.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.