Модул:Стринг/док

Модул пружа основне операције рада с текстом.

Погрешке у синтакси модула поставит ће страницу с погрешком у категорију Категорија:Грешке које пријављује модул Стринг.

Синтакса позива: {{#invoke:string|funkcija|parametri}}

Глобални параметри

У свакој од нижих функција можете користити и параметре:

игноре_еррорс - ако је вриједност постављена на труе или 1, ако дође до погрешке, умјесто поруке о погрешци приказат ће се празни стринг ("").

еррор_цатегорy - ако се догоди погрешка, страница ће бити постављена у категорију задану овим параметром, умјесто у Категорија:Грешке које пријављује модул Стринг.

но_цатегорy - ако је вриједност постављена на труе или 1, ако дође до погрешке, страница се неће поставити у категорију Категорија:Грешке које пријављује модул Стринг.

лен

враћа дуљину стринга заданог параметром

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

Размаци на почетку и крају се убрајају у знакове:

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

Ако параметар садржи знак једнакости, потребно је употријебити параметар с:

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

При позиву параметром с, размаци на почетку и крају се не убрајају:

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

суб

враћа знакове између задане почетне и крајње позиције

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

или

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

Примјери:

{{#invoke:String|sub|abcdefghi}} → абцдефгхи

{{#invoke:String|sub|s=abcdefghi}} → абцдефгхи

{{#invoke:String|sub|abcdefghi|3}} → цдефгхи

{{#invoke:String|sub|s=abcdefghi|i= 3}} → цдефгхи

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

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

Негативна вриједност параметара интерпретира се као бројење од краја

{{#invoke:String|sub|abcdefghi|-3}} → гхи

{{#invoke:String|sub|abcdefghi|2|-3}} → бцдефг

субленгтх

враћа знакове дефиниране почетном позицијом и дуљином

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

или

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

Примјери:

{{#invoke:String|sublength|s= abcdefghi}} → абцдефгхи

{{#invoke:String|sublength|s= abcdefghi|i= 3}} → дефгхи

{{#invoke:String|sublength|s= abcdefghi|i= 3|len= 4}} → дефг

матцх

враћа дио текста који се поклапа са заданим узорком

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

или

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

гдје је

• с - пуни текст у којем тражимо узорак
• паттерн - узорак или стринг који тражимо у пуном тексту
• старт - индекс у пуном тексту од којег започињемо претрагу [задано 1]
• матцх - ако имамо исто поклапање више пута у тексту, дефинира број поклапања којег враћамо (нпр. број 2 за друго поклапање од почетка). Ако се унесе негативан број, функција тада броји од краја текста (нпр. -1 враћа задње поклапање од почетка) [задано 1]
• плаин - дефинира облик узорка: вриједност труе схваћа узорак као чисти текст, док вриједност фалсе схваћа узорак као иначицу регуларног израза који користи језик Луа. Погледајте детаље овдје
• номатцх - дефинира вриједност или текст ако узорак није пронађен. Ако ништа није задано, враћа ""

Примјери:

{{#invoke:String|match|abc123def456|%d+}} → 123

{{#invoke:String|match|s=abc123def456|pattern=%d+}} → 123

{{#invoke:String|match|abc123def456|%d+|5}} → 23

{{#invoke:String|match|s=abc123def456|pattern=%d+|start=6}} → 3

{{#invoke:String|match|s=abc123def456|pattern=%d+|start=6|match=2}} → 456

{{#invoke:String|match|s=abc123%d+|pattern=%d+}} → 123

{{#invoke:String|match|s=abc123%d+|pattern=%d+|plain=true}} → %д+

{{#invoke:String|match|s=abc|pattern=%d}} →

{{#invoke:String|match|s=abc|pattern=%d|nomatch=Nisu pronađene brojčane vrijednosti}} → Нису пронађене бројчане вриједности

{{#invoke:String|match|s=abc|pattern=%d|ignore_errors=true}} →

{{#invoke:String|match|s=0012001200|pattern=0*(%d*)}} → 12001200

пос

враћа један знак са задане позиције

{{#invoke:String|pos|puni tekst|broj pozicije}}

или

{{#invoke:String|pos|target=puni tekst|pos=broj pozicije}}

Напомене:

Негативна вриједност параметра интерпретира се као бројење од краја умјесто од почетка

Примјери

{{#invoke:String|pos|abcdefg|4}} → д

{{#invoke:String|pos|target=abcdefgh|pos=3}} → ц

{{#invoke:String|pos|abc|10}} →

стр_финд

функција је доступна због назадне компатибилности с постојећим кодом, но не препоруча се њено кориштење. Умјесто ње молим користите функцију финд описану ниже.

финд

враћа позицију текста који се поклапа са заданим узорком

{{#invoke:String|find|puni_tekst|uzorak|početna pozicija|tekst ili regex}}

или

{{#invoke:String|find|source=puni_tekst|target=uzorak|start=početna pozicija|plain=tekst ili regex}}

гдје је

• соурце - пуни текст у којем тражимо узорак
• таргет - узорак или стринг који тражимо у пуном тексту
• старт - индекс у пуном тексту од којег започињемо претрагу [задано 1]
• плаин - дефинира облик узорка: вриједност труе схваћа узорак као чисти текст, док вриједност фалсе схваћа узорак као иначицу регуларног израза који користи језик Луа. Погледајте детаље овдје

Примјери:

{{#invoke:String|find|abc123def|12}} → 4

{{#invoke:String|find|source=abc123def|target=12}} → 4

{{#invoke:String|find|source=abc123def|target=pqr}} → 0

{{#invoke:String|find|abc123def|123}} → 4

{{#invoke:String|find|source=abc123def|target= 123}} → 4

{{#invoke:String|find|source=abc123def|target=%d|start=3|plain=false}} → 4

реплаце (гсуб)

Ова функција омогућава замјену једног низа или узорка знакова другим. Напомена Луа програмерима: ова функција ради интерно позивањем mw.ustring.gsub.