Mercurial > hg > nginx-site

comparison xml/ru/docs/njs/reference.xml @ 2582:e162a71453b0

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
comparison
equal deleted inserted replaced
2581:324ca14c3003 2582:e162a71453b0
7 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd"> 7 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd">
8 8
9 <article name="Справочник" 9 <article name="Справочник"
10 link="/ru/docs/njs/reference.html" 10 link="/ru/docs/njs/reference.html"
11 lang="ru" 11 lang="ru"
12 rev="50"> 12 rev="51">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 <link doc="index.xml">njs</link> предоставляет объекты, методы и свойства 17 <link doc="index.xml">njs</link> предоставляет объекты, методы и свойства
592 в противном случае возвращается <literal>null</literal>: 592 в противном случае возвращается <literal>null</literal>:
593 <example> 593 <example>
594 >> '£'.toBytes().toString('hex') 594 >> '£'.toBytes().toString('hex')
595 'a3' /* a3 является байтом, равным codepoint 00A3 ('£') */ 595 'a3' /* a3 является байтом, равным codepoint 00A3 ('£') */
596 </example> 596 </example>
597 В различные кодировки могут быть преобразованы только байтовые строки.
598 Например строка не может быть кодирована напрямую в <literal>hex</literal>:
599 <example>
600 >> 'αβγδ'.toString('base64')
601 TypeError: argument must be a byte string
602 at String.prototype.toString (native)
603 at main (native)
604 </example>
605 Чтобы преобразовать строку Unicode в hex,
606 сначала необходимо её преобразовать в байтовую строку и затем в hex:
607 <example>
608 >> 'αβγδ'.toUTF8().toString('base64')
609 'zrHOss6zzrQ='
610 </example>
611 597
612 <list type="tag"> 598 <list type="tag">
613 599
614 <tag-name id="string_bytesfrom"><literal>String.bytesFrom(<value>массив</value> 600 <tag-name id="string_bytesfrom"><literal>String.bytesFrom(<value>массив</value>
615 | <value>строка</value>, <value>кодировка</value>)</literal></tag-name> 601 | <value>строка</value>, <value>кодировка</value>)</literal></tag-name>
650 <tag-desc> 636 <tag-desc>
651 Сериализует строку Unicode в байтовую строку. 637 Сериализует строку Unicode в байтовую строку.
652 Возвращает <literal>null</literal>, если в строке найден символ больше, чем 255. 638 Возвращает <literal>null</literal>, если в строке найден символ больше, чем 255.
653 </tag-desc> 639 </tag-desc>
654 640
655 <tag-name id="string_tostring"><literal>String.prototype.toString([<value>кодировка</value>])</literal></tag-name> 641 <tag-name id="string_tostring"><literal>String.prototype.toString(<value>кодировка</value>)</literal></tag-name>
656 <tag-desc> 642 <tag-desc>
657 <para> 643 <para>
658 Если кодировка не указана, 644 Кодирует указанную строку в
659 возвращает указанную строку Unicode string или байтовую строку как в ECMAScript.
660 </para>
661
662 <para>
663 Если кодировка указана,
664 кодирует <link id="string_tobytes">байтовую строку</link> в
665 <literal>hex</literal>, 645 <literal>hex</literal>,
666 <literal>base64</literal> или 646 <literal>base64</literal> или
667 <literal>base64url</literal>. 647 <literal>base64url</literal>:
668 </para> 648 <example>
649 >> 'αβγδ'.toString('base64url')
650 'zrHOss6zzrQ'
651 </example>
652 До версии <link doc="changes.xml" id="njs0.4.3">0.4.3</link>
653 могла быть кодирована только <link id="string_tobytes">байтовая строка</link>:
669 <example> 654 <example>
670 >> 'αβγδ'.toUTF8().toString('base64url') 655 >> 'αβγδ'.toUTF8().toString('base64url')
671 'zrHOss6zzrQ' 656 'zrHOss6zzrQ'
672 </example> 657 </example>
658 </para>
673 </tag-desc> 659 </tag-desc>
674 660
675 <tag-name id="string_toutf8"><literal>String.prototype.toUTF8(<value>начало</value>[, 661 <tag-name id="string_toutf8"><literal>String.prototype.toUTF8(<value>начало</value>[,
676 <value>конец</value>])</literal></tag-name> 662 <value>конец</value>])</literal></tag-name>
677 <tag-desc> 663 <tag-desc>