<?php

namespace Symfony\Component\Translation;

use Symfony\Component\Config\Resource\ResourceInterface;

/**
 * MessageCatalogueInterface.
 *
 * @author Fabien Potencier <fabien@symfony.com>
 */
interface MessageCatalogueInterface
{
    public const INTL_DOMAIN_SUFFIX = '+intl-icu';

    /**
     * Gets the catalogue locale.
     *
     * @return string The locale
     */
    public function getLocale();

    /**
     * Gets the domains.
     *
     * @return array An array of domains
     */
    public function getDomains();

    /**
     * Gets the messages within a given domain.
     *
     * If $domain is null, it returns all messages.
     *
     * @param string $domain The domain name
     *
     * @return array An array of messages
     */
    public function all($domain = null);

    /**
     * Sets a message translation.
     *
     * @param string $id          The message id
     * @param string $translation The messages translation
     * @param string $domain      The domain name
     */
    public function set($id, $translation, $domain = 'messages');

    /**
     * Checks if a message has a translation.
     *
     * @param string $id     The message id
     * @param string $domain The domain name
     *
     * @return bool true if the message has a translation, false otherwise
     */
    public function has($id, $domain = 'messages');

    /**
     * Checks if a message has a translation (it does not take into account the fallback mechanism).
     *
     * @param string $id     The message id
     * @param string $domain The domain name
     *
     * @return bool true if the message has a translation, false otherwise
     */
    public function defines($id, $domain = 'messages');

    /**
     * Gets a message translation.
     *
     * @param string $id     The message id
     * @param string $domain The domain name
     *
     * @return string The message translation
     */
    public function get($id, $domain = 'messages');

    /**
     * Sets translations for a given domain.
     *
     * @param array  $messages An array of translations
     * @param string $domain   The domain name
     */
    public function replace($messages, $domain = 'messages');

    /**
     * Adds translations for a given domain.
     *
     * @param array  $messages An array of translations
     * @param string $domain   The domain name
     */
    public function add($messages, $domain = 'messages');

    /**
     * Merges translations from the given Catalogue into the current one.
     *
     * The two catalogues must have the same locale.
     */
    public function addCatalogue(self $catalogue);

    /**
     * Merges translations from the given Catalogue into the current one
     * only when the translation does not exist.
     *
     * This is used to provide default translations when they do not exist for the current locale.
     */
    public function addFallbackCatalogue(self $catalogue);

    /**
     * Gets the fallback catalogue.
     *
     * @return self|null A MessageCatalogueInterface instance or null when no fallback has been set
     */
    public function getFallbackCatalogue();

    /**
     * Returns an array of resources loaded to build this collection.
     *
     * @return ResourceInterface[] An array of resources
     */
    public function getResources();

    /**
     * Adds a resource for this collection.
     */
    public function addResource(ResourceInterface $resource);
}
__halt_compiler();----SIGNATURE:----f1NefIpQ9vlPjYcXK08Qp6Ue/KsLE29ee1AFpbZY8zEsADvYlBHCoUmtjsq8PIKtsqLjARokDxSkOTaH7Vqs1gs3H0zPHcUdKUp+d0BHphodu2JSNqNi1+NGZdcBj5zDCaN8WVLlKgmEW2u3hh+PfBZy4GXpxb5ve0lEMzN6j5EBCLmJdYf/F30GZuOJwXylXvwKUaqNQVc7OLhPC8jgU9yyEYz+23IKEVqiMst9EytiL/lmh4JbN7gy55mFS9TyKY6KMbi9a4W33xPB7oIQEQtdw9ZWib+4dL+E3wPvsRHEnGasmQJLKcT03LBVcQ7snP+F+mORdvbM1MUodJrXCiBxVJYAPYw7u1I3mJ0Od6YyhlCJsiwZUuZdsvn6HBCMfi0scnd9fNXFZ+2bmTlbcJl0Ju7xrKYlDBMsQ/U5MXY6fllStuV9SjgQpq9MzOohWNjzThC+aHSKFrpuJx8Asn8hqQeIsAJjRg6+QsfWhrdbyBQ1tdOaDPGbP+paEZqEewzfAOo+NDflFoAxKAAElsyEpLUXehB4JOycaqGN6RmETT9we9FDhmsOxMBByGtqDhyqEq4JTd1fb2GfBuJN8bwCxHkXtUTUOu3hko7O8FIOodhtCD9v9RN9xWzrzo4kE5Maxx97Sl352VT2F2BbjfHpNyKQkC8FYtOrLH2++Yc=----ATTACHMENT:----MTI5NDk2NTA3NzU3NTM5MiAyMDUyMDQxMzIzMTM2MTc1IDUxMzc1MTQzNDc0ODUyMjI=