aboutsummaryrefslogtreecommitdiffhomepage
path: root/vendor/symfony/intl/Symfony/Component/Intl/ResourceBundle/CurrencyBundleInterface.php
blob: 1a88e93722055535aaa5e311376011f0437ecc42 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Intl\ResourceBundle;

/**
 * Gives access to currency-related ICU data.
 *
 * @author Bernhard Schussek <bschussek@gmail.com>
 */
interface CurrencyBundleInterface extends ResourceBundleInterface
{
    /**
     * Returns the symbol used for a currency.
     *
     * @param string $currency A currency code (e.g. "EUR").
     * @param string $locale   Optional. The locale to return the result in.
     *                         Defaults to {@link \Locale::getDefault()}.
     *
     * @return string|null The currency symbol or NULL if not found.
     */
    public function getCurrencySymbol($currency, $locale = null);

    /**
     * Returns the name of a currency.
     *
     * @param string $currency A currency code (e.g. "EUR").
     * @param string $locale   Optional. The locale to return the name in.
     *                         Defaults to {@link \Locale::getDefault()}.
     *
     * @return string|null The name of the currency or NULL if not found.
     */
    public function getCurrencyName($currency, $locale = null);

    /**
     * Returns the names of all known currencies.
     *
     * @param string $locale Optional. The locale to return the names in.
     *                       Defaults to {@link \Locale::getDefault()}.
     *
     * @return string[] A list of currency names indexed by currency codes.
     */
    public function getCurrencyNames($locale = null);

    /**
     * Returns the number of digits after the comma of a currency.
     *
     * @param string $currency A currency code (e.g. "EUR").
     *
     * @return integer|null The number of digits after the comma or NULL if not found.
     */
    public function getFractionDigits($currency);

    /**
     * Returns the rounding increment of a currency.
     *
     * The rounding increment indicates to which number a currency is rounded.
     * For example, 1230 rounded to the nearest 50 is 1250. 1.234 rounded to the
     * nearest 0.65 is 1.3.
     *
     * @param string $currency A currency code (e.g. "EUR").
     *
     * @return float|integer|null The rounding increment or NULL if not found.
     */
    public function getRoundingIncrement($currency);
}