La función Splitter.SplitTextByPositions devuelve una función que divide el texto que recibe como argumento en bloques definidos por su posición.
Splitter.SplitTextByPositions(
positions as list,
optional startAtEnd as nullable logical
) as function
- positions: lista de índices o posiciones que marcan el comienzo de cada bloque
- startAtEnd: (opcional) valor que determina si los bloques se forman desde el comienzo del texto o desde el final.
El primer carácter recibe el índice el índice 0.
Si el parámetro startAtEnd toma el valor true, los grupos comenzarán a crearse desde el final de la cadena de texto, en cuyo caso es el último carácter el que recibe el índice cero y los índices irán creciendo según nos movemos por el texto de derecha a izquierda.
Si algún bloque queda definido por una posición inexistente, quedará representado por un texto vacío (véase ejemplo).
En este ejemplo partimos del texto "abcdefghijklmnopqrstuvwxyz" y lo dividimos en tres bloques que comienzan en los caracteres que ocupan las posiciones 2, 5 y 10:
let
text = "abcdefghijklmnopqrstuvwxyz"
in
Splitter.SplitTextByPositions(
{2, 5, 10}
)(text)
Siguiendo con el mismo ejemplo, si creamos un cuarto bloque cuya posición de inicio quede más allá del final del texto, este bloque quedará representado por una cadena de texto vacía:
let
text = "abcdefghijklmnopqrstuvwxyz"
in
Splitter.SplitTextByPositions(
{2, 5, 10, 99}
)(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.SplitTextByPositions(
{2, 5, 10},
true
)(text)
