# Funciones `list.*` de 2.0 **Nuevas en 2.0.** Están en `functions.dkh` (clase `Devkron.Functions.Lists`) y trabajan sobre las mismas listas (`List`) que `list.create`, `split`, `from.json` y los bloques `$$`. - **Índices negativos**: `-1` es el último elemento, `-2` el penúltimo… En las inserciones, `count` o `-1` significan "al final". - **Altas tipadas**: el valor no pasa por la tabla de objetos, así que `"3"` sigue siendo la cadena `"3"`. `list.add` con un número entero inserta **el objeto** con ese índice, como en 1.x; desde 2.0.4, una cadena (aunque sea numérica) o un número con decimales se agregan como valor. - Fuera de rango, lista nula o un objeto que no es lista dan un error con el nombre de la función. | Función | Devuelve | Notas | |---|---|---| | `list.addstr(l, cadena)` | número de elementos | agrega una cadena | | `list.addnum(l, número)` | número de elementos | agrega un número | | `list.addobj(l, ref)` | número de elementos | agrega un objeto; una cadena o un número es error | | `list.addnull(l)` | número de elementos | agrega un nulo | | `list.insstr(l, i, cadena)` | número de elementos | inserta en `i` (negativos; `count` o `-1` = al final) | | `list.insnum(l, i, número)` | número de elementos | ídem | | `list.insobj(l, i, ref)` | número de elementos | ídem, con un objeto | | `list.setstr(l, i, cadena)` | número de elementos | reemplaza el elemento `i` | | `list.setnum(l, i, número)` | número de elementos | ídem | | `list.atstr(l, i)` | cadena | elemento `i` (negativos) | | `list.atnum(l, i)` | número | ídem | | `list.atobj(l, i)` | objeto (use `ref`) | ídem | | `list.get(l, i)` | cadena, número u objeto | según el tipo del elemento; nulo si es nulo. Para objetos use `ref` | | `list.type(l, i)` | 0 nulo, 1 cadena, 2 número, 3 objeto | mismos códigos que `vartype` | | `list.remove(l, i)` | número de elementos | quita el elemento `i` (negativos) | | `list.merge(destino, origen)` | número de elementos del destino | agrega al final los elementos de `origen` (copia superficial; `list.merge(l, l)` funciona) | | `list.copy(l)` | lista nueva | copia superficial (los objetos anidados se comparten) | | `list.slice(l, desde, cuantos)` | lista nueva | `desde` admite negativos; `cuantos` se recorta; `cuantos` negativo = hasta el final | | `list.join(l, sep)` | cadena | elementos separados por `sep` (números con punto decimal) | | `list.split(texto, sep)` | lista de cadenas | como `split` | | `list.indexstr(l, cadena)` | posición o -1 | primera cadena igual | | `list.indexnum(l, número)` | posición o -1 | primer número igual | | `list.of(a, b, …)` | lista nueva | hasta 16 valores; cadenas y números conservan su tipo; una variable `ref` llega como su índice | ## Altas y tipo de cada elemento ```dkl ref l = list.create() do print(list.addstr(l, "3")) do print(list.addnum(l, 3)) do print(list.addnull(l)) new r {$$ "k": 1 $$} do print(list.addobj(l, r)) do print(to.json(l)) do print(list.type(l, 0)) do print(list.type(l, 1)) do print(list.type(l, 2)) do print(list.type(l, -1)) ``` ```text 1 2 3 4 ["3",3,null,{"k":1}] 1 2 0 3 ``` Comparación con `list.add`: ```dkl ref l = list.create() do list.add(l, 3) do list.add(l, "3") do list.add(l, "hola") do list.addnum(l, 3) do print(to.json(l)) ``` ```text [{},"3","hola",3] ``` Hasta 2.0.3, `list.add(l, "3")` también agregaba el objeto 3 (`[{},{},"hola",3]`). ## Inserción, reemplazo y borrado con índices negativos ```dkl ref l = list.of("a", "b", "c") do print(list.insstr(l, 0, "inicio")) do list.insnum(l, -1, 99) do list.insstr(l, -2, "penultimo") new r {$$ "k": 1 $$} do list.insobj(l, 1, r) do print(to.json(l)) do list.setstr(l, -1, "fin") do list.setnum(l, 0, 5) do print(to.json(l)) do print(list.remove(l, 1)) do print(to.json(l)) ``` ```text 4 ["inicio",{"k":1},"a","b","c","penultimo",99] [5,{"k":1},"a","b","c","penultimo","fin"] 6 [5,"a","b","c","penultimo","fin"] ``` ## Lectura: atstr, atnum, atobj, get ```dkl ref l = list.of("a", 2.5, "c") do print(list.atstr(l, 0)) do print(list.atnum(l, 1) * 2) do print(list.atstr(l, -1)) new r {$$ "k": 1 $$} do list.addobj(l, r) ref o = list.atobj(l, -1) do print(to.json(o)) x = list.get(l, 1) do print(x + 1) y = list.get(l, 0) do print(y + "!") ref z = list.get(l, -1) do print(to.json(z)) ``` ```text a 5.0 c {"k":1} 3.5 a! {"k":1} ``` ## Combinar, copiar, rebanar, unir, dividir y buscar ```dkl ref a = list.of(1, 2) ref b = list.of("x") do print(list.merge(a, b)) do print(to.json(a)) ref c = list.copy(a) do list.clear(a) do print(str(list.count(a)) + " " + to.json(c)) do print(to.json(list.slice(c, 1, 2))) do print(to.json(list.slice(c, -2, 5))) do print(to.json(list.slice(c, 0, -1))) do print(list.join(c, " | ")) ref s = list.split("a,b,,c", ",") do print(to.json(s)) do print(list.indexstr(s, "c")) do print(list.indexnum(c, 2)) do print(list.indexnum(c, 7)) ``` ```text 3 [1,2,"x"] 0 [1,2,"x"] [2,"x"] [2,"x"] [1,2,"x"] 1 | 2 | x ["a","b","","c"] 3 1 -1 ``` ## list.of ```dkl do print(to.json(list.of("3", 3, 1.5))) ref v = list.of() do print(list.count(v)) new r {$$ "k": 1 $$} ref l = list.of(r, "a") do print(to.json(l)) ``` ```text ["3",3,1.5] 0 [9,"a"] ``` El número del último resultado es el índice del objeto `r` (depende del estado de la tabla de objetos; con 2.0.3 era 10): para listas con objetos use `list.addobj`, las flechas (`r, "a" -> l`) o un bloque `$$` (`new l {$$ r, "a" $$}`). ## Errores ```dkl ref l = list.create() do list.addobj(l, "texto") exception { do print(last_error()) do clear_exceptions() } do list.atstr(l, 0) exception { do print(last_error()) do clear_exceptions() } new r { @"a": 1 } do list.addstr(r, "x") ``` ```text {1} Error en 'list.addobj. (list.addobj: se esperaba una referencia a un objeto.Exception has been thrown by the target of an invocation.) [ejemplo.dkl][Ln= 8] {1} Error en 'list.atstr. (list.at: índice 0 fuera de rango (elementos: 0).Exception has been thrown by the target of an invocation.) [ejemplo.dkl][Ln= 14] {1} Error en 'list.addstr. (list.addstr: el objeto no es una lista.Exception has been thrown by the target of an invocation.) [ejemplo.dkl][Ln= 24] ``` ## Si su código ya define funciones con estos nombres Si un programa 1.x define en DKL sus propias funciones con alguno de estos nombres (por ejemplo `list.addnum` o `list.setnum`), la función del motor tiene precedencia, también dentro del módulo que las define. Revise el valor devuelto: `list.setnum` devuelve ahora el número de elementos. Si su código las llama con `do`, no cambia nada.