Update get.xml to En

This commit is contained in:
Mikhail Alferov
2024-12-25 16:41:40 +03:00
committed by GitHub
parent eb977ea465
commit 9225716e55

View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: b35a2269ff83dde1436a407952b08f78dbe39ead Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="resourcebundle.get" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>ResourceBundle::get</refname>
<refname>resourcebundle_get</refname>
<refpurpose>Получить данные из пакета</refpurpose>
<refpurpose>Получает данные из пакета</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -28,7 +28,7 @@
<methodparam choice="opt"><type>bool</type><parameter>fallback</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis>
<para>
Возвращает данные из пакета по индексу или строковому ключу.
Метод получает данные данные из пакета по индексу или строковому ключу.
</para>
</refsect1>
@ -40,7 +40,7 @@
<term><parameter>bundle</parameter></term>
<listitem>
<para>
Объект <classname>ResourceBundle</classname>.
Объект класса <classname>ResourceBundle</classname>.
</para>
</listitem>
</varlistentry>
@ -48,7 +48,7 @@
<term><parameter>index</parameter></term>
<listitem>
<para>
Индекс данных, должен быть строкой или целым числом.
Индекс данных в виде строки или целого числа.
</para>
</listitem>
</varlistentry>
@ -56,7 +56,7 @@
<term><parameter>fallback</parameter></term>
<listitem>
<para>
Должна ли локаль совпадать точно, или можно откатиться к родительской локали.
Требуется ли точное совпадение локали или откатиться к родительской локали.
</para>
</listitem>
</varlistentry>
@ -64,26 +64,68 @@
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает данные из пакета по индексу или строковому ключу или &null; в случае возникновения ошибки.
Строки, целые числа и бинарные строки возвращаются в соответствующем типе PHP,
массивы целых чисел возвращаются как массивы PHP. Сложные типы возвращаются как
объекты <classname>ResourceBundle</classname>.
Метод возвращает данные из пакета по индексу или строковому ключу, или &null;, если возникла ошибка.
Строки, целые числа и строки двоичных данных возвращаются как PHP-типы, которые соответствуют структуре данных,
массивы целых чисел возвращаются как PHP-массивы. Сложные типы возвращаются
как объекты класса <classname>ResourceBundle</classname>.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<simpara>
При недопустимом типе смещеиня метод выбросит ошибку <exceptionname>TypeError</exceptionname>.
</simpara>
<simpara>
Метод выбросит ошибку <exceptionname>ValueError</exceptionname>,
если в аргументе <parameter>index</parameter> передали значение с типом <type>string</type>
и строка оказалсь пустой, или передали значение с типом <type>int</type>, которое не вписывается
в 32-битный целочисленный тип.
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
<simpara>
При недопустимом типе смещеиня метод выбросит ошибку <exceptionname>TypeError</exceptionname>.
Метод выбросит ошибку <exceptionname>ValueError</exceptionname>,
если в аргументе <parameter>index</parameter> передали значение с типом <type>string</type>
и строка оказалсь пустой, или передали значение с типом <type>int</type>, которое не вписывается
в 32-битный целочисленный тип.
</simpara>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования <function>resourcebundle_get</function></title>
<title>Пример получения данных из пакета функцией <function>resourcebundle_get</function></title>
<programlisting role="php">
<![CDATA[
<?php
$r = resourcebundle_create( 'es', "/usr/share/data/myapp");
$r = resourcebundle_create('es', "/usr/share/data/myapp");
echo resourcebundle_get($r, 'somestring');
?>
]]>
</programlisting>
@ -93,8 +135,10 @@ echo resourcebundle_get($r, 'somestring');
<programlisting role="php">
<![CDATA[
<?php
$r = new ResourceBundle( 'es', "/usr/share/data/myapp");
$r = new ResourceBundle('es', "/usr/share/data/myapp");
echo $r->get('somestring');
?>
]]>
</programlisting>