Extension:Scribunto/Lua reference manual/eo: Difference between revisions

Content deleted Content added
FuzzyBot (talk | contribs)
Updating to match new version of source page
FuzzyBot (talk | contribs)
Updating to match new version of source page
 
(5 intermediate revisions by the same user not shown)
Line 3,311:
 
==== mw.title.makeTitle ====
<code style="white-space:nowrap">mw.title.makeTitle( nomujo<span lang="en" dir="ltr" class="mw-content-ltr">namespace, titolotitle, fragmentofragment, intervikiointerwiki</span> )</code>
 
<div class="mw-translate-fuzzy">
Kreas titolan objekton kun titolo <code>titolo</code> ennomujo <code>nomujo</code>, opcie kun la specifita <code>fragmento</code> kaj <code>intervikio</code> prefiksoj. <code>nomujo</code> povas esti ajna kiuo trovebla en <code>[[#mw.site.namespaces$anchor|mw.site.namespaces]]</code>. Se la rezultinta titolo ne estas valida, liveras <code>nil</code>.
</div>
 
<div class="mw-translate-fuzzy">
Notu ke, malsame al <code>[[#mw.title.new|mw.title.new()]]</code>, tiu statvojo ĉiam aplikos la specifitan nomujon. Ekzemple, <code style="white-space:nowrap">mw.title.makeTitle( 'Ŝablono', 'Modulo:Amo' )</code> kreos objekton por la paĝo Ŝablono:Modulo:Amo, dum <code style="white-space:nowrap">mw.title.new( 'Modulo:Amo', 'Ŝablono' )</code> kreos objekton por la paĝo Modulo:Amo.
</div>
 
<div lang="en" dir="ltr" class="mw-content-ltr">
Line 3,326 ⟶ 3,330:
Titola objekto havas nombron da ecoj kaj statvojoj. Plejparto de la ecoj estas nurlega.
 
<div class="mw-translate-fuzzy">
Notu ke kampoj finantaj kun <code>teksto</code> liveras titoloj kiel ĉenaj kiomoj dum la kampoj finantaj kun <code>titolo</code> liveras titolajn objektojn.
</div>
 
<div class="mw-translate-fuzzy">
Line 3,459 ⟶ 3,465:
</div>
 
<div class="mw-translate-fuzzy">
Titolaj objektoj povas esti komparitaj per [[#Relational operators|rilataj elstatiloj]]. <code style="white-space:nowrap">[[#tostring|tostring]]( titolo )</code> liveros <code>titolo.prefixedText</code>.
</div>
 
<div lang="en" dir="ltr" class="mw-content-ltr">
Note that accessing any [[#Expensive properties|expensive]] field on a title object records a "link" to the page (as shown on [[Special:WhatLinksHere]], for example). Using the title object's <code>getContent()</code> method or accessing the <code>redirectTarget</code> field records it as a "{{int|istemplate}}", and accessing the title object's <code>file</code> or <code>fileExists</code> fields records it as a "{{int|isimage}}".
</div>
 
Line 3,468 ⟶ 3,476:
===== Dosiera metadateno =====
 
<div class="mw-translate-fuzzy">
Titolaj objektoj prezentanta paĝon en la Dosiero aŭ ''Media'' nomujo havos econ nomitan <code>file</code>. {{red|Tio estas [[Special:MyLanguage/Manual:$wgExpensiveParserFunctionLimit|altekosta]].}} Tio estas ujo, strukturita kiel sekvanta:
</div>
 
<div class="mw-translate-fuzzy">
Line 3,501 ⟶ 3,511:
 
==== mw.uri.encode ====
<code style="white-space:nowrap">mw.uri.encode( signvico<span lang="en" dir="ltr" class="mw-content-ltr">string, kodtipoenctype</span> )</code>
 
<div class="mw-translate-fuzzy">
[[:en:Percent-encoding|Procenta-kodas]] la ĉenon. La defaŭlta tipo, <code>"QUERY"</code>, kodas spacetojn uzanta '+' por uzo en petaj ĉenoj; <code>"PATH"</code> kodas spacetojn kiel <code>%20;</code> kaj <code>"WIKI"</code> kodas spacetojn kiel '_'.
</div>
 
<div class="mw-translate-fuzzy">
Notu ke la "vikia" perzento ne estas tute inversigebla, ĉar ambaŭ spacetoj kaj substrekoj estas kodita kiel '_'.
</div>
 
==== mw.uri.decode ====
<code style="white-space:nowrap">mw.uri.decode( signvico<span lang="en" dir="ltr" class="mw-content-ltr">string, kodtipoenctype</span> )</code>
 
<div class="mw-translate-fuzzy">
[[:en:Percent-encoding|Procento-malkodas]] la ĉenon. La defaŭlta tipo, <code>"QUERY"</code>, malkodas '+' al spaceto; <code>"PATH"</code> ne elfaras ajnan kroman malkodadon; kaj <code>"WIKI"</code> malkodas '_' al spaceto.
</div>
 
==== mw.uri.anchorEncode ====
<code style="white-space:nowrap">mw.uri.anchorEncode( signvico<span lang="en" dir="ltr" class="mw-content-ltr">string</span> )</code>
 
Kodas ĉeno por uzo en Mediavikia URIa fragmento.
 
==== mw.uri.buildQueryString ====
<code style="white-space:nowrap">mw.uri.buildQueryString( ujo<span lang="en" dir="ltr" class="mw-content-ltr">table</span> )</code>
 
Kodas ujon kiel URIa peta ĉeno. Kiuo devus esti ĉenoj; kiomoj povas esti ĉenoj aŭ nombroj, sinsekvaj ujoj aŭ duopcia falso.
 
==== mw.uri.parseQueryString ====
<code style="white-space:nowrap">mw.uri.parseQueryString( signvicos, ekeroi, fineroj )</code>
 
<div class="mw-translate-fuzzy">
Malkodas la petan ĉenon <code>signvico</code> al ujo. Kiuoj en la ĉeno sen kiomoj havos falsan kiomon; kiuoj ripetitaj plujfoje havos sinsekvajn ujon kiel kiomoj; kaj aliaj havos ĉenojn kiel kiomoj.
</div>
 
<div class="mw-translate-fuzzy">
La opciaj nombraj kunvokatoj <code>ekero</code> kaj <code>finero</code> povas esti uzitaj por specifi subĉeno disponigebla, anstataŭ la tuta ĉeno. <code>ekero</code> estas la pozicio de la unua signo de la subĉeno kaj defaŭlte kiomas 1. <code>finero</code> estas la pozicio de la lasta signo de la subĉeno kaj defaŭlte kiomas la longecon de la ĉeno. Ambaŭ <code>ekero</code> kaj <code>finero</code> povas esti negativa, kiel en [[#string.sub$anchor|string.sub]].
</div>
 
==== mw.uri.canonicalUrl ====
<code style="white-space:nowrap">mw.uri.canonicalUrl( paĝo<span lang="en" dir="ltr" class="mw-content-ltr">page, petoquery</span> )</code>
 
Liveras [[#URI object|URIan objekton]] por la [[Special:MyLanguage/Help:Magic words#URL data|ĉefforma URLo]] de paĝo, kun opcia peta ĉeno/ujo.
 
==== mw.uri.fullUrl ====
<code style="white-space:nowrap">mw.uri.fullUrl( paĝo<span lang="en" dir="ltr" class="mw-content-ltr">page, petoquery</span> )</code>
 
Liveras [[#URI object|URIan objekton]] por la [[Special:MyLanguage/Help:Magic words#URL data|plena URLo]] de paĝo, kun opcia peta ĉeno/ujo.
 
==== mw.uri.localUrl ====
<code style="white-space:nowrap">mw.uri.localUrl( paĝo<span lang="en" dir="ltr" class="mw-content-ltr">page, petoquery</span> )</code>
 
Liveras [[#URI object|URIan objekton]] por la [[Special:MyLanguage/Help:Magic words#URL data|loka URLo]] de paĝo, kun opcia peta ĉeno/ujo.
 
==== mw.uri.new ====
<code style="white-space:nowrap">mw.uri.new( signvico<span lang="en" dir="ltr" class="mw-content-ltr">string</span> )</code>
 
Konstruas novan [[#URI object|URIan objekton]] por la pasita ĉeno aŭ ujo. Vidu la priskribon de URIaj objektoj por la eblaj kampoj en la ujo.
 
==== mw.uri.validate ====
<code style="white-space:nowrap">mw.uri.validate( ujo<span lang="en" dir="ltr" class="mw-content-ltr">table</span> )</code>
 
Konfirmas la pasitan ujon (aŭ URIan objekton). Liveras duopcion indikantan ĉu la ujo estis validita aŭ, kiam malsukcesas, ĉeno klariga kiuj problemoj estis trovitaj.
Line 3,597 ⟶ 3,617:
=== Unikodaĉena elordonteko ===
 
<div class="mw-translate-fuzzy">
La unikoda ĉena elordonteko celas esti rekta reefektivigo de la norma [[#String library|ĉena elordonteko]], escepte ke la statvojoj efikas laŭ signoj en UTF-8aj kodaj ĉenoj anstataŭ okopoj.
</div>
 
Plejpartoj de elstatoj pelos eraron se la ĉeno ne estas valida UTF-8; esceptoj estas notitaj.
Line 3,610 ⟶ 3,632:
<code style="white-space:nowrap">mw.ustring.byte( s, i, j )</code>
 
<div class="mw-translate-fuzzy">
Liveras unuopan duumokopon; identa al [[#string.byte$anchor|string.byte()]].
</div>
 
==== mw.ustring.byteoffset ====
<code style="white-space:nowrap">mw.ustring.byteoffset( s, l, i )</code>
 
<div class="mw-translate-fuzzy">
Liveras la okopan deŝovon de indicita signo en la ĉeno. Defaŭlte ambaŭ <code>loko</code> kaj <code>indico</code> tiomas <code>1</code>. <code>indico</code> povas esti negativa, en kiu kazo ĝi nombras ekde la fino de la ĉeno.
</div>
 
La signo ĉe <code>loko == 1</code> estas la unua signo komencanta ĉe aŭ post la okopo indicita per <code>indico</code>; la signo ĉe <code>loko == 0</code> estas la unua signo komencanta ĉe aŭ antaŭ okopo indicita per <code>indico</code>. Notu ke tio ĉi povas esti la sama signo. Pli grandaj aŭ malpliaj kiomoj de <code>loko</code> estas nombrita relative al ĉi tiuj.
Line 3,622 ⟶ 3,648:
<code style="white-space:nowrap">mw.ustring.char( ... )</code>
 
<div class="mw-translate-fuzzy">
Similege al [[#string.char$anchor|string.char()]], escepte ke la induktivoj estas unikodaj signonumeroj anstataŭ okopaj kiomoj.
</div>
 
<syntaxhighlight lang="lua">
Line 3,631 ⟶ 3,659:
<code style="white-space:nowrap">mw.ustring.codepoint( s, i, j )</code>
 
<div class="mw-translate-fuzzy">
Similige kiel [[#string.byte$anchor|<code>string.byte()</code>]], escepte ke la liverataj kiomoj estas signonumeroj kaj la deŝovoj estas signoj anstataŭ okopoj.
</div>
 
==== mw.ustring.find ====
<code style="white-space:nowrap">mw.ustring.find( s, pattern, init, plain )</code>
 
<div class="mw-translate-fuzzy">
Similige kiel [[#string.find$anchor1|string.find()]], escepte ke la skemo estas etendita kiel priskribita en [[#Ustring patterns|Unikodaĉenaj skemoj]] kaj la <code>ekero</code> deŝovo estas en signoj anstataŭ okopoj.
</div>
 
==== mw.ustring.format ====
<code style="white-space:nowrap">mw.ustring.format( <span lang="en" dir="ltr" class="mw-content-ltr">format</span>, ... )</code>
 
<div class="mw-translate-fuzzy">
Identa al [[#string.format$anchor|string.format()]]. Larĝoj kaj precizecoj por ĉenoj estas esprimitaj per okopoj, ne per signonumeroj.
</div>
 
==== mw.ustring.gcodepoint ====
<code style="white-space:nowrap">mw.ustring.gcodepoint( s, i, j )</code>
 
<div class="mw-translate-fuzzy">
Liveras tri kiomoj por tracikli laŭ la signonumeroj en la ĉeno. <code>ekero</code> defaŭltas al <code>1</code> kaj <code>finero</code> al <code>-1</code>. Tio estas celita por uzo en la [[#iterators|tracikla formo de <code>for</code> ]]:
</div>
 
<syntaxhighlight lang="lua">
Line 3,657 ⟶ 3,693:
<code style="white-space:nowrap">mw.ustring.gmatch( s, pattern )</code>
 
<div class="mw-translate-fuzzy">
Similige kiel [[#string.gmatch$anchor1|string.gmatch()]], escepte ke la skemo estas etendita kiel priskribita en [[#Ustring patterns|Unikodaĉenaj skemoj]].
</div>
 
{{red|Known bug}}: When used with a pattern which can match the empty string, the function will get stuck in an infinite loop. For example, the following loop never terminates:
Line 3,670 ⟶ 3,708:
<code style="white-space:nowrap">mw.ustring.gsub( s, pattern, repl, n )</code>
 
<div class="mw-translate-fuzzy">
Similige kiel [[#string.gsub$anchor1|string.gsub()]], escepte ke la skemo estas etendita kiel priskribita en [[#Ustring patterns|Unikodaĉenaj skemoj]].
</div>
 
<div lang="en" dir="ltr" class="mw-content-ltr">
Line 3,678 ⟶ 3,718:
 
==== mw.ustring.isutf8 ====
<code style="white-space:nowrap">mw.ustring.isutf8( s<span lang="en" dir="ltr" class="mw-content-ltr">string</span> )</code>
 
Liveras veran se la ĉeno estas valida UTF-8a ĉeno, falsan alie.
 
==== mw.ustring.len ====
<code style="white-space:nowrap">mw.ustring.len( s<span lang="en" dir="ltr" class="mw-content-ltr">string</span> )</code>
 
Liveras la longecon da signonumeroj de la ĉeno, aŭ <code>nil</code> se la ĉeno ne estas valida UTF-8a ĉeno.
 
<div class="mw-translate-fuzzy">
Vidu [[#string.len$anchor|string.len()]] por similaj elstatoj kiuj uzas okopaj longecoj anstataŭ signonumeroj.
</div>
 
==== mw.ustring.lower ====
<code style="white-space:nowrap">mw.ustring.lower( s<span lang="en" dir="ltr" class="mw-content-ltr">string</span> )</code>
 
<div class="mw-translate-fuzzy">
Similige kiel [[#string.lower$anchor|string.lower()]], escepte ke ĉiuj signoj kun difinoj de minusklo al majuklo en unikodo estas transusklataj.
</div>
 
<div class="mw-translate-fuzzy">
Se la [[#Language library|Lingva elordonteko]] estas ankaŭ ŝargita, tio anstataŭe vokos [[#mw.language:lc$anchor2|<code>lc()</code>]] por la defaŭlt-lingva objekto.
</div>
 
==== mw.ustring.match ====
<code style="white-space:nowrap">mw.ustring.match( s, pattern, init )</code>
 
<div class="mw-translate-fuzzy">
Similige kiel [[#string.match$anchor1|string.match()]], escepte ke la skemo priskribita en [[#Ustring patterns|Unikodaĉenaj skemoj]] kaj la <code>ekero</code> deŝovo estas en signoj anstataŭ okopoj.
</div>
 
==== mw.ustring.rep ====
<code style="white-space:nowrap">mw.ustring.rep( s<span lang="en" dir="ltr" class="mw-content-ltr">string, n</span> )</code>
 
<div class="mw-translate-fuzzy">
Identa al [[#string.rep$anchor|string.rep()]].
</div>
 
==== mw.ustring.sub ====
<code style="white-space:nowrap">mw.ustring.sub( s, i, j )</code>
 
<div class="mw-translate-fuzzy">
Similige kiel [[#string.sub$anchor|string.sub()]], escepte ke la deŝovoj estas signoj anstataŭ okopoj.
</div>
 
==== mw.ustring.toNFC ====
<code style="white-space:nowrap">mw.ustring.toNFC( s<span lang="en" dir="ltr" class="mw-content-ltr">string</span> )</code>
 
<div class="mw-translate-fuzzy">