Modul:String/doc

Radovi u tijeku!

Jedan vrijedni suradnik upravo radi na ovom članku! Mole se ostali suradnici da NE UREĐUJU članak dok je ova obavijest prisutna. Koristite stranicu za razgovor ako imate komentare i pitanja u vezi s člankom. Kada radovi budu gotovi predložak će ukloniti suradnik koji ga je postavio na članak! Predložak može svatko ukloniti ako 6 sati nije bilo promjena u članku i njegovoj stranici za razgovor.

Modul pruža osnovne operacije rada s tekstom.

Pogreške u sintaksi modula postavit će stranicu s pogreškom u kategoriju Kategorija:Pogreške u modulu String.

Sintaksa poziva: {{#invoke:string|funkcija|parametri}}

Funkcije

len

vraća duljinu stringa zadanog parametrom

{{#invoke:string|len|abcd}} -> 4

Razmaci na početku i kraju se ubrajaju u znakove:

{{#invoke:string|len|  abcd  }} -> 8

Ako parametar sadrži znak jednakosti, potrebno je upotrijebiti parametar s:

{{#invoke:string|len|s=ab=cd}} -> 5

Pri pozivu parametrom s, razmaci na početku i kraju se ne ubrajaju:

{{#invoke:string|len|s= ab=c d  }} -> 6

sub

vraća znakove između zadane početne i krajnje pozicije

{{#invoke:String|sub|puni_tekst|početna_pozicija|krajnja_pozicija}}

ili

{{#invoke:String|sub|s=puni_tekst|i=početna_pozicija|j=krajnja_pozicija}}

Primjeri:

{{#invoke:String|sub|abcdefghi}} → abcdefghi

{{#invoke:String|sub|s=abcdefghi}} → abcdefghi

{{#invoke:String|sub|abcdefghi|3}} → cdefghi

{{#invoke:String|sub|s=abcdefghi|i= 3}} → cdefghi

{{#invoke:String|sub|abcdefghi|3|4}} → cd

{{#invoke:String|sub|s=abcdefghi|i= 3|j= 4}} → cd

Negativna vrijednost parametara interpretira se kao brojenje od kraja

{{#invoke:String|sub|abcdefghi|-3}} → ghi

{{#invoke:String|sub|abcdefghi|2|-3}} → bcdefg

sublength

vraća znakove definirane početnom pozicijom i duljinom

{{#invoke:String|sublength|puni_tekst|početna_pozicija|duljina}}

ili

{{#invoke:String|sublength|s=puni_tekst|i=početna_pozicija|len=duljina}}

Primjeri:

{{#invoke:String|sublength|s= abcdefghi}} → abcdefghi

{{#invoke:String|sublength|s= abcdefghi|i= 3}} → defghi

{{#invoke:String|sublength|s= abcdefghi|i= 3|len= 4}} → defg

match

vraća dio teksta koji se poklapa sa zadanim uzorkom

{{#invoke:String|match|puni_tekst|uzorak|početna pozicija|broj poklapanja|tekst ili regex|poruka ako nema poklapanja}}

ili

{{#invoke:String|match|s=puni_tekst|pattern=uzorak|start=početna pozicija|match=broj poklapanja|plain=tekst ili regex|nomatch=poruka ako nema poklapanja}}

gdje je

• s - puni tekst u kojem tražimo uzorak
• pattern - uzorak ili string koji tražimo u punom tekstu
• start - indeks u punom tekstu od kojeg započinjemo pretragu [zadano 1]
• match - ako imamo isto poklapanje više puta u tekstu, definira broj poklapanja kojeg vraćamo (npr. broj 2 za drugo poklapanje od početka). Ako se unese negativan broj, funkcija tada broji od kraja teksta (npr. -1 vraća zadnje poklapanje od početka) [zadano 1]
• plain - definira oblik uzorka: vrijednost true shvaća uzorak kao čisti tekst, dok vrijednost false shvaća uzorak kao inačicu regularnog izraza koji koristi jezik Lua. Pogledajte detalje ovdje
• nomatch - definira vrijednost ili tekst ako uzorak nije pronađen. Ako ništa nije zadano, vraća ""
• '