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 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138
|
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<reference xml:id="class.resourcebundle" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The ResourceBundle class</title>
<titleabbrev>ResourceBundle</titleabbrev>
<partintro>
<!-- {{{ ResourceBundle intro -->
<section xml:id="resourcebundle.intro">
&reftitle.intro;
<simpara>
Localized software products often require sets of data that are to be customized
depending on current locale, e.g.: messages, labels, formatting patterns. ICU
resource mechanism allows to define sets of resources that the application can
load on locale basis, while accessing them in unified locale-independent fashion.
</simpara>
<simpara>
This class implements access to ICU resource data files. These files are binary data
arrays which ICU uses to store the localized data.
</simpara>
<simpara>
ICU resource bundle can hold simple resources and complex resources. Complex resources
are containers which can be either integer-indexed or string-indexed (just like PHP arrays).
Simple resources can be of the following types: string, integer, binary data field
or integer array.
</simpara>
<simpara>
<classname>ResourceBundle</classname> supports direct access to the data through array access
pattern and iteration via <link linkend="control-structures.foreach">foreach</link>,
as well as access via class methods. The result will be PHP value for simple resources and
<classname>ResourceBundle</classname> object for complex ones. All resources are read-only.
</simpara>
</section>
<!-- }}} -->
<section xml:id="resourcebundle.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<classname>ResourceBundle</classname>
</ooclass>
<oointerface>
<modifier>implements</modifier>
<interfacename>IteratorAggregate</interfacename>
</oointerface>
<oointerface>
<interfacename>Countable</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.resourcebundle')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='ResourceBundle'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.resourcebundle')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='ResourceBundle'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<classname>ResourceBundle</classname> implements
<interfacename>IteratorAggregate</interfacename> now.
Previously, <interfacename>Traversable</interfacename> was implemented instead.
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
<classname>ResourceBundle</classname> implements
<interfacename>Countable</interfacename> now.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>
</section>
<!-- &reference.intl.resourcebundle-constants; -->
<section xml:id="resourcebundle.seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>
<link xlink:href="&url.icu.resources;">
ICU Resource Management
</link>
</member>
<member>
<link xlink:href="&url.icu.data;">ICU Data</link>
</member>
</simplelist>
</para>
</section>
</partintro>
&reference.intl.entities.resourcebundle;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
|