Frange: Es crea la pàgina amb «Aquest mòdul proporciona accés a funcions bàsiques sobre cadenes (''strings''). La majoria d'aquestes funcions es poden invocar amb paràmetres amb nom, sense nom...».

2019-03-14T20:37:50Z

Es crea la pàgina amb «Aquest mòdul proporciona accés a funcions bàsiques sobre cadenes (''strings''). La majoria d'aquestes funcions es poden invocar amb paràmetres amb nom, sense nom...».

Pàgina nova

Aquest mòdul proporciona accés a funcions bàsiques sobre cadenes (''strings'').

La majoria d'aquestes funcions es poden invocar amb paràmetres amb nom, sense nom o una barreja. Si s'usen paràmetres amb nom cal tenir en compte que el Mediawiki elimina els espais en blanc inicials i finals del valor del paràmetre. Segons l'ús previst pot ser convenient tant conservar-los com eliminar-los.

Algunes funciones admeten paràmetres amb patrons Lua que són una mena d'[[expressions regulars]]. Vegeu en el manual: [[mw:Extension:Scribunto/Lua reference manual#Patterns|patterns]] i [[mw:Extension:Scribunto/Lua reference manual#Ustring patterns|Ustring patterns]].

Opcions globals:
* <code>ignore_errors</code>: posat a 'true' o 1, en cas d'error retorn una cadena buida en lloc del missatge d'error.
* <code>error_category</code>: si es detecta un error especifica el nom de la categoria a incloure amb el missatge d'error. Per defecte és [[:Categoria:Errors detectats pel mòdul String]].
* <code>no_category</code>: posat a 'true' o 1, no afegeix cap categoria si es genera un error.

Funcions:
;<code>len</code>:
Retorna la longitud de la cadena. Sintaxi:
:<code><nowiki>{{#invoke:string|len|</nowiki>''cadena''}}</code>
:<code><nowiki>{{#invoke:string|len|s=</nowiki>''cadena''}}</code>
Paràmetres:
:<code>s</code>: La cadena a trobar la seva longitud

;<code>sub</code>:
Retorna una subcadena de la cadena indicada en els índex especificats. Sintaxi:
:<code><nowiki>{{#invoke:string|sub|</nowiki>''cadena''|''índex inicial''|''índex final''}}</code>
:<code><nowiki>{{#invoke:string|sub|s=</nowiki>''cadena''|i=''índex inicial''|j=''índex final''}}</code>
Paràmetres:
:<code>s</code>: la cadena on extraure la subcadena
:<code>i</code>: índex inicial de la subcadena, per defecte 1, el primer caràcter de la cadena.
:<code>j</code>: índex final de la subcadena, per defecte la longitud total, fins l'últim caràcter.
Si qualsevol dels dos índexs tenen valor negatiu llavors comptarà des del final de la cadena. Així, -1 és l'índex de l'últim caràcter de la cadena. Si els índexs són superiors a la longitud de la cadena llavors reportarà un error.

;<code>match</code>:
Retorna una subcadena de la cadena indicada que coincideixi amb un patró especificat.
:<code><nowiki>{{#invoke:string|match|</nowiki>''cadena''|''patró''|''índex inicial''|''número coincidència''|''indicador text net''|''text no coincidència''}}</code>
:<code><nowiki>{{#invoke:string|match|s=</nowiki>''cadena''|pattern=''patró''|start=''índex inicial''|match=''número coincidència''|plain=''indicador text net''|nomatch=''text no coincidència''}}</code>
Paràmetres:
:<code>s</code>: cadena on es fa la cerca
:<code>pattern</code>: patró o cadena a cercar.
:<code>start</code>: índex de la cadena on començar a cercar, per defecte 1, el primer caràcter.
:<code>match</code>: si es troben múltiples coincidències, especifica quina d'elles retornar. Per defecte és 1, la primera coincidència trobada. Un número negatiu compta des del final, per tant match=-1 és l'última coincidència.
:<code>plain</code>: indica si el patró s'ha d'interpretar com a text net, per defecte 'false'.
:<code>nomatch</code>: en cas de no trobar cap coincidència, retorna el valor de "nomatch" en lloc d'un error.
Si el número <code>match</code> o l'índex <code>start</code> estan fora del rang de la cadena, llavors la funció genera un error. També genera un error si no troba cap coincidència. Amb el paràmetre global <code>ignore_errors=true</code> se suprimeix l'error i retorna una cadena buida.

;<code>pos</code>:
Retorna el caràcter de la cadena que es troba en la posició indicada.
:<code><nowiki>{{#invoke:string|pos|</nowiki>''cadena''|''índex''}}</code>
:<code><nowiki>{{#invoke:string|pos|target=</nowiki>''cadena''|pos=''índex''}}</code>
Paràmetres:
:<code>target</code>: cadena on cercar
:<code>pos</code>: índex del caràcter a retornar
El primer caràcter té l'índex 1. L'últim és -1, comptant des del final. Si età fora del rang de la cadena llavors retornarà un error.

;<code>find</code>:
Retorna la posició on es troba una cadena o patró cercant en una altra cadena.
:<code><nowiki>{{#invoke:string|find|</nowiki>''cadena''|''cerca''|''índex inicial''|''indicador text net''}}</code>
:<code><nowiki>{{#invoke:string|find|source=</nowiki>''cadena''|target=''cerca''|start=''índex inicial''|plain=''indicador text net''}}</code>
Paràmetres:
:<code>source</code>: cadena on cercar
:<code>target</code>: cadena a cercar o patró de cerca
:<code>start</code>: índex de la cadena font on començar a cercar, per defecte 1, el primer caràcter.
:<code>plain</code>: indica si la cerca s'ha d'interpretar com a text net, en cas contrari com a patró Lua. Per defecte és 'true'.
Retorna el primer índex, major o igual que "start", on "target" s'ha trobat a "source". Si no el troba retorna 0. Si "source" o "target" estan buits o indefinits també retorna 0. Se suposa que funciona bé amb cadenes [[UTF-8]].

;<code>replace</code>:
Permet reemplaçar una cadena o patró en una altra cadena.
:<code><nowiki>{{#invoke:string|replace|</nowiki>''cadena''|''patró''|''reemplaçament''|''comptador''|''indicador text net''}}</code>
:<code><nowiki>{{#invoke:string|replace|source=</nowiki>''cadena''|pattern=''patró''|replace=''reemplaçament''|count=''comptador''|plain=''indicador text net''}}</code>
Paràmetres:
:<code>source</code>: cadena on cercar
:<code>pattern</code>: cadena de cerca o patró a cercar
:<code>replace</code>: text de reemplaçament
:<code>count</code>: número d'ocurrències a reemplaçar, per defecte totes.
:<code>plain</code>: indica si la cerca s'ha d'interpretar com a text net, en cas contrari com a patró Lua. Per defecte és 'true'.

;<code>rep</code>:
Repeteix la cadena un número de vegades.
:<code><nowiki>{{#invoke:string|rep|</nowiki>''cadena''|''vegades''}}</code>
Paràmetres:
:<code>cadena</code>: cadena a repetir
:<code>vegades</code>: número de vegades a repetir
== Vegeu també ==
* [[Mòdul:StringFunc]]
<includeonly>
[[Categoria:Plantilles basades en el mòdul String| ]]
[[Categoria:Mòduls de la Viquipèdia]]
</includeonly>

Mòdul:String/ús - Historial de revisió

Frange: Es crea la pàgina amb «Aquest mòdul proporciona accés a funcions bàsiques sobre cadenes (''strings''). La majoria d'aquestes funcions es poden invocar amb paràmetres amb nom, sense nom...».