Plantía:Str mid/doc

Esta plantía utiliza sintaxis de módulos Lua.

Antes de camudala, tendríes d'afayate coles funciones de la estensión Scribunto ya'l llinguaxe de programación Lua.

Usu

La Plantía Str mid devuelve una parte de la <cadena> (parámetru 1) a partir del <índiz inicial> (parámetru 2) y la <llonxitú de la subcadena> a devolver en númberu de carácteres (parámetru 3) o indicando l'<índiz final> nel parámetru 4 pa lo qu'hai qu'omitir el parámetru 3 (dexalu en blancu o poner el númberu de parámetru).

El primer carácter a contar ye'l 1 y nun cuenta los espacios en blancu finales o iniciales, como tampoco apaecen si estos coinciden nel principiu o final de la subcadena a devolver.

{{Str mid|<cadena>|<índiz inicial>|<llonxitú de la subcadena>|<índiz final>}}

Exemplos

{{str mid|Abcdefghijklmnopqrstuvwxyz|5|3}} → efg

Si s'omite'l parámetru 2, devolveráse a partir del primer carácter:

{{str mid|Abcdefghijklmnopqrstuvwxyz||5}} → Abcd

Si s'omite'l parámetru 3 devuélvese'l restu de la cadena a partir del índiz inicial dau col parámetru 2:

{{str mid|Abcdefghijklmnopqrstuvwxyz|15}} → opqrstuvwxyz

Contando dende'l final

Al introducir un valor negativu, l'índiz cuéntase dende'l final:

{{str mid|Abcdefghijklmnopqrstuvwxyz|-7|4}} → tuvw
{{str mid|Abcdefghijklmnopqrstuvwxyz|-7}} → tuvwxyz

Utilizando l'índiz del últimu carácter

Usando'l parámetru |4=n y omitiendo'l |3=n (dexándolo en blancu o numberando los parámetros) se determina la subcadena a devolver a partir del índiz inicial ya índiz final, esto ye, les posiciones dende'l principiu de la cadena del primer y últimu carácter de la subcadena a devolver:

{{str mid|Abcdefghijklmnopqrstuvwxyz|5||7}} → efg

{{str mid|1=Abcdefghijklmnopqrstuvwxyz|2=5|4=7}} → efg

Espacios en blancu

En la subcadena devuelta, los espacios en blancu intermedios se tienen en cuenta a la hora de contar:

>{{str mid|Gústame esto.|9|5}}< → >esto.<

Si siguen siendo intermedios mantiénse na subcadena devuelta:

>{{str mid|Gústame esto.|3|11}}< → >stame esto.<

Pero los espacios en blancu inicial y final nun se cuenten y desapaecen si tienen esa condición na subcadena devuelta:

Si'l principiu y final de la subcadena a devolver son espacios en blancu.

>{{str mid| Gústame esto |9|5}}< → >String Module Error: String subset index out of range<

Devolviendo tola cadena.

>{{str mid| Gústame esto |1}}< → >Gústame esto<

Si la subcadena a devolver ye un espaciu en blancu.

>{{str mid| Gústame esto |3|1}}< → >s<

Mensaxes d'error

Cuando los rangos (seya'l parámetru 2 o la llonxitú de la subcadena) tán fuera de la cadena, se devuelve un mensaxe d'error:

{{str mid|Abcdefghijklmnopqrstuvwxyz|30}} → String Module Error: String subset index out of range
{{str mid|Abcdefghijklmnopqrstuvwxyz|0|45}} → String Module Error: String subset index out of range

El mensaxe d'error puede evitase usando: |ignore errors=true y nun devolverá nengún resultáu:

{{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignore errors=true}} → String Module Error: String subset index out of range

Categoría d'error

|categoría no=true - Pa que nun añada categoría cuando devuelve error.
|categoría error=El nome de la categoría establez la categoría que s'añade cuando devuelve un error.

Los prefixos y sufixos [[Categoría:Wikipedia: ]] añádense automáticamente).

Predetermináu Categoría:Wikipedia:Errores detectaos pol módulu String.