Mercurial > hg > nginx-site
diff xml/ru/docs/njs/reference.xml @ 2582:e162a71453b0
Improved String.prototype.toString() for ordinary strings in njs.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 11 Aug 2020 12:34:32 +0100 |
parents | 28f98f596974 |
children | cd97adddd757 |
line wrap: on
line diff
--- a/xml/ru/docs/njs/reference.xml +++ b/xml/ru/docs/njs/reference.xml @@ -9,7 +9,7 @@ <article name="Справочник" link="/ru/docs/njs/reference.html" lang="ru" - rev="50"> + rev="51"> <section id="summary"> @@ -594,20 +594,6 @@ true, если буфер должен иметь флаг <literal>flush</literal> >> '£'.toBytes().toString('hex') 'a3' /* a3 является байтом, равным codepoint 00A3 ('£') */ </example> -В различные кодировки могут быть преобразованы только байтовые строки. -Например строка не может быть кодирована напрямую в <literal>hex</literal>: -<example> ->> 'αβγδ'.toString('base64') -TypeError: argument must be a byte string - at String.prototype.toString (native) - at main (native) -</example> -Чтобы преобразовать строку Unicode в hex, -сначала необходимо её преобразовать в байтовую строку и затем в hex: -<example> ->> 'αβγδ'.toUTF8().toString('base64') -'zrHOss6zzrQ=' -</example> <list type="tag"> @@ -652,24 +638,24 @@ TypeError: argument must be a byte strin Возвращает <literal>null</literal>, если в строке найден символ больше, чем 255. </tag-desc> -<tag-name id="string_tostring"><literal>String.prototype.toString([<value>кодировка</value>])</literal></tag-name> +<tag-name id="string_tostring"><literal>String.prototype.toString(<value>кодировка</value>)</literal></tag-name> <tag-desc> <para> -Если кодировка не указана, -возвращает указанную строку Unicode string или байтовую строку как в ECMAScript. -</para> - -<para> -Если кодировка указана, -кодирует <link id="string_tobytes">байтовую строку</link> в +Кодирует указанную строку в <literal>hex</literal>, <literal>base64</literal> или -<literal>base64url</literal>. -</para> +<literal>base64url</literal>: +<example> +>> 'αβγδ'.toString('base64url') +'zrHOss6zzrQ' +</example> +До версии <link doc="changes.xml" id="njs0.4.3">0.4.3</link> +могла быть кодирована только <link id="string_tobytes">байтовая строка</link>: <example> >> 'αβγδ'.toUTF8().toString('base64url') 'zrHOss6zzrQ' </example> +</para> </tag-desc> <tag-name id="string_toutf8"><literal>String.prototype.toUTF8(<value>начало</value>[,