Las funciones de diccionario permiten crear, actualizar, eliminar y consultar pares clave-valor en diccionarios durante la transformación de datos.
Funciones
|
Función |
Descripción |
|
Crea un diccionario. |
|
|
Actualiza un diccionario. |
|
|
Elimina un par clave-valor de un diccionario. |
|
|
Devuelve una lista de las claves del diccionario. |
|
|
Devuelve una lista de los valores del diccionario. |
|
|
Devuelve el valor de una clave especificada. |
|
|
Devuelve el número de elementos en un diccionario. |
dct_make
Crea un diccionario.
-
Sintaxis
dct_make(key1, value1, key2, value2, ...)NotaDebe especificar las claves y los valores en pares.
-
Parámetros
Nombre del parámetro
Tipo
Obligatorio
Descripción
key
String
Sí
La clave del diccionario.
value
String
Sí
El valor que se asociará con la clave.
-
Respuesta
Devuelve el diccionario creado.
-
Ejemplos
-
Registro sin procesar
content:test -
Regla de transformación
e_set("hello", dct_make("k1","v1","k2","v2")) -
Resultado
content:test hello:{"k1": "v1", "k2": "v2"}
-
dct_update
Actualiza un diccionario.
-
Sintaxis
dct_update(dict1, dict2) -
Parámetros
Nombre del parámetro
Tipo
Obligatorio
Descripción
dict1
dict
Sí
El diccionario que se actualizará.
dict2
dict
Sí
El diccionario que se fusionará en dict1.
-
Respuesta
Devuelve el diccionario actualizado.
-
Ejemplos
-
Registro sin procesar
ctx: {"k1":"v1","k2":"v2"} -
Regla de transformación
e_set("hello", dct_update(v("ctx"), {"k3": "v3"})) -
Resultado
ctx: {"k1":"v1","k2":"v2"} hello: {"k1": "v1", "k2": "v2", "k3": "v3"}
-
dct_delete
Elimina uno o más pares clave-valor de un diccionario.
-
Sintaxis
dct_delete(dict, key1, key2, ...) -
Parámetros
Nombre del parámetro
Tipo de parámetro
Obligatorio
Descripción
dict
dict
Sí
El diccionario del cual se eliminarán los pares clave-valor.
key1
String
Sí
La clave del par clave-valor que se eliminará.
key2
String
No
La clave del par clave-valor que se eliminará.
-
Respuesta
Devuelve el diccionario actualizado.
-
Ejemplos
-
Registro sin procesar
ctx: {"k1":"v1","k2":"v2"} -
Regla de transformación
e_set("hello", dct_delete(v("ctx"), "k2")) -
Resultado
ctx: {"k1":"v1","k2":"v2"} hello: {"k1":"v1"}
-
dct_keys
Devuelve una lista de todas las claves de un diccionario.
-
Sintaxis
dct_keys(dict) -
Parámetros
Nombre del parámetro
Tipo de parámetro
Obligatorio
Descripción
dict
dict
Sí
El diccionario de origen.
-
Respuesta
Devuelve una lista de las claves.
-
Ejemplos
-
Registro sin procesar
ctx: {"k1":"v1","k2":"v2"} -
Regla de transformación
e_set("hello", dct_keys(v("ctx"))) -
Resultado
ctx: {"k1":"v1","k2":"v2"} hello: ["k1","k2"]
-
dct_values
Devuelve una lista de todos los valores de un diccionario.
-
Sintaxis
dct_values(dict) -
Parámetros
Nombre del parámetro
Tipo de parámetro
Obligatorio
Descripción
dict
dict
Sí
El diccionario de origen.
-
Respuesta
Devuelve una lista de los valores.
-
Ejemplos
-
Registro sin procesar
ctx: {"k1":"v1","k2":"v2"} -
Regla de transformación
e_set("hello", dct_values(v("ctx"))) -
Resultado
ctx: {"k1":"v1","k2":"v2"} hello: ["v1","v2"]
-
dct_get
Devuelve el valor de una clave especificada de un diccionario.
-
Sintaxis
dct_get(dict,key,default=None) -
Parámetros
Nombre del parámetro
Tipo
Obligatorio
Descripción
dict
dict
Sí
El diccionario que se consultará.
key
String
Sí
La clave cuyo valor desea obtener.
default
String
No
El valor que se devolverá si la clave no existe.
-
Respuesta
Devuelve el valor de la clave especificada.
-
Ejemplos
-
Ejemplo 1
-
Registro sin procesar
ctx: {"k1":"v1","k2":"v2"} -
Regla de transformación
e_set("hello", dct_get(v("ctx"), "k1")) -
Resultado
ctx: {"k1":"v1","k2":"v2"} hello: v1
-
-
Ejemplo 2: Si no se encuentra la clave, se devuelve el valor predeterminado.
-
Registro sin procesar
ctx: {"k1":"v1","k2":"v2"} -
Regla de transformación
e_set("hello", dct_get(v("ctx"), "k3",default="123")) -
Resultado
ctx: {"k1":"v1","k2":"v2"} hello: 123
-
-