# A classe ResourceBundle

(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL intl >= 2.0.0)

## Introdução

Produtos de software específicos para localiades frequentemente requerem conjuntos de dados que devem ser customizados dependendo da localidade atual, ex.: mensagens, etiquetas, modelos de formatação. O mecanismo de recursos da ICU permite definir conjuntos de recursos que a aplicação pode carregar com base na localidade, enquanto acessa-as em uma maneira unificada, independente de localidade.

Esta classe implemente o acesso aos arquivos de dados de recursos ICU. Estes arquivos são arrays de dados binários que a ICU usa para armazenar os dados de localidade.

O pacote de recursos ICU pode ter recursos simples e complexos. Recursos complexos são contêineres que podem ser indexados com números inteiros ou strings (da mesma forma que arrays PHP). Recursos simples podem ser dos seguintes tipos: string, inteiro, campo de dado binário ou array inteiro.

ResourceBundle suporta acesso direto aos dados através de padrão de acesso a array e iteração através de foreach, assim como acesso por métodos de classe. O resultado será um valor PHP para os recursos simples e um objeto ResourceBundle para os complexos. Todos os recursos são somente-leitura.

## Resumo da classe

class ResourceBundle implements IteratorAggregate, Countable {
/* Métodos */
public function __construct(?string `$locale`, ?string `$bundle`, bool `$fallback` = `true`)
public function count(): int
public static function create(?string `$locale`, ?string `$bundle`, bool `$fallback` = `true`): ?ResourceBundle
public function get(string|int `$index`, bool `$fallback` = `true`): ResourceBundle|array|string|int|null
public function getErrorCode(): int
public function getErrorMessage(): string
public static function getLocales(string `$bundle`): array|false
}

## Registro de Alterações

Versão | Descrição
--- | ---
8.0.0 | ResourceBundle implementa IteratorAggregate agora. Anteriormente, Traversable era implementado no lugar.
7.4.0 | ResourceBundle implementa Countable agora.

## Veja Também

- » Gereciamento de Recursos ICU
- » Dados ICU

## Índice

- ResourceBundle::count — Obtém o número de elementos no pacote
- ResourceBundle::create — Cria um pacote de recursos
- ResourceBundle::get — Obtém os dados do pacote
- ResourceBundle::getErrorCode — Obtém o código do último erro gerado pelo pacote.
- ResourceBundle::getErrorMessage — Obtém a última mensagem de erro gerada pelo pacote
- ResourceBundle::getLocales — Obtém as localidades suportadas

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open