WikiSkripta:Sunny/Dokumentace/Procedury/DictionaryReplace

Procedura DictionaryReplace umožňuje podobnou funkcionalitu jako Speciální:ReplaceText, avšak namísto prosté náhrady jednoho řetězce za druhý umožňuje náhradu celé kolekce hodnot hodnotami z jiné kolekce.

Pokud tak například chcete nahradit všechny výrazy "DM 1. typu" výrazem "DM I. typu" a zároveň "DM 2. typu" výrazem "DM II. typu", můžete to pomocí této procedury udělat najednou a ne ve dvou krocích. Samozřejmě smysl tato procedura má až pokud potřebujete nahrazovat třeba pět a více dvojic hodnot.

Parametry

Fráze k vyhledání

• text hodnota (víceřádkový text)

Zde se zadávají hodnoty, které se mají nahradit. Na každý řádek musí být umístněna právě jedna hodnota.

Fráze k nahrazení

• text hodnota (víceřádkový text)

Zde se zadávají hodnoty, které mají nahradit hodnoty z prvního parametru. Hodnoty musí být uvedeny ve stejném pořadí, jako jejich stávající verze z prvního parametru (jinak řečeno, řádek číslo X z tohoto parametru nahradí řádek číslo X z předchozího parametru). Je možné použít i prázdný řádek pro odstranění původní hodnoty bez náhrady, avšak ten nesmí být nikdy umístěn na prvním ani posledním řádku (interpret jej jinak ořeže).

Oba tyto parametry musí mít stejný počet řádků, v opačném případě se vypíše pouze chybová hláška.

ID jmenného prostoru

Tento parametr je nutné vyplnit číslem jmenného prostoru, ve kterém se má nahrazování odehrát. Narozdíl od Speciální:ReplaceText je procedura DictionaryReplace limitována vždy jen na jeden jmenný prostor. Seznam jmenných prostorů a jejich čísel lze najít například zde (jedná se však o statický a neaktualizovaný seznam, měl by ale stačit pro drtivou většinu použití), vždy aktuální verze v o něco nevzhlednějším formátu je k dispozici zde jako výstup API.