Plantilla:Str mid

Documentación de la plantilla

Uso

La Plantilla Str mid devuelve una parte de la <cadena> (parámetro 1) a partir de el <índice inicial> (parámetro 2) y la <longitud de la subcadena> a devolver en número de caracteres (parámetro 3) o indicando el <índice final> en el parámetro 4 para lo cual hay que omitir el parámetro 3 (dejarlo en blanco o poner el número de parámetro).

El primer caracter a contar es el 1 y no cuenta los espacios en blanco finales o iniciales como tampoco aparecen si estos coinciden en el inicio o final de la subcadena a devolver.

{{Str mid|<cadena>|<índice inicial>|<longitud de la subcadena>|<índice final>}}

Ejemplos

• {{str mid|Abcdefghijklmnopqrstuvwxyz|5|3}} → Plantilla:Str mid/core

Si se omite el parámetro 2, se devolverá a partir del primer caracter:

• {{str mid|Abcdefghijklmnopqrstuvwxyz||5}} → Plantilla:Str mid/core

Si se omite el parámetro 3 se devuelve el resto de la cadena a partir del índice inicial dado con el parámetro 2:

• {{str mid|Abcdefghijklmnopqrstuvwxyz|15}} → Plantilla:Str mid/core

Contando desde el final

Al introducir un valor negativo, el índice se cuenta desde el final:

• {{str mid|Abcdefghijklmnopqrstuvwxyz|-7|4}} → Plantilla:Str mid/core
• {{str mid|Abcdefghijklmnopqrstuvwxyz|-7}} → Plantilla:Str mid/core

Utilizando el índice del último caracter

Usando el parámetro |4=n y omitiendo el |3=n (dejándolo en blanco o numerando los parámtros) se determina la subcadena a devolver a partir del índice inicial e índice final es decir las posiciones desde el principio de la cadena del primer y último caracter de la subcadena a devolver:

• {{str mid|Abcdefghijklmnopqrstuvwxyz|5||7}} → Plantilla:Str mid/core

• {{str mid|1=Abcdefghijklmnopqrstuvwxyz|2=5|4=7}} → Plantilla:Str mid/core

Espacios en blanco

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

• >{{str mid|Me gusta esto.|9|5}}< → >Plantilla:Str mid/core<

Si siguen siendo intermedios se mantiene en la subcadena devuelta:

• >{{str mid|Me gusta esto.|3|11}}< → >Plantilla:Str mid/core<

Pero los espacios en blanco inicial y final no se cuentan y desaparecen si tienen esa condición en la subcadena devuelta:

Si el inicio y final de la subcadena a devolver son espacios en blanco.

• >{{str mid| Me gusta esto |9|5}}< → >Plantilla:Str mid/core<

Devolviendo toda la cadena.

• >{{str mid| Me gusta esto |1}}< → >Plantilla:Str mid/core<

Si la subcadena a devolver es un espacio en blanco.

• >{{str mid| Me gusta esto |3|1}}< → >Plantilla:Str mid/core<

Mensajes de error

Cuando los rangos (ya sea el parémetro 2 o la longitud de la subcadena) están fuera de la cadena, se devuelve un mensaje de error:

• {{str mid|Abcdefghijklmnopqrstuvwxyz|30}} → Plantilla:Str mid/core
• {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45}} → Plantilla:Str mid/core

El mensaje de error se puede evitar usando: |ignorar error=true y no devolverá ningún resultado:

• {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignorar error=true}} → Plantilla:Str mid/core

Categoría de error

• |categoría no=true - Para que no añada categoría cuando devuelve error.
• |categoría error=Tu nombre de la categoría establece la categoría que se añade cuando devuelve un error.

Los prefijos y sufijos [[Categoría:Hispanopedia: ]] se añaden automáticamente).

Por defecto Categoría:Hispanopedia:Errores detectados por el módulo String.

Véase también

Esta documentación está transcluida desde Plantilla:Str mid/doc.
Los editores pueden experimentar en la zona de pruebas (crear) y en los casos de prueba (crear) de la plantilla.
Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.