Splitter.SplitTextByLengths

La función Splitter.SplitTextByLengths devuelve una función que divide el texto que recibe como argumento en bloques de una cierta longitud.

Sintaxis

Splitter.SplitTextByLengths(
    lengths as list,
    optional startAtEnd as nullable logical
) as function

Parámetros
  • 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
Información adicional

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

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)

Función M Splitter.SplitTextByLengths

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)

Función M Splitter.SplitTextByLengths

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)

Función M Splitter.SplitTextByLengths

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)

Función M Splitter.SplitTextByLengths
Categoría
Funciones de separación
Enviado por admin el Jue, 03/09/2020 - 17:41