La función List.RemoveItems devuelve una lista tras eliminar los elementos contenidos en otra lista.
List.RemoveItems(
list1 as list,
list2 as list
) as list
- list1: lista de la que eliminar elementos
- list2: lista conteniendo los elementos a eliminar
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.
En este ejemplo eliminamos de la lista {1..5} los elementos 2 y 5:
List.RemoveItems(
{1..5},
{2, 5}
)
List
Un clic en el enlace List nos muestra la lista devuelta:
En este segundo ejemplo intentamos eliminar los elementos 2 y 6 de la misma lista:
List.RemoveItems(
{1..5},
{2, 6}
)
List
La lista resultante es la siguiente:
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
El resultado es el siguiente:
Sin embargo, se pueden eliminar explícitamente:
List.RemoveItems(
{1..5, null},
{2, 6, null}
)
List
El resultado devuelto por la función es el siguiente:
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
La lista obtenida en este caso es la siguiente:
