La función Splitter.SplitTextByLengths devuelve una función que divide el texto que recibe como argumento en bloques de una cierta longitud.
Splitter.SplitTextByLengths(
lengths as list,
optional startAtEnd as nullable logical
) as function
- lengths: longitudes de los bloques a extraer
- startAtEnd: (opcional) valor que determina si los bloques se forman desde el comienzo del texto o desde el final
Si el parámetro startAtEnd toma el valor true, los grupos comenzarán a crearse desde el final de la cadena de texto.
Si el texto tiene una longitud mayor que la suma de las longitudes indicadas, los caracteres no incluidos en ningún bloque se ignoran.
Si el texto tiene una longitud menor que la especificada por la suma de longitudes, el último bloque solo incluirá hasta el final del texto o bien se incluirá algún nuevo bloque vacío (véanse ejemplos).
En este primer ejemplo partimos del texto "abcdefghijklmnopqrstuvwxyz" y lo dividimos en tres bloques de longitudes 1, 2 y 3, respectivamente. Como el texto tiene una longitud mayor de 6 (1+2+3), los caracteres sobrantes se ignoran:
let
text = "abcdefghijklmnopqrstuvwxyz"
in
Splitter.SplitTextByLengths(
{1, 2, 3}
)(text)
Siguiendo con el mismo ejemplo, ahora extraemos 99 caracteres del tercer bloque. Como no hay tantas letras en el texto, simplemente se devuelven las letras hasta el final del texto:
let
text = "abcdefghijklmnopqrstuvwxyz"
in
Splitter.SplitTextByLengths(
{1, 2, 99}
)(text)
En este tercer ejemplo extraemos los mismos bloques que en el caso anterior más un bloque adicional (que no existe pues ya se ha comentado que el texto no tiene la suficiente longitud). Este cuarto bloque se muestra como un texto vacío en el resultado:
let
text = "abcdefghijklmnopqrstuvwxyz"
in
Splitter.SplitTextByLengths(
{1, 2, 99, 4}
)(text)
Si el parámetro startAtEnd toma el valor true, los grupos comenzarán a crearse desde el final de la cadena de texto:
let
text = "abcdefghijklmnopqrstuvwxyz"
in
Splitter.SplitTextByLengths(
{1, 2, 3},
true
)(text)
