Module:String/doc/cs

{{#switch: {{Languages|Module:String/doc}}

{{Shared Template Warning|Module:String}} {{Module rating|release}} {{Module rating|protected}} Tento modul je určen k poskytování přístupu k základním funkcím řetězců.

Většinu zde poskytovaných funkcí lze vyvolat s pojmenovanými parametry, nepojmenovanými parametry nebo kombinací. Pokud jsou použity pojmenované parametry, MediaWiki z parametru automaticky odstraní všechny úvodní nebo koncové mezery. V závislosti na zamýšleném použití může být výhodné takové mezery buď zachovat nebo odstranit.



Celosvětové možnosti

 * Pokud je nastaveno na nebo 1, jakýkoli chybový stav bude mít za následek vrácený prázdný řetězec, nikoli chybovou zprávu.
 * Pokud je nastaveno na nebo 1, jakýkoli chybový stav bude mít za následek vrácený prázdný řetězec, nikoli chybovou zprávu.


 * Pokud dojde k chybě, určuje název kategorie, která má být zahrnuta do chybové zprávy. Výchozí kategorie je.
 * Pokud dojde k chybě, určuje název kategorie, která má být zahrnuta do chybové zprávy. Výchozí kategorie je.


 * Pokud je nastaveno na nebo 1, pokud dojde k chybě, nebude přidána žádná kategorie.
 * Pokud je nastaveno na nebo 1, pokud dojde k chybě, nebude přidána žádná kategorie.

Celkové testy pro tento modul jsou k dispozici na Module:String/testcases.

Tato funkce vrací délku cílového řetězce.

Použitíː



nebo



Parametry:


 * Řetězec, jehož délka se má hlásit
 * Řetězec, jehož délka se má hlásit


 * Tato funkce vrací podřetězec cílového řetězce se zadanými indexy.

Použitíː



nebo



Parametry:


 * Řetězec, jehož podmnožina se má vrátit
 * Řetězec, jehož podmnožina se má vrátit


 * První index podřetězce, který se má vrátit, má výchozí hodnotu 1.
 * První index podřetězce, který se má vrátit, má výchozí hodnotu 1.


 * Poslední index řetězce, který se má vrátit, je výchozí na poslední znak.
 * Poslední index řetězce, který se má vrátit, je výchozí na poslední znak.

Prvnímu znaku řetězce je přiřazen index 1. Pokud je i nebo j záporná hodnota, interpretuje se to stejně jako výběr znaku počítáním od konce řetězce. Hodnota -1 je tedy stejná jako výběr posledního znaku řetězce.

Pokud jsou požadované indexy mimo rozsah pro daný řetězec, je hlášena chyba.

Tato funkce vrací podřetězec ze zdrojového řetězce, který odpovídá zadanému vzoru.

Použitíː



nebo



Parametry:


 * Řetězec, který se má hledat
 * Řetězec, který se má hledat


 * Vzor nebo řetězec, který se má v řetězci najít
 * Vzor nebo řetězec, který se má v řetězci najít


 * Index ve zdrojovém řetězci pro zahájení vyhledávání. První znak řetězce má index 1. Výchozí hodnota je 1.
 * Index ve zdrojovém řetězci pro zahájení vyhledávání. První znak řetězce má index 1. Výchozí hodnota je 1.


 * V některých případech může být možné vytvořit více shod na jednom řetězci. To určuje, která shoda se má vrátit, přičemž první shoda je . Pokud je zadáno záporné číslo, vrátí se shoda počítaná od poslední shody.   je tedy stejný jako požadavek na poslední zápas. Výchozí hodnota je 1.
 * V některých případech může být možné vytvořit více shod na jednom řetězci. To určuje, která shoda se má vrátit, přičemž první shoda je . Pokud je zadáno záporné číslo, vrátí se shoda počítaná od poslední shody.   je tedy stejný jako požadavek na poslední zápas. Výchozí hodnota je 1.


 * Booleovský příznak označující, že vzor by měl být chápán jako prostý text a nikoli jako Lua (programovací jazyk) ve stylu regulárního výrazu. Výchozí hodnota je.
 * Booleovský příznak označující, že vzor by měl být chápán jako prostý text a nikoli jako Lua (programovací jazyk) ve stylu regulárního výrazu. Výchozí hodnota je.


 * Pokud není nalezena žádná shoda, vypíše místo chyby hodnotu "nomatch".
 * Pokud není nalezena žádná shoda, vypíše místo chyby hodnotu "nomatch".

Pokud jsou  nebo   mimo rozsah pro dotazovaný řetězec, pak tato funkce vygeneruje chybu. Chyba je také generována, pokud není nalezena žádná shoda. Pokud přidáte parametr, chyba bude potlačena a při každém selhání bude vrácen prázdný řetězec.

Informace o vytváření Lua vzorů, což je forma regulárního výrazu, viz:


 * Lua reference: Vzory - od verze 5.1

Tato funkce vrací jeden znak z cílového řetězce na pozici pos.

Použitíː



nebo



Parametry:


 * Řetězec, který se má hledat
 * Řetězec, který se má hledat


 * Index znaku, který se má vrátit
 * Index znaku, který se má vrátit

První znak má hodnotu indexu 1.

Pokud požadujete zápornou hodnotu, tato funkce vybere znak počítáním zpětně od konce řetězce. Jinými slovy  je totéž jako požadavek na poslední znak.

Požadovaná hodnota nula nebo hodnota větší než délka řetězce vrátí chybu.

Tato funkce umožňuje vyhledávat cílový řetězec nebo vzor v jiném řetězci.

Použitíː



nebo



Parameters:


 * The string to search
 * The string to search


 * The string or pattern to find within source
 * The string or pattern to find within source


 * The index within the source string to start the search, defaults to 1
 * The index within the source string to start the search, defaults to 1


 * Boolean flag indicating that target should be understood as plain text and not as a Lua-style regular expression, defaults to
 * Boolean flag indicating that target should be understood as plain text and not as a Lua-style regular expression, defaults to

This function returns the first index >= "start" where "target" can be found within "source". Indices are 1-based. If "target" is not found, then this function returns 0. If either "source" or "target" are missing / empty, this function also returns 0.

This function should be safe for UTF-8 strings.

This function allows one to replace a target string or pattern within another string.

Usage:



OR



Parameters:


 * The string to search
 * The string to search


 * The string or pattern to find within source
 * The string or pattern to find within source


 * The replacement text
 * The replacement text


 * The number of occurrences to replace; defaults to all
 * The number of occurrences to replace; defaults to all


 * Boolean flag indicating that pattern should be understood as plain text and not as a Scribunto ustring pattern (a unicode-friendly Lua-style regular expression); defaults to
 * Boolean flag indicating that pattern should be understood as plain text and not as a Scribunto ustring pattern (a unicode-friendly Lua-style regular expression); defaults to

Repeats a string n times.

Usage:



Parameters:


 * The string to repeat
 * The string to repeat


 * The number of repetitions.
 * The number of repetitions.

Example gives

}}
 * #default=