Vikipedio:Lua/Moduloj/String/eo

El Vikipedio, la libera enciklopedio
Ŝablona programado Diskutoj Lua Testoj Subpaĝoj
Modulo Esperanto English

Modulo: Dokumentado

String estas modulo, kiu prilaboras signoĉenon aŭ redonas iujn informon pri iu eco de la signoĉeno.

Funkcioj por ŝablonoj[redakti fonton]

str.len
Estas funkcio, kiu redonas la longon de la donita signoĉeno. La sola parametro povas esti transdonata nenomita aŭ nomita kiel
  • s - signoĉeno.
str.sub
Estas funkcio, kiu redonas partan signoĉenon de la cela signoĉeno ekde la starta indekso ĝis la fina indekso. Ĉe tio la tri parametroj povas esti nenomitaj aŭ nomitaj kiel
  • s - cela signoĉeno,
  • i - starta indekso,
  • j - fina indekso.
Se i kaj/aŭ j estas malplenaj, tiam la defaŭlta valoro de s estas 1, dum ke ĉe j ĝi estas la lasta signo.
str.match
Estas funkcio, kiu redonas parton el la cela signoĉeno depende de la ceteraj parametroj. Ĉe tio ĝi uzas ses nenomitajn parametrojn aŭ la nomitajn parametrojn
  • s - cela signoĉeno,
  • pattern - serĉota signoĉeno,
  • start - starta indekso,
  • match - kelkfoje oni povas multobligi kongruon al unuopa signoĉeno. Tio precizigas kiun kongruon redoni, kie la unua kongruo estas match= 1. Se nea cifero estas donata, tiam kongruo redoniĝas per kalkulo ekde la lasta kongruo. El tio, match= -1 samas al peto de la lasta kongruo. Defaŭlte al 1.,
  • plain - flago, kiu influas la traktado de la serĉota signoĉeno,
  • nomatch - mesaĝo redonata, se nenio estis trovita. Defaŭlte aperas erarmesaĝo, se ĝi estas malplena.
str.pos
Estas funkcio, kiu redonas solan signon el la signoĉeno de la donita pozicio. Ĉe tio la du parametroj povas esti nenomitaj aŭ nomitaj kiel
  • target - signoĉeno
  • pos - serĉa pozicio.
str.find
Estas funkcio, kiu serĉas donitan signo(ĉenon) en alia signoĉeno. Ĉe tio la kvar parametroj povas esti nenomitaj aŭ nomitaj kiel
  • source - signoĉeno en kiu estu serĉata,
  • target - serĉota signoĉeno,
  • start - pozicio je kiu ekas la serĉado,
  • plain - flago, kiu difinas, ĉu la donita signoĉeno en target estas teksto. Ĝi defaŭlte estas true (vera).
Ĝi redonas la pozicion, se ĝi trovas ion, alie 0. Se source kaj/aŭ targe estas malplenaj aŭ mankas, ĝi ankaŭ redonas 0.
str.replace
Estas funkcio, kiu ebligas al oni anstataŭigi celan signoĉenon ene de alia signoĉeno. Ĉe tio la kvin parametroj povas esti nenomitaj aŭ nomitaj kiel
  • source - devena signoĉeno,
  • pattern - serĉota signoĉeno,
  • replace - anstataŭiga signoĉeno,
  • count - nombro de la aperoj, defaŭlte ĉiuj,
  • plain - flago, kiu difinas, ĉu la donita signoĉeno en pattern estas signoĉeno. Ĝi defaŭlte estas true (vera).
str.rep
Estas simpla funkcio por ebligi uzadon de Lua-funkcio string.rep al ŝablonoj. Ĉe tio la unua nenomita parametro difinas la signoĉenon, dum ke la dua difinas la ripetojn. Ĝi redonas la tutan signoĉenon ripete, se la dua parametro estas pli granda ol 1. Se la dua parametro ne estas difinita, tiam aperas erarmesaĝo.

Ekzemploj[redakti fonton]

str.len
* {{#invoke:String|len|ekzemplo|}}

redonas

  • 8
* {{#invoke:String|len|s=ekzemplo}}

redonas

  • 8
str.sub
* {{#invoke:String|sub|ekzemplo|2|5}}

redonas

  • kzem
* {{#invoke:String|sub|s=ekzemplo|i=2|j=5}}

redonas

  • kzem
str.match
* {{#invoke:String|match|ekzemplo|em|1|1|1|ne ekzistas io}}

redonas

  • em
* {{#invoke:String|match|s=ekzemplo|pattern=em|start=1
    |match=1|plain=1|nomatch=ne ekzistas io}}

redonas

  • em
str.pos
* {{#invoke:String|pos|ekzemplo|5}}

redonas

  • m
* {{#invoke:String|pos|target=ekzemplo|pos=5}}

redonas

  • m
str.find
* {{#invoke:String|find|ekzemplo|em|2|true}}

redonas

  • 4
* {{#invoke:String|find|source=ekzemplo|target=em|start=2|plain=true}}
str.replace
* {{#invoke:String|replace|ekzemplo|e|E|1|true}}
  • Ekzemplo
redonas
* {{#invoke:String|replace|source=ekzemplo|pattern=e|replace=E|count=1|plain=true}}

redonas

  • Ekzemplo
str.rep
* {{#invoke:String|rep|ekzemplo|3}}

redonas

  • ekzemploekzemploekzemplo


Ĝenerala biblioteko; ne limigita.

Dependeco[redakti fonton]

Neniu