com doc/ru: Обновлен ие до англи йской верси и: language/oop5/abstract.xml language/oop5/au toload.xml
language/oop5/traits.xml language/oop5/v isibility.xml reference/ev/evcheck/createstopped.xml re ference/ev/evchild/createstopped.xml
reference/mbstring/fun ctions/mb-strimwidth.xml reference/mbstring/functions/mb-st rwidth.xml
| From: | Sergey Panteleev | Date: | Tue, 16 Mar 2021 09:38:23 +0000 |
| Subject: | com doc/ru: Обновлен ие до англи йской верси и: language/oop5/abstract.xml language/oop5/au toload.xml language/oop5/traits.xml language/oop5/v isibility.xml reference/ev/evcheck/createstopped.xml re ference/ev/evchild/createstopped.xml reference/mbstring/fun ctions/mb-strimwidth.xml reference/mbstring/functions/mb-st rwidth.xml |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-8830@lists.php.net to get a copy of this message | ||
Commit: 5f8d2c038c2e1364730dccafe9eb67c1cad54885
Author: Sergey Panteleev <sergey@php.net> Tue, 16 Mar 2021 12:35:59 +0300
Parents: 915dc8a7f6ad859bc0e99a1c4493125d93c2ceaa
Branches: master
Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=5f8d2c038c2e1364730dccafe9eb67c1cad54885
Log:
Обновление до английской версии
Changed paths:
M language/oop5/abstract.xml
M language/oop5/autoload.xml
M language/oop5/traits.xml
M language/oop5/visibility.xml
M reference/ev/evcheck/createstopped.xml
M reference/ev/evchild/createstopped.xml
M reference/mbstring/functions/mb-strimwidth.xml
M reference/mbstring/functions/mb-strwidth.xml
diff --git a/language/oop5/abstract.xml b/language/oop5/abstract.xml index 507629d5c..ca29075b5 100644 --- a/language/oop5/abstract.xml +++ b/language/oop5/abstract.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: a9edd62d087ab1eb6292c795b7256e14ff9f1234 Maintainer: shein Status: ready --> +<!-- EN-Revision: 9ee9eccf455188ab6eb352194eb6f9eb99e15606 Maintainer: shein Status: ready --> <!-- Reviewed: yes Maintainer: sergey --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.abstract" xmlns="http://docbook.org/ns/docbook"> @@ -14,16 +14,9 @@ <para> При наследовании от абстрактного класса, все методы, помеченные абстрактными - в родительском классе, должны быть определены в дочернем классе; кроме того, - <link linkend="language.oop5.visibility">область видимости</link> - этих методов должна совпадать (или быть менее строгой). - Например, если абстрактный метод объявлен как protected, то реализация этого метода - должна быть protected или public, но не private. - Более того, объявления методов должны совпадать, то есть контроль - типов (type hint) и количество обязательных аргументов должно - быть одинаковым. К примеру, если в дочернем классе указан необязательный параметр, - которого нет в объявлении абстрактного класса, то в данном случае конфликта - объявлений методов не будет. + в родительском классе, должны быть определены в дочернем классе и + следовать обычным правилам <link linkend="language.oop5.inheritance">наследования</link> + и <link linkend="language.oop.lsp">совместимости сигнатуры</link>. </para> <example> @@ -128,11 +121,6 @@ Mrs. Pacwoman ]]> </screen> </example> - - <para> - Старый код, который не имеет определённых пользователем классов или функций - с именем 'abstract', должен работать без изменений. - </para> </sect1> <!-- Keep this comment at the end of the file Local variables: diff --git a/language/oop5/autoload.xml b/language/oop5/autoload.xml index 13bc519ff..5fea2c2de 100644 --- a/language/oop5/autoload.xml +++ b/language/oop5/autoload.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 99b8716337e2c27b6addf7e184b8ac7a50bb38b0 Maintainer: irker Status: ready --> +<!-- EN-Revision: 9ee9eccf455188ab6eb352194eb6f9eb99e15606 Maintainer: irker Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.autoload" xmlns="http://docbook.org/ns/docbook"> @@ -19,26 +19,13 @@ Регистрируя автозагрузчики, PHP получает последний шанс для интерпретатора загрузить класс прежде, чем он закончит выполнение скрипта с ошибкой. </para> - <tip> + <caution> <para> - В то время как функция <function>__autoload</function> также может быть - использована для автоматической загрузки классов и интерфейсов, следует - отдать предпочтение <function>spl_autoload_register</function>, потому, что - она предоставляет гораздо более гибкую альтернативу, позволяя - регистрировать необходимое количество автозагрузчиков, например, - для сторонних библиотек. По этой причине - использование <function>__autoload</function> не рекомендуется, - а c PHP 7.2.0 объявлено устаревшим. + До PHP 8.0.0 можно было использовать <function>__autoload</function> для автозагрузки + классов и интерфейсов. Однако это менее гибкая альтернатива <function>spl_autoload_register</function>, + функция <function>__autoload</function> объявлена устаревшей в PHP 7.2.0 и удалена в PHP 8.0.0. </para> - </tip> - <note> - <para> - Если имя класса используется, например, для вызова через <function>call_user_func</function>, - то оно может содержать некоторые опасные символы, такие как <literal>../</literal>. - Поэтому рекомендуется не использовать данные от пользователей в таких функциях или же, - по крайней мере, проверять значения в <function>__autoload</function>. - </para> - </note> + </caution> <para> <example> <title>Пример автоматической загрузки</title> diff --git a/language/oop5/traits.xml b/language/oop5/traits.xml index 503828849..487ea8225 100644 --- a/language/oop5/traits.xml +++ b/language/oop5/traits.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 9ee9eccf455188ab6eb352194eb6f9eb99e15606 Maintainer: mch Status: ready --> +<!-- EN-Revision: 77a77dbd2962fb026342721f05d64b1e849d37a9 Maintainer: mch Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.traits" xmlns="http://docbook.org/ns/docbook"> @@ -329,6 +329,8 @@ Hello World! <para> Трейты поддерживают использование абстрактных методов для того, чтобы установить требования к использующему классу. + Поддерживаются общедоступные, защищённые и закрытые методы. + До PHP 8.0.0 поддерживались только защищённые и закрытые абстрактные методы. </para> <caution> <simpara> diff --git a/language/oop5/visibility.xml b/language/oop5/visibility.xml index 11f028c97..bf3cddffc 100644 --- a/language/oop5/visibility.xml +++ b/language/oop5/visibility.xml @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: a9edd62d087ab1eb6292c795b7256e14ff9f1234 Maintainer: irker Status: ready --> +<!-- EN-Revision: 9ee9eccf455188ab6eb352194eb6f9eb99e15606 Maintainer: irker Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.visibility" xmlns="http://docbook.org/ns/docbook"> <title>Область видимости</title> <para> Область видимости свойства, метода или константы (начиная c PHP 7.1.0) может быть определена путём - использования следующих ключевых слов в объявлении: <emphasis>public</emphasis>, - <emphasis>protected</emphasis> или <emphasis>private</emphasis>. Доступ к свойствам + использования следующих ключевых слов в объявлении: <literal>public</literal>, + <literal>protected</literal> или <literal>private</literal>. Доступ к свойствам и методам класса, объявленным как public (общедоступный), разрешён отовсюду. Модификатор protected (защищённый) разрешает доступ самому классу, наследующим его классам и родительским классам. Модификатор private (закрытый) ограничивает область видимости так, что только класс, @@ -18,7 +18,7 @@ <title>Область видимости свойства</title> <para> Свойства класса должны быть определены через модификаторы public, private - или protected. Если же свойство определено с помощью <emphasis>var</emphasis>, + или protected. Если же свойство определено с помощью <literal>var</literal>, то оно будет объявлено общедоступным свойством. </para> <para> diff --git a/reference/ev/evcheck/createstopped.xml b/reference/ev/evcheck/createstopped.xml index 509ab9de5..5e9963105 100644 --- a/reference/ev/evcheck/createstopped.xml +++ b/reference/ev/evcheck/createstopped.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 8d666e819852f6b0561b40fcf8689b747568865c Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: da1f814030f9d4f11ae57608add98e51b558b881 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: sergey --> - <refentry xml:id="evcheck.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>EvCheck::createStopped</refname> diff --git a/reference/ev/evchild/createstopped.xml b/reference/ev/evchild/createstopped.xml index f0a0302b7..3cbcfc7c5 100644 --- a/reference/ev/evchild/createstopped.xml +++ b/reference/ev/evchild/createstopped.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 8d666e819852f6b0561b40fcf8689b747568865c Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: da1f814030f9d4f11ae57608add98e51b558b881 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: sergey --> - <refentry xml:id="evchild.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>EvChild::createStopped</refname> diff --git a/reference/mbstring/functions/mb-strimwidth.xml b/reference/mbstring/functions/mb-strimwidth.xml index 27fa9bede..e511e6447 100644 --- a/reference/mbstring/functions/mb-strimwidth.xml +++ b/reference/mbstring/functions/mb-strimwidth.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 92f1b8b177eb5730382abf9f27bae868f1bb636f Maintainer: tmn Status: ready --> +<!-- EN-Revision: 64f2f1c70d2f42507d9c624e09dcf486ceca7be5 Maintainer: tmn Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.mb-strimwidth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -20,7 +20,11 @@ </methodsynopsis> <para> Обрезает строку (<type>string</type>) <parameter>string</parameter> - до длины <parameter>width</parameter> символов. + до длины <parameter>width</parameter> символов, + где символы половинной ширины считаются как <literal>1</literal>, а символы полной + ширины считаются как <literal>2</literal>. + Смотрите <link xlink:href="&url.unicode.reports.tr;11/">&url.unicode.reports.tr;11/</link> + для получения подробной информации о ширине символов Восточной Азии. </para> </refsect1> diff --git a/reference/mbstring/functions/mb-strwidth.xml b/reference/mbstring/functions/mb-strwidth.xml index 0cd21a41d..ad6bb8590 100644 --- a/reference/mbstring/functions/mb-strwidth.xml +++ b/reference/mbstring/functions/mb-strwidth.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 92f1b8b177eb5730382abf9f27bae868f1bb636f Maintainer: tmn Status: ready --> +<!-- EN-Revision: 64f2f1c70d2f42507d9c624e09dcf486ceca7be5 Maintainer: tmn Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <!-- $Revision$ --> <refentry xml:id="function.mb-strwidth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -17,8 +17,10 @@ </methodsynopsis> <para> Возвращает ширину строки (<type>string</type>) <parameter>string</parameter>, - где символы полуширины считаются <literal>1</literal>, + где символы половинной ширины считаются <literal>1</literal>, а символы полной ширины считаются <literal>2</literal>. + Смотрите <link xlink:href="&url.unicode.reports.tr;11/">&url.unicode.reports.tr;11/</link> + для получения подробной информации о ширине символов Восточной Азии. </para> <para> Символы полной ширины: @@ -111,6 +113,31 @@ </informaltable> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <example xml:id="mb-strwidth.example.basic"> + <title>Пример использования <function>mb_strwidth</function></title> + <programlisting role="php"> + <![CDATA[ +<?php +var_dump( + mb_strwidth('a'), // латинская строчная буква а + mb_strwidth("\u{ff41}") // латинская строчная буква а полной ширины +); +?> +]]> + </programlisting> + &example.outputs; + <screen> + <![CDATA[ +int(1) +int(2) +]]> + </screen> + </example> + </refsect1> + + <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -122,7 +149,6 @@ </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
diff --git a/language/oop5/abstract.xml b/language/oop5/abstract.xml index 507629d5c..ca29075b5 100644 --- a/language/oop5/abstract.xml +++ b/language/oop5/abstract.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: a9edd62d087ab1eb6292c795b7256e14ff9f1234 Maintainer: shein Status: ready --> +<!-- EN-Revision: 9ee9eccf455188ab6eb352194eb6f9eb99e15606 Maintainer: shein Status: ready --> <!-- Reviewed: yes Maintainer: sergey --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.abstract" xmlns="http://docbook.org/ns/docbook"> @@ -14,16 +14,9 @@ <para> При наследовании от абстрактного класса, все методы, помеченные абстрактными - в родительском классе, должны быть определены в дочернем классе; кроме того, - <link linkend="language.oop5.visibility">область видимости</link> - этих методов должна совпадать (или быть менее строгой). - Например, если абстрактный метод объявлен как protected, то реализация этого метода - должна быть protected или public, но не private. - Более того, объявления методов должны совпадать, то есть контроль - типов (type hint) и количество обязательных аргументов должно - быть одинаковым. К примеру, если в дочернем классе указан необязательный параметр, - которого нет в объявлении абстрактного класса, то в данном случае конфликта - объявлений методов не будет. + в родительском классе, должны быть определены в дочернем классе и + следовать обычным правилам <link linkend="language.oop5.inheritance">наследования</link> + и <link linkend="language.oop.lsp">совместимости сигнатуры</link>. </para> <example> @@ -128,11 +121,6 @@ Mrs. Pacwoman ]]> </screen> </example> - - <para> - Старый код, который не имеет определённых пользователем классов или функций - с именем 'abstract', должен работать без изменений. - </para> </sect1> <!-- Keep this comment at the end of the file Local variables: diff --git a/language/oop5/autoload.xml b/language/oop5/autoload.xml index 13bc519ff..5fea2c2de 100644 --- a/language/oop5/autoload.xml +++ b/language/oop5/autoload.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 99b8716337e2c27b6addf7e184b8ac7a50bb38b0 Maintainer: irker Status: ready --> +<!-- EN-Revision: 9ee9eccf455188ab6eb352194eb6f9eb99e15606 Maintainer: irker Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.autoload" xmlns="http://docbook.org/ns/docbook"> @@ -19,26 +19,13 @@ Регистрируя автозагрузчики, PHP получает последний шанс для интерпретатора загрузить класс прежде, чем он закончит выполнение скрипта с ошибкой. </para> - <tip> + <caution> <para> - В то время как функция <function>__autoload</function> также может быть - использована для автоматической загрузки классов и интерфейсов, следует - отдать предпочтение <function>spl_autoload_register</function>, потому, что - она предоставляет гораздо более гибкую альтернативу, позволяя - регистрировать необходимое количество автозагрузчиков, например, - для сторонних библиотек. По этой причине - использование <function>__autoload</function> не рекомендуется, - а c PHP 7.2.0 объявлено устаревшим. + До PHP 8.0.0 можно было использовать <function>__autoload</function> для автозагрузки + классов и интерфейсов. Однако это менее гибкая альтернатива <function>spl_autoload_register</function>, + функция <function>__autoload</function> объявлена устаревшей в PHP 7.2.0 и удалена в PHP 8.0.0. </para> - </tip> - <note> - <para> - Если имя класса используется, например, для вызова через <function>call_user_func</function>, - то оно может содержать некоторые опасные символы, такие как <literal>../</literal>. - Поэтому рекомендуется не использовать данные от пользователей в таких функциях или же, - по крайней мере, проверять значения в <function>__autoload</function>. - </para> - </note> + </caution> <para> <example> <title>Пример автоматической загрузки</title> diff --git a/language/oop5/traits.xml b/language/oop5/traits.xml index 503828849..487ea8225 100644 --- a/language/oop5/traits.xml +++ b/language/oop5/traits.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 9ee9eccf455188ab6eb352194eb6f9eb99e15606 Maintainer: mch Status: ready --> +<!-- EN-Revision: 77a77dbd2962fb026342721f05d64b1e849d37a9 Maintainer: mch Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.traits" xmlns="http://docbook.org/ns/docbook"> @@ -329,6 +329,8 @@ Hello World! <para> Трейты поддерживают использование абстрактных методов для того, чтобы установить требования к использующему классу. + Поддерживаются общедоступные, защищённые и закрытые методы. + До PHP 8.0.0 поддерживались только защищённые и закрытые абстрактные методы. </para> <caution> <simpara> diff --git a/language/oop5/visibility.xml b/language/oop5/visibility.xml index 11f028c97..bf3cddffc 100644 --- a/language/oop5/visibility.xml +++ b/language/oop5/visibility.xml @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: a9edd62d087ab1eb6292c795b7256e14ff9f1234 Maintainer: irker Status: ready --> +<!-- EN-Revision: 9ee9eccf455188ab6eb352194eb6f9eb99e15606 Maintainer: irker Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.visibility" xmlns="http://docbook.org/ns/docbook"> <title>Область видимости</title> <para> Область видимости свойства, метода или константы (начиная c PHP 7.1.0) может быть определена путём - использования следующих ключевых слов в объявлении: <emphasis>public</emphasis>, - <emphasis>protected</emphasis> или <emphasis>private</emphasis>. Доступ к свойствам + использования следующих ключевых слов в объявлении: <literal>public</literal>, + <literal>protected</literal> или <literal>private</literal>. Доступ к свойствам и методам класса, объявленным как public (общедоступный), разрешён отовсюду. Модификатор protected (защищённый) разрешает доступ самому классу, наследующим его классам и родительским классам. Модификатор private (закрытый) ограничивает область видимости так, что только класс, @@ -18,7 +18,7 @@ <title>Область видимости свойства</title> <para> Свойства класса должны быть определены через модификаторы public, private - или protected. Если же свойство определено с помощью <emphasis>var</emphasis>, + или protected. Если же свойство определено с помощью <literal>var</literal>, то оно будет объявлено общедоступным свойством. </para> <para> diff --git a/reference/ev/evcheck/createstopped.xml b/reference/ev/evcheck/createstopped.xml index 509ab9de5..5e9963105 100644 --- a/reference/ev/evcheck/createstopped.xml +++ b/reference/ev/evcheck/createstopped.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 8d666e819852f6b0561b40fcf8689b747568865c Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: da1f814030f9d4f11ae57608add98e51b558b881 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: sergey --> - <refentry xml:id="evcheck.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>EvCheck::createStopped</refname> diff --git a/reference/ev/evchild/createstopped.xml b/reference/ev/evchild/createstopped.xml index f0a0302b7..3cbcfc7c5 100644 --- a/reference/ev/evchild/createstopped.xml +++ b/reference/ev/evchild/createstopped.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 8d666e819852f6b0561b40fcf8689b747568865c Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: da1f814030f9d4f11ae57608add98e51b558b881 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: sergey --> - <refentry xml:id="evchild.createstopped" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>EvChild::createStopped</refname> diff --git a/reference/mbstring/functions/mb-strimwidth.xml b/reference/mbstring/functions/mb-strimwidth.xml index 27fa9bede..e511e6447 100644 --- a/reference/mbstring/functions/mb-strimwidth.xml +++ b/reference/mbstring/functions/mb-strimwidth.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 92f1b8b177eb5730382abf9f27bae868f1bb636f Maintainer: tmn Status: ready --> +<!-- EN-Revision: 64f2f1c70d2f42507d9c624e09dcf486ceca7be5 Maintainer: tmn Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.mb-strimwidth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -20,7 +20,11 @@ </methodsynopsis> <para> Обрезает строку (<type>string</type>) <parameter>string</parameter> - до длины <parameter>width</parameter> символов. + до длины <parameter>width</parameter> символов, + где символы половинной ширины считаются как <literal>1</literal>, а символы полной + ширины считаются как <literal>2</literal>. + Смотрите <link xlink:href="&url.unicode.reports.tr;11/">&url.unicode.reports.tr;11/</link> + для получения подробной информации о ширине символов Восточной Азии. </para> </refsect1> diff --git a/reference/mbstring/functions/mb-strwidth.xml b/reference/mbstring/functions/mb-strwidth.xml index 0cd21a41d..ad6bb8590 100644 --- a/reference/mbstring/functions/mb-strwidth.xml +++ b/reference/mbstring/functions/mb-strwidth.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 92f1b8b177eb5730382abf9f27bae868f1bb636f Maintainer: tmn Status: ready --> +<!-- EN-Revision: 64f2f1c70d2f42507d9c624e09dcf486ceca7be5 Maintainer: tmn Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <!-- $Revision$ --> <refentry xml:id="function.mb-strwidth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -17,8 +17,10 @@ </methodsynopsis> <para> Возвращает ширину строки (<type>string</type>) <parameter>string</parameter>, - где символы полуширины считаются <literal>1</literal>, + где символы половинной ширины считаются <literal>1</literal>, а символы полной ширины считаются <literal>2</literal>. + Смотрите <link xlink:href="&url.unicode.reports.tr;11/">&url.unicode.reports.tr;11/</link> + для получения подробной информации о ширине символов Восточной Азии. </para> <para> Символы полной ширины: @@ -111,6 +113,31 @@ </informaltable> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <example xml:id="mb-strwidth.example.basic"> + <title>Пример использования <function>mb_strwidth</function></title> + <programlisting role="php"> + <![CDATA[ +<?php +var_dump( + mb_strwidth('a'), // латинская строчная буква а + mb_strwidth("\u{ff41}") // латинская строчная буква а полной ширины +); +?> +]]> + </programlisting> + &example.outputs; + <screen> + <![CDATA[ +int(1) +int(2) +]]> + </screen> + </example> + </refsect1> + + <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -122,7 +149,6 @@ </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml