Edición de «Plantilla:Str mid/doc»

{{Subpágina de documentación}}
{{Plantilla con Lua}}
=== Uso ===
La '''Plantilla Str mid''' devuelve una  parte de la <code><cadena></code> (parámetro 1) a partir de el <code><índice inicial></code> (parámetro 2) y la <code><longitud de la subcadena></code> a devolver en número de caracteres (parámetro 3) o indicando el <code><índice final></code> 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.

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

==== Ejemplos ====
:*<code><nowiki>{{str mid|Abcdefghijklmnopqrstuvwxyz|5|3}}</nowiki></code> &rarr; {{str mid|Abcdefghijklmnopqrstuvwxyz|5|3}}

Si se omite el parámetro 2, se devolverá a partir del primer caracter:
:*<code><nowiki>{{str mid|Abcdefghijklmnopqrstuvwxyz||5}}</nowiki></code> &rarr; {{str mid|Abcdefghijklmnopqrstuvwxyz||5}}

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:
:*<code><nowiki>{{str mid|Abcdefghijklmnopqrstuvwxyz|15}}</nowiki></code> &rarr; {{str mid|Abcdefghijklmnopqrstuvwxyz|15}}

=== Contando desde el final ===
Al introducir un valor negativo, el índice se cuenta desde el final:
*<code><nowiki>{{str mid|Abcdefghijklmnopqrstuvwxyz|-7|4}}</nowiki></code> &rarr; {{str mid|Abcdefghijklmnopqrstuvwxyz|-7|4}}
*<code><nowiki>{{str mid|Abcdefghijklmnopqrstuvwxyz|-7}}</nowiki></code> &rarr; {{str mid|Abcdefghijklmnopqrstuvwxyz|-7}}

=== Utilizando el índice del último caracter ===
Usando el parámetro {{Parámetro|4|n}} y omitiendo el  {{Parámetro|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:

*<code><nowiki>{{str mid|Abcdefghijklmnopqrstuvwxyz|5||7}}</nowiki></code> &rarr; {{str mid|Abcdefghijklmnopqrstuvwxyz|5||7}}

*<code><nowiki>{{str mid|1=Abcdefghijklmnopqrstuvwxyz|2=5|4=7}}</nowiki></code> &rarr; {{str mid|1=Abcdefghijklmnopqrstuvwxyz|2=5|4=7}}

=== Espacios en blanco ===
En la subcadena devuelta, los espacios en blanco intermedios se tienen en cuenta a la hora de contar:
*<code><nowiki>>{{str mid|Me gusta esto.|9|5}}<</nowiki></code> &rarr; >{{str mid|Me gusta esto.|9|5}}<
Si siguen siendo intermedios se mantiene en la subcadena devuelta:
*<code><nowiki>>{{str mid|Me gusta esto.|3|11}}<</nowiki></code> &rarr; >{{str mid|Me gusta esto.|3|11}}<
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.
:*<code><nowiki>>{{str mid| Me gusta esto |9|5}}<</nowiki></code> &rarr; >{{str mid| Me gusta esto |9|5}}<  
:Devolviendo toda la cadena. 
:*<code><nowiki>>{{str mid| Me gusta esto |1}}<</nowiki></code> &rarr; >{{str mid| Me gusta esto |1}}<  
:Si la subcadena a devolver es un espacio en blanco.
:*<code><nowiki>>{{str mid| Me gusta esto |3|1}}<</nowiki></code> &rarr; >{{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:
*<code><nowiki>{{str mid|Abcdefghijklmnopqrstuvwxyz|30}}</nowiki></code> &rarr; {{str mid|Abcdefghijklmnopqrstuvwxyz|30|ignore errors=false|categoría no=true}}
*<code><nowiki>{{str mid|Abcdefghijklmnopqrstuvwxyz|0|45}}</nowiki></code> &rarr; {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignore errors=false|categoría no=true}}
El mensaje de error se puede evitar usando: {{parámetro|ignorar error|true}} y no devolverá ningún resultado:
*<code><nowiki>{{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignorar error=true}}</nowiki></code> &rarr; {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignorar error=true}}

====Categoría de error====
* {{parámetro|categoría no|true}} - Para que no añada categoría cuando devuelve error.
* {{parámetro|categoría error|<nowiki>Tu nombre de la categoría</nowiki>}} establece la categoría que se añade cuando devuelve un error. 
::Los prefijos y sufijos <code><nowiki>[[Categoría:Wikipedia:  ]]</nowiki></code> se añaden automáticamente).
::Por defecto [[:Categoría:Wikipedia:Errores detectados por el módulo String]].

=== Véase también===
<includeonly>
{{Navegación modificadores de cadena }}
<!-- Coloca las categorías de la plantilla a continuación y los interwikis en Wikidata -->
[[Categoría:Wikipedia:Plantillas de manipulación de cadenas]]
</includeonly>