List.RemoveItems

La función List.RemoveItems devuelve una lista tras eliminar los elementos contenidos en otra lista.

Sintaxis

List.RemoveItems(
    list1 as list,
    list2 as list
) as list

Parámetros
  • list1: lista de la que eliminar elementos
  • list2: lista conteniendo los elementos a eliminar
Información adicional

Los elementos a eliminar que no estén presentes en la lista list1 son ignorados. Cuando se elimina un elemento, se eliminan todas las instancias del elemento.

Los valores nulos son tratados como cualquier otro valor, pudiendo ser eliminados también.

Ejemplos

En este ejemplo eliminamos de la lista {1..5} los elementos 2 y 5:

List.RemoveItems(
    {1..5},
    {2, 5}
)

List

Función M List.RemoveItems

Un clic en el enlace List nos muestra la lista devuelta:

Función M List.RemoveItems

En este segundo ejemplo intentamos eliminar los elementos 2 y 6 de la misma lista:

List.RemoveItems(
    {1..5},
    {2, 6}
)

List

Función M List.RemoveItems

La lista resultante es la siguiente:

Función M List.RemoveItems

Comprobamos que el valor 2 se ha eliminado, pero que el valor 6, por no existir en la lista original, simplemente se ha ignorado.

Los valores nulos son tratados como cualquier otro valor. Por ejemplo, si existen en la lista original y no son eliminados explícitamente, se mantienen:

List.RemoveItems(
    {1..5, null},
    {2, 6}
)

List

Función M List.RemoveItems

El resultado es el siguiente:

Función M List.RemoveItems

Sin embargo, se pueden eliminar explícitamente:

List.RemoveItems(
    {1..5, null},
    {2, 6, null}
)

List

Función M List.RemoveItems

El resultado devuelto por la función es el siguiente:

Función M List.RemoveItems

Confirmamos que se ha eliminado el valor nulo.

Cuando eliminamos un elemento, eliminamos todas sus instancias. En el siguiente ejemplo, la lista original incluye dos valores "2", y ambos desaparecen si incluimos este valor en el segundo argumento:

List.RemoveItems(
    {1, 2, 2, 3, 4, 5},
    {2, 5}
)

List

Función M List.RemoveItems

La lista obtenida en este caso es la siguiente:

Función M List.RemoveItems
Categoría
Funciones de lista
Submitted by admin on Fri, 07/31/2020 - 20:05