Plantía:Str mid/doc

De Wikipedia

Usu[editar la fonte]

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[editar la fonte]

  • {{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[editar la fonte]

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[editar la fonte]

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[editar la fonte]

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[editar la fonte]

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[editar la fonte]

  • |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.

Ver tamién[editar la fonte]