Mercurial > hg > nginx-site

comparison xml/en/docs/njs/reference.xml @ 2689:7e271437f12e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated writable variables info in r.variables and s.variables.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 19 Mar 2021 18:26:19 +0000
parents dd2bbd104146
children 3cbd6e440581
comparison
equal deleted inserted replaced
2688:dd2bbd104146 2689:7e271437f12e
7 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd"> 7 <!DOCTYPE article SYSTEM "../../../../dtd/article.dtd">
8 8
9 <article name="Reference" 9 <article name="Reference"
10 link="/en/docs/njs/reference.html" 10 link="/en/docs/njs/reference.html"
11 lang="en" 11 lang="en"
12 rev="71"> 12 rev="72">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 <link doc="index.xml">njs</link> provides objects, methods and properties 17 <link doc="index.xml">njs</link> provides objects, methods and properties
455 </tag-desc> 455 </tag-desc>
456 456
457 <tag-name id="r_variables"><literal>r.variables{}</literal></tag-name> 457 <tag-name id="r_variables"><literal>r.variables{}</literal></tag-name>
458 <tag-desc> 458 <tag-desc>
459 nginx variables object, writable 459 nginx variables object, writable
460 (since <link doc="changes.xml" id="njs0.2.8">0.2.8</link>) 460 (since <link doc="changes.xml" id="njs0.2.8">0.2.8</link>).
461 A variable can be writable only
462 if it is referenced in nginx configuration file.
463 Even so, some embedded variables still cannot be assigned a value (for example,
464 <link doc="../http/ngx_http_core_module.xml" id="var_http_"><literal>$http_</literal></link>).
461 </tag-desc> 465 </tag-desc>
462 466
463 <tag-name id="r_warn"><literal>r.warn(<value>string</value>)</literal></tag-name> 467 <tag-name id="r_warn"><literal>r.warn(<value>string</value>)</literal></tag-name>
464 <tag-desc> 468 <tag-desc>
465 writes a <literal>string</literal> to the error log 469 writes a <literal>string</literal> to the error log
667 </tag-desc> 671 </tag-desc>
668 672
669 <tag-name id="s_variables"><literal>s.variables{}</literal></tag-name> 673 <tag-name id="s_variables"><literal>s.variables{}</literal></tag-name>
670 <tag-desc> 674 <tag-desc>
671 nginx variables object, writable 675 nginx variables object, writable
672 (since <link doc="changes.xml" id="njs0.2.8">0.2.8</link>) 676 (since <link doc="changes.xml" id="njs0.2.8">0.2.8</link>).
677 A variable can be writable only
678 if it is referenced in nginx configuration file.
679 Even so, some embedded variables still cannot be assigned a value.
673 </tag-desc> 680 </tag-desc>
674 681
675 <tag-name id="s_warn"><literal>s.warn(<value>string</value>)</literal></tag-name> 682 <tag-name id="s_warn"><literal>s.warn(<value>string</value>)</literal></tag-name>
676 <tag-desc> 683 <tag-desc>
677 writes a sent <literal>string</literal> to the error log 684 writes a sent <literal>string</literal> to the error log