Modulo:String/man: differenze tra le versioni

Alcune funzioni possono ritornaredare un messaggio di errore o impostare una categoria di errori, la generazione di questo messaggio e/o la creazione dei questa categoria possono essere controllate dalle seguenti opzioni.

:''ignore_errors'': se impostato a 1 o 'true' ogni condizione di errore ritorneràdarà una stringa vuota piuttosto che un messaggio di errore.

Questa funzione ritornarestituisce la lunghezza di una stringa.

:*''s'': La stringa di cui ritornarerestituire la lunghezza

Questa funzione ritornarestituisce la sottostringa di una stringa bersaglio, come indicato dagli indici

:*''s'': La stringa da cui estrarre una sottostringa

:*''i'': La posizione iniziale del primo carattere della sottostringa da ritornarerestituire, se non specificato è 1.

:*''j'': La posizione finale dell'ultimo carattere della sottostringa da ritornarerestituire, se non specificato corrisponde alla lunghezza della stringa_bersaglio (l'ultimo carattere).

Se le posizioni sono al di fuori degli estremi della stringa viene ritornatorestituito un messaggio di errore.

Questa funzione ritornarestituisce dallauna stringasottostringa bersagliodella unastringa sottostringabersaglio corrispondente a un [[#Documentazione sui pattern Lua|pattern]] specificato.

:*''s'': la stringa da cercare

:*''pattern'': il pattern da cercare nella stringa ''s''

:*''start'': la posizione iniziale da cui iniziare la ricerca, se non specificato è 1.

;*''match'': se c'è ci sono corrispondenze multiple, quale ritornare,restituire: 1 per la prima corrispondenza, 2 per la seconda ecc.. Un valore negativo indica di contare all'indietro a partire dall'ultima corrispondenza, quindi ''match'' = -1 significa chiedere l'ultima corrispondenza. Se non specificato è 1

:*''plain'': se vero specifica che il pattern deve essere considerato come una stringa normale, piuttosto che un pattern Lua. Se non specificata è falso.

;*''nomatch'': il valore da ritornarerestituire se non ci sono corrispondenze, invece di ritornare un errore.

Se ''match'' o ''start'' sono al di fuori degli estremi della stringa ''s'', allora la funzione ritornarestituisce un errore. Viene generato un errore anche se il non vengono trovate corrispondenze. Per sopprimere gli errori si può aggiungere il parametro ''ignore_errors''=true, in questo caso in caso di errore verrà ritornatarestituita una stringa vuota.

Questa funzione ritornarestituisce il carattere della stringa in posizione pos.

:*''target'': la stringa in cui cercare

:*''pos'': la posizione del carattere da ritornarerestituire

Se la posizione richiesta è 0 o al di fuori degli estremi della stringa viene ritornatorestituito un errore.

:* ''source'': la stringa in cui cercare

:* ''target'': la stringa da cercare

RitornaRestituisce la posizione nella stringa ''source'' del primo carattere in cui c'è è stata trovata la tringa ''target''. I caratteri della stringa sono numerati a partire da 1. La funzione ritornarestituisce -1 se la stringa ''target'' non è contenuta in ''source''.

Nota importante: Per compatibilità con il vecchio template, se la stringa ''target'' è vuota o manca, la funzione restituisce il valore "1"

:*''source'': la stringa in cui cercare

:*''target'': la stringa o pattern Lua da cercare

:*''start'': la posizione da cui iniziare la ricerca, se non specificato è 1

:*''plain'': Se è vero indica che la stringa ''target'' deve essere considerata come unaun testo normale e non come un pattern Lua, se non specificata è vera

Questa funzione ritornarestituisce la prima posizione maggiore o uguale a ''start'' a partire dalla quale ''target'' si trova in ''source''. I caratteri della stringa sono numerati a partire da 1. Se ''target'' non viene trovato ritornadà 0. Se ''source'' o ''target'' sono mancanti o vuoti ritornadà 0.

:*''source'': la stringa dain cui cercare

:*''pattern'': la stringa o pattern Lua da trovare in ''source''

:*''replace'': il testo di sostituzione

:*''count'': il numero di volte in cui rimpiazzare la stringa, se non specificato tutte.

:*''plain'': se vero indica che il pattern deve essere considerato come testo normale e non come pattern Lua, il valore di default è vero

:*''par1'' .. ''par''n: il nome base delle variabili da unire, deve contenere il carattere '#' che precisa la posizione in cui inserire l'indice. Ad esempio se par1 è "Param#", la funzione unirà i valori della lista di parametri Param''1'', Param''2'', Param''3''... Il parametro "Param" (senza numero) è considerato coincidente con "Param1" (questo comportamento può essere modificato con il parametro "baseIndex"

:*''msg'': formattazione da applicare ai parametri. Il simbolo $n fa da segnaposto per il parametro "par''n''". &Egrave; possibile inserire codice mediawiki, ma eventuali caratteri "{" e "}" dovranno essere preceduti da "\", mentre il carattere "|" dovrà essere inserito con <nowiki>{{!}}</nowiki>

:*''separatore'': una stringa (opzionale) da inserire tra ogni valore

:*''congiunzione'': una stringa (opzionale) da inserire al posto del ''separatore'' tra l'ultimo e il penultimo valore. Se non dichiarato viene usato il valore di separatore

:*''Nmin'': indice iniziale da cui partire a scandire i parametri (di default pari a 1)

:*''Nmax'': indice massimo a cui arrivare con i parametri (se non precisato illimitato)

:*''baseIndex'': valore dell'indice dei parametro che coincide con il parametro senza indice (normalmente =1, quindi i parametri "par1" e "par" sono coincidenti, se per esempio viene impostato =0 allora "par0" è uguale a "par")

:*''lista'': se valorizzato come "infobox" formatta l'elenco di valori come una lista non ordinata (i valori di "separatore" e "congiunzione" sono ignorati) se ci sono almeno due valori, altrimenti restituisce solo il primo valore senza inserirlo in una lista