Plantilla:Str mid

Documentación de plantilla

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.

Sintaxis

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

Ejemplos

{{str mid|Abcdefghijklmnopqrstuvwxyz|5|3}} → efg
{{str mid|Abcdefghijklmnopqrstuvwxyz||5}} → Abcd (Si se omite el parámetro 2, se devolverá a partir del primer caracter)
{{str mid|Abcdefghijklmnopqrstuvwxyz|15}} → opqrstuvwxyz (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|-7|4}} → tuvw (Al introducir un valor negativo, el índice se cuenta desde el final)
{{str mid|Abcdefghijklmnopqrstuvwxyz|-7}} → tuvwxyz (Al introducir un valor negativo, el índice se cuenta desde el final)

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}} → efg

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

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}}< → >esto<

Si siguen siendo intermedios se mantiene en la subcadena devuelta:

>{{str mid|Me gusta esto.|3|11}}< → >gusta esto<

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}}< → >esto<

Devolviendo toda la cadena.

>{{str mid| Me gusta esto |1}}< → >Me gusta esto<

Si la subcadena a devolver es un espacio en blanco.

>{{str mid| Me gusta esto |3|1}}< → ><

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}} → String Module Error: String subset index out of range
{{str mid|Abcdefghijklmnopqrstuvwxyz|0|45}} → String Module Error: String subset index out of range

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}} →

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:Wikilibros: ]] se añaden automáticamente).

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

Véase también

Plantillas de manipulación de cadenas
Recorte	{{Str mid}} – Devuelve una subcadena, especificando su posición y longitud. {{Trunc}} – Recorta hasta un número especificado de caracteres. {{Trim}} – Quita los espacios en blanco al inicio o al final de una cadena. {{Str left}} – Devuelve un número de caracteres desde la izquierda. {{Str right}} – Devuelve un número de caracteres desde la posición indicada. {{Str rightc}} – Devuelve un número de caracteres desde la derecha. {{Str index}} – Devuelve el caracter ubicado en la posición indicada. {{Str sub}} – Devuelve un número específico de caracteres, a partir de un índice inicial y el número de caracteres a devolver.	{{Quitar palabras hasta}} - Quita palabras enteras hasta un número específico de caracteres. {{Quitar primera palabra}} – Elimina la primera palabra de una cadena. {{Quitar última palabra}} - Elimina la última palabra de una cadena. {{Primera palabra}} – Devuelve la primera palabra. {{Última palabra}} – Devuelve la última palabra. {{Str letter/trim}} - Recorta hasta las primeras letras. {{Str number/trim}} - Recorta hasta los primeros números. {{Str crop}} – Para recortar un número especificado de caracteres del final.
Analizar cadenas	{{Str endswith}} – Comprueba si una cadena termina con una cadena determinada. {{Str find}} – Devuelve la posición numérica de una cadena dada respecto a la cadena analizada. {{Str sub find}} – Busca una subcadena en una cadena dada en el desplazamiento. {{Str letter}} – Devuelve el número de letras seguidas que hay al inicio de la cadena. {{Str number}} – Devuelve el número de números seguidos que hay al inicio de la cadena.
Insertar cadenas	{{Reemplazar}} – Devuelve la cadena, después de reemplazar todas las ocurrencias de una cadena especificada por otra cadena. {{Strloc prefix}} – Extrae una cadena del prefijo hasta la ubicación strloc o la cadena entera si strloc <= 0.
Comparación de longitud de cadenas	{{Str len}} – Devuelve la longitud de una cadena de texto. {{Str ≥ len}} – Comprueba si una cadena es "más larga o igual" o "más corta" de un tamaño determinado.. {{Str ≤ len}} – Comprueba si una cadena es "más corta o igual" o "más larga" de un tamaño determinado. {{Str ≠ len}} – Comprueba si una cadena es "diferente" o "igual" de un tamaño determinado. {{Str ≤ ≥ len}} – Comprueba si una cadena es "más corta", "igual", o "más larga" de un tamaño determinado.
Plantillas específicas	{{Título sin coletilla}} – Recorta el texto entre paréntesis al final de una cadena. (desambiguaciones). {{Texto de la coletilla del título}} – Devuelve el texto entre paréntesis al final de una cadena (desambiguación). {{Mayúscula}} - Devuelve una cadena con la primera letra en mayúsculas teniendo en cuenta el texto de la edición y no el código fuente. {{Desvincular}} – Elimina wikienlaces entre corchetes (wikicódigo).
Cuestiones técnicas	Módulo:String Ayuda: Palabras mágicas – Sobre `{{padleft:\|}}`. Ayuda: Extensión Pasers Fuction (modificadores de funciones) – Sobre `{{#titleparts:\|}}, {{#expr:\|}}, {{#ifeq:\|}},` etc.
Plantillas de manipulación de cadenas - Plantillas de manipulación de cadenas en Meta - Plantillas de manipulación de cadenas en Commons

Esta documentación está transcluida desde Plantilla:Str mid/uso.