Translation.php

Go to the documentation of this file.

<?php

namespace Gettext;

class Translation
{
    protected $context;
    protected $original;
    protected $translation = '';
    protected $plural;
    protected $pluralTranslation = array();
    protected $references = array();
    protected $comments = array();
    protected $extractedComments = array();
    protected $flags = array();
    protected $translationCount;

    public static function generateId($context, $original)
    {
        return "{$context}\004{$original}";
    }

    public function __construct($context, $original, $plural = '')
    {
        $this->context = (string) $context;
        $this->original = (string) $original;

        $this->setPlural($plural);
    }

    public function getClone($context = null, $original = null)
    {
        $new = clone $this;

        if ($context !== null) {
            $new->context = (string) $context;
        }

        if ($original !== null) {
            $new->original = (string) $original;
        }

        return $new;
    }

    public function getId()
    {
        return static::generateId($this->context, $this->original);
    }

    public function is($context, $original = '')
    {
        return (($this->context === $context) && ($this->original === $original)) ? true : false;
    }

    public function getOriginal()
    {
        return $this->original;
    }

    public function hasOriginal()
    {
        return ($this->original !== '') ? true : false;
    }

    public function setTranslation($translation)
    {
        $this->translation = (string) $translation;
    }

    public function getTranslation()
    {
        return $this->translation;
    }

    public function hasTranslation()
    {
        return ($this->translation !== '') ? true : false;
    }

    public function setPlural($plural)
    {
        $this->plural = (string) $plural;

        $this->normalizeTranslationCount();
    }

    public function getPlural()
    {
        return $this->plural;
    }

    public function hasPlural()
    {
        return ($this->plural !== '') ? true : false;
    }

    public function setPluralTranslation($plural, $key = 0)
    {
        $this->pluralTranslation[$key] = $plural;
        $this->normalizeTranslationCount();
    }

    public function getPluralTranslation($key = null)
    {
        if ($key === null) {
            return $this->pluralTranslation;
        }

        return isset($this->pluralTranslation[$key]) ? (string) $this->pluralTranslation[$key] : '';
    }

    public function hasPluralTranslation()
    {
        return implode('', $this->pluralTranslation) !== '';
    }

    public function deletePluralTranslation()
    {
        $this->pluralTranslation = array();

        $this->normalizeTranslationCount();
    }

    public function setTranslationCount($count)
    {
        $this->translationCount = is_null($count) ? null : intval($count);

        $this->normalizeTranslationCount();
    }

    public function getTranslationCount()
    {
        return $this->hasPlural() ? $this->translationCount : null;
    }

    protected function normalizeTranslationCount()
    {
        if ($this->translationCount === null) {
            return;
        }

        if ($this->hasPlural()) {
            $allowed = $this->translationCount - 1;
            $current = count($this->pluralTranslation);

            if ($allowed > $current) {
                $this->pluralTranslation = $this->pluralTranslation + array_fill(0, $allowed, '');
            } elseif ($current > $allowed) {
                $this->pluralTranslation = array_slice($this->pluralTranslation, 0, $allowed);
            }
        } else {
            $this->pluralTranslation = array();
        }
    }

    public function getContext()
    {
        return $this->context;
    }

    public function hasContext()
    {
        return (isset($this->context) && ($this->context !== '')) ? true : false;
    }

    public function addReference($filename, $line = null)
    {
        $key = "{$filename}:{$line}";
        $this->references[$key] = array($filename, $line);
    }

    public function hasReferences()
    {
        return !empty($this->references);
    }

    public function getReferences()
    {
        return array_values($this->references);
    }

    public function deleteReferences()
    {
        $this->references = array();
    }

    public function addComment($comment)
    {
        $this->comments[] = $comment;
    }

    public function hasComments()
    {
        return isset($this->comments[0]);
    }

    public function getComments()
    {
        return $this->comments;
    }

    public function deleteComments()
    {
        $this->comments = array();
    }

    public function addExtractedComment($comment)
    {
        $this->extractedComments[] = $comment;
    }

    public function hasExtractedComments()
    {
        return isset($this->extractedComments[0]);
    }

    public function getExtractedComments()
    {
        return $this->extractedComments;
    }

    public function deleteExtractedComments()
    {
        $this->extractedComments = array();
    }

    public function addFlag($flag)
    {
        $this->flags[] = $flag;
    }

    public function hasFlags()
    {
        return isset($this->flags[0]);
    }

    public function getFlags()
    {
        return $this->flags;
    }

    public function deleteFlags()
    {
        $this->flags = array();
    }

    public function mergeWith(Translation $translation, $method = null)
    {
        if ($method === null) {
            $method = Translations::$mergeDefault;
        }

        if (!$this->hasTranslation() || ($translation->hasTranslation() && ($method & Translations::MERGE_OVERRIDE))) {
            $this->setTranslation($translation->getTranslation());
        }

        if (($method & Translations::MERGE_PLURAL) && !$this->hasPlural()) {
            $this->setPlural($translation->getPlural());
        }

        if ($this->hasPlural() && !$this->hasPluralTranslation() && $translation->hasPluralTranslation()) {
            $this->pluralTranslation = $translation->getPluralTranslation();
        }

        if ($method & Translations::MERGE_REFERENCES) {
            foreach ($translation->getReferences() as $reference) {
                $this->addReference($reference[0], $reference[1]);
            }
        }

        if ($method & Translations::MERGE_COMMENTS) {
            $this->comments = array_values(array_unique(array_merge($translation->getComments(), $this->comments)));
            $this->extractedComments = array_values(array_unique(array_merge($translation->getExtractedComments(), $this->extractedComments)));
            $this->flags = array_values(array_unique(array_merge($translation->getFlags(), $this->flags)));
        }
    }
}