La librería xsdictionarys de xsEasyC proporciona funciones para el manejo de Diccionarios. Un Diccionario es una Estructura de Datos Dinámica, en la cual cada elemento es un Conjunto de Pares de Datos; donde uno de los 2 datos es la Llave y el otroes el Valor correspondiente a la Llave.
La Llave es del Tipo de Dato Cadena, y el Valor puede ser de cualquier de los siguientes tipos: Cadena, Entero, Caracter y Doble. La Llave es Única por lo que no puede estar repetida; aunque si se diferencian las minúsculas de las mayúsculas; es decir que la Llave Nombre; es diferente a la Llave NOMBRE.
A continuación se presentan las Funciones de Diccionario que incluye la librería en el orden sugerido de uso:
- diccionarioInicializar
Función para inicializar un Diccionario para su uso.
Esta función utiliza 1 parámetro:
Diccionario *diccionario. Este parámetro es correspondiente a una variable de Tipo Diccionario del cual se recibe su dirección de memoria.
Lo primero que debe de hacerse es declarar una variable de Tipo Diccionario e inicializarla. El siguiente ejemplo muestra como declarar una variable de Tipo Diccionario e Inicializarla para su posterior uso.
Ejemplo:
// Variable para el Diccionario
Diccionario diccionario;
// Inicializa el Diccionario
Imprimir("Inicializa Diccionario ...");
diccionarioInicializar(&diccionario);
El Ejemplo anterior primeramente define la variable diccionario del Tipo Diccionario; y posteriormente utiliza la función para Inicializarla. Es importante notar que al llamar a la función se utiliza el operador & para indicar que lo que se envía en el parámetro es la dirección de la variable.
- diccionarioInsertar
Función para Insertar un Elemento al Final del Diccionario.
Esta función utiliza 4 parámetros:
Diccionario *diccionario. Este parámetro es correspondiente a una variable de Tipo Diccionario del cual se recibe su dirección de memoria.
Cadena llave. Este parámetro es para indicar la Llave del Elemento del Diccionario.
Entero tipo. Este parámetro es para indicar el Tipo de Dato que se va a insertar en el Valor. Los valores posible para este parámetro son: TIPO_CADENA, TIPO_ENTERO, TIPO_CARACTER y TIPO DOBLE.
.... Este parámetro es para indicar el dato que se va a asignar a el Valor del Elemento, el cual puede ser los 4 posibles tipos de datos indicados en el parámetro previo.
El siguiente ejemplo muestra como insertar elementos al Diccionario.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Se insertan elementos en la lista
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos a la lista al Final
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"Falso",TIPO_CARACTER,'F');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
diccionarioInsertar(&dic,"Espacio",TIPO_ENTERO,32);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. Posteriormente inserta 5 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles.
La siguiente imagen muestra la ejecución del Código en donde se observa la impresión del Diccionario mostrando los elementos insertados.
- diccionarioInsertarIndice
Función para Insertar un Elemento en una posición específica del Diccionario.
Esta función utiliza 5 parámetros:
Diccionario *diccionario. Este parámetro es correspondiente a una variable de Tipo Diccionario del cual se recibe su dirección de memoria.
Cadena llave. Este parámetro es para indicar la Llave del Elemento del Diccionario.
Entero tipo. Este parámetro es para indicar el Tipo de Dato que se va a insertar en el Valor. Los valores posible para este parámetro son: TIPO_CADENA, TIPO_ENTERO, TIPO_CARACTER y TIPO DOBLE.
Entero indice. Este parámetro es para indicar el índice o la posición en donde se insertará el Elemento.
.... Este parámetro es para indicar el dato que se va a asignar a el Valor del Elemento, el cual puede ser los 4 posibles tipos de datos indicados en el parámetro previo.
El siguiente ejemplo muestra como insertar elementos al Diccionario en una posición específica.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Se insertan elementos en la lista
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos a la lista al Final
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"Falso",TIPO_CARACTER,'F');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
diccionarioInsertar(&dic,"Espacio",TIPO_ENTERO,32);
// Insertar un elemento en la posición 2
diccionarioInsertarIndice(&dic,"0001",TIPO_DOBLE,2,100.50);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. Posteriormente inserta 5 elementos al Diccionario al final. A continuación se inserta un elemento en el índice 2 del Diccionario.
La siguiente imagen muestra la ejecución del Código en donde se observa la impresión del Diccionario mostrando los elementos insertados.
- diccionarioImprimir
Función para Imprimir los Elementos del Diccionario.
Esta función utiliza 1 parámetro:
Diccionario diccionario. Este parámetro es correspondiente a una variable de Tipo Diccionario de la cual se imprimirán sus elementos.
Los Elementos del Diccionario, se encuentran delimitados por "[]"; y cada uno de sus elementos se encuentran separados por ",".
El despliegue de la Llave y el Valor se realiza separando cada par de datos con ":"; siendo la Llave desplegada primeramente y posteriormente la Información.
En el Código de Ejemplo mostrado en la función previa, ha quedado demostrado el uso de la función.
- diccionarioEliminar
Función para Eliminar un Elemento del Diccionario por su Llave.
Esta función utiliza 2 parámetros:
Diccionario *diccionario. Este parámetro es correspondiente a una variable de Tipo Diccionario del cual se recibe su dirección de memoria.
Cadena llave. Este parámetro es para indicar la Llave del Elemento del Diccionario que será eliminado.
La función devuelve VERDAD en caso de que la Llave a eliminar exista y se haya eliminado; devolverá FALSO; si la Llave no existe y no se haya podido eliminar el elemento.
El siguiente ejemplo muestra como eliminar un elemento del Diccionario por su Llave.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Se insertan elementos en la lista
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos a la lista al Final
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"Falso",TIPO_CARACTER,'F');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
// Mensaje
Imprimir("Eliminando elemento ...");
// Eliminando un Elemento por llave
diccionarioEliminar(&dic,"Falso");
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles, y despliega el Diccionario. Posteriormente elimina el elemento con Llave "Falso" y vuelve a desplegar el Diccionario donde se observa que el elemento ha sido eliminado.
- diccionarioEliminarIndice
Función para Eliminar un Elemento del Diccionario por índice.
Esta función utiliza 2 parámetros:
Diccionario *diccionario. Este parámetro es correspondiente a una variable de Tipo Diccionario del cual se recibe su dirección de memoria.
Entero indice. Este parámetro es para indicar del elemento que será eliminado.
La función devuelve VERDAD en caso de que el índice sea válido y se haya eliminado; devolverá FALSO; si el índice no es válido y no se haya podido eliminar el elemento.
El siguiente ejemplo muestra como eliminar un elemento del Diccionario por su índice.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Se insertan elementos en la lista
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos a la lista al Final
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"Falso",TIPO_CARACTER,'F');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
// Mensaje
Imprimir("Eliminando elemento ...");
// Eliminando un Elemento por índice
diccionarioEliminarIndice(&dic,4);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles, y despliega el Diccionario. Posteriormente elimina el elemento con índice 4 y vuelve a desplegar el Diccionario donde se observa que el elemento ha sido eliminado.
- diccionarioActualizar
Función para Actualizar un Elemento del Diccionario por Llave.
Esta función utiliza 4 parámetros:
Diccionario *diccionario. Este parámetro es correspondiente al Diccionario del cual se va a actualizar su elemento.
Cadena llave. Este parámetro es para indicar la Llave del elemento que será eliminado.
Entero tipo. Este parámetro es para indicar el Tipo de Dato del Elemento que será insertado.
.... Este parámetro es para enviar el Elemento que será el que modifique al correspondiente a la Llave.
La función devuelve VERDAD en caso de que la Llave sea válida y se haya eliminado; devolverá FALSO; si la Llave no es válida y no se haya podido eliminar el elemento.
El siguiente ejemplo muestra como actualizar un elemento del Diccionario por su Llave.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Se insertan elementos en la lista
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos a la lista al Final
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"Falso",TIPO_CARACTER,'F');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
// Mensaje
Imprimir("Modificando elemento ...");
// Eliminando un Elemento por índice
diccionarioActualizar(dic,"RGB",TIPO_CADENA,"Rojo Verde Azul");
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles, y despliega el Diccionario. Posteriormente actualizar el elemento con Llave "RGB" y vuelve a desplegar el Diccionario donde se observa que el elemento ha sido actualizado.
- diccionarioBuscar
Función para Buscar un Elemento del Diccionario por Llave.
Esta función utiliza 2 parámetros:
Diccionario *diccionario. Este parámetro es correspondiente al Diccionario del cual se va a actualizar su elemento.
Cadena llave. Este parámetro es para indicar la Llave del elemento que será buscado.
La función devuelve 0 en caso de que no haya localizado el Elemento en el Diccionario; y un valor mayor que 0 correspondiente a la posición del Elemento en el Diccionario.
El siguiente ejemplo muestra como buscar un elemento del Diccionario por su Llave.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Se insertan elementos en la lista
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos a la lista al Final
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"Falso",TIPO_CARACTER,'F');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
// Mensaje
Imprimir("Buscando la llave RGB en el Diccionario ...");
// Declara variable Entera para posición
Entero posicion;
// Realiza la Búsqueda
posicion = diccionarioBuscar(&dic,"RGB");
// Verifica
si (posicion>0)
imprimirEntero(posicion,"El elemento se encuentra en posicion:%d",CON_CAMBIO_LINEA);
deOtroModo
Imprimir("El Elemento no fue encontrado en el Diccionario");
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles, y despliega el Diccionario. Posteriormente realiza la búsqueda del elemento con Llave "RGB" y en caso de que lo haya encontrado devuelve la posición del elemento en el diccionario.
- diccionarioElemento
Función para obtener un Elemento del Diccionario por Llave.
Esta función utiliza 2 parámetros:
Diccionario *diccionario. Este parámetro es correspondiente al Diccionario del cual se va a actualizar su elemento.
Cadena llave. Este parámetro es para indicar la Llave del elemento que se quiere obtener.
La función devuelve una variable del Tipo ElementoDiccionario. En caso de que no haya localizado el Elemento en el Diccionario, el tipo del elemento tendrá un valor de -1; y al desplegarlo mostrará [:].
El siguiente ejemplo muestra como obtener un elemento del Diccionario por su Llave.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Se insertan elementos en la lista
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos a la lista al Final
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"Falso",TIPO_CARACTER,'F');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
// Imprimir
Imprimir("Obteniendo el Elemento RGB ...");
// Obtiene el Valor de un Elemento
ElementoDiccionario elemento;
elemento = diccionarioElemento(dic,"RGB");
// Despliega el Valor
Imprimir("Valor del Elemento del Diccionario ...");
diccionarioImprimirElemento(elemento);
CL;
CL;
// Buscando una llave que no existe
elemento = diccionarioElemento(dic,"RGBX");
// Despliega el Valor
Imprimir("Obteniendo el Elemento RGBX ...");
Imprimir("Valor del Elemento del Diccionario ...");
diccionarioImprimirElemento(elemento);
CL;
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles, y despliega el Diccionario. Posteriormente obtiene el elemento correspondiente a la Llave "RGB" y despliega su información. A continuación obtiene el elemento con Llave "RGBX" el cual no existe y lo despliega.
- diccionarioImprimirElemento
Función para Imprimir el Valor de un elemento del Diccionario.
Esta función utiliza 1 parámetro:
ElementoDiccionario elemento. Este parámetro es correspondiente al elemento del cual se va a imprimir el Valor.
En el Código de Ejemplo mostrado en la función previa, ha quedado demostrado el uso de la función.
- diccionarioLlaves
Función para obtener las Llaves del Diccionario en una Lista.
Esta función utiliza 1 parámetro:
Diccionario diccionario. Este parámetro es correspondiente al Diccionario del cual se van a obtener las Llaves.
El siguiente ejemplo muestra como obtener las Llaves de un Diccionario en una Lista.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Mensaje
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos al Diccionario
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
diccionarioInsertar(&dic,"Espacio",TIPO_ENTERO,32);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
Imprimir("Convirtiendo las llaves del Diccionario a lista ...");
CL;
// Define variable Lista
Lista llaves;
// Obtiene la lista
llaves = diccionarioLlaves(dic);
Imprimir("Imprimiendo la lista de llaves...");
listaImprimir(llaves);
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles, y despliega el Diccionario. Posteriormente se define una variable de Tipo Lista y se llama a la función para obtener las llaves asignándola a esta variable la cual es a continuación impresa.
- diccionarioValores
Función para obtener los Valores del Diccionario en una Lista.
Esta función utiliza 1 parámetro:
Diccionario diccionario. Este parámetro es correspondiente al Diccionario del cual se van a obtener los Valores.
El siguiente ejemplo muestra como obtener los Valores de un Diccionario en una Lista.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Mensaje
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos al Diccionario
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
diccionarioInsertar(&dic,"Espacio",TIPO_ENTERO,32);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
Imprimir("Convirtiendo las Valores del Diccionario a lista ...");
CL;
// Define variable Lista
Lista valores;
// Obtiene la lista
valores = diccionarioValores(dic);
Imprimir("Imprimiendo la lista de valores...");
listaImprimir(valores);
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles, y despliega el Diccionario. Posteriormente se define una variable de Tipo Lista y se llama a la función para obtener los valores asignándola a esta variable la cual es a continuación impresa.
- diccionarioLongitud
Función para obtener el número de elementos del Diccionario.
Esta función utiliza 1 parámetro:
Diccionario diccionario. Este parámetro es correspondiente al Diccionario del cual se obtendrá la longitud.
El siguiente ejemplo muestra como obtener la longitud de un Diccionario.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Mensaje
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos al Diccionario
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
diccionarioInsertar(&dic,"Espacio",TIPO_ENTERO,32);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
// Obteniendo la Longitud del Diccionario
Entero longitud;
longitud = diccionarioLongitud(dic);
// Mensaje
imprimirEntero(longitud,"La longitud del Diccionario es %d",CON_CAMBIO_LINEA);
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles, y despliega el Diccionario. Posteriormente se define una variable de Tipo Entero y se llama a la función para obtener la Longitud asignándola a esta variable la cual es a continuación impresa.
- diccionarioTipo
Función para obtener el Tipo del Diccionario.
Esta función utiliza 1 parámetro:
Diccionario diccionario. Este parámetro es correspondiente al Diccionario del cual se obtendrá su Tipo.
El Tipo de Diccionario corresponderá a uno de los 4 establecidos; siempre y cuando todos los elementos sean del mismo tipo; si alguno es distinto; entonces devolverá el valor de -1.
El siguiente ejemplo muestra como obtener la longitud de un Diccionario.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Mensaje
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos a la lista
diccionarioInsertar(&dic,"A",TIPO_ENTERO,65);
diccionarioInsertar(&dic,"B",TIPO_ENTERO,66);
diccionarioInsertar(&dic,"C",TIPO_ENTERO,67);
diccionarioInsertar(&dic,"D",TIPO_ENTERO,68);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
// Obteniendo el Tipo del Diccionario
Entero tipo;
tipo = diccionarioTipo(dic);
// Verifica que tipo es
evaluar (tipo)
{
siEs TIPO_ENTERO:
Imprimir("El Diccionario es de Tipo Entero");
salirEvaluar;
siEs TIPO_CARACTER:
Imprimir("El Diccionario es de Tipo Caracter");
salirEvaluar;
siEs TIPO_DOBLE:
Imprimir("El Diccionario es de Tipo Doble");
salirEvaluar;
siEs TIPO_CADENA:
Imprimir("El Diccionario es de Tipo Cadena");
salirEvaluar;
otroValor:
Imprimir("El Diccionario no tiene Tipo");
salirEvaluar;
}
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario del mismo Tipo y despliega el Diccionario. Posteriormente define una variable Entero y ejecuta la función para obtener el Tipo de Dato del Diccionario y lo asigna a la variable y verifica a cual Tipo de Dato corresponde y lo despliega.
- diccionarioTipoElemento
Función para obtener el Tipo de Dato de un Elemento del Diccionario por Llave.
Esta función utiliza 2 parámetros:
Diccionario *diccionario. Este parámetro es correspondiente al Diccionario del cual se va a actualizar su elemento.
Cadena llave. Este parámetro es para indicar la Llave del elemento del que se obtiene su Tipo.
La función devuelve -1 en caso de que no haya localizado el Elemento en el Diccionario.
El siguiente ejemplo muestra como obtener el Tipo de un elemento del Diccionario.
Ejemplo:
// Variable para la lista
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Mensaje
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos Elementos a la lista al Final
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"Verdad",TIPO_CARACTER,'V');
diccionarioInsertar(&dic,"Falso",TIPO_CARACTER,'F');
diccionarioInsertar(&dic,"PI",TIPO_DOBLE,3.1416);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
// Obteniendo el Tipo de un Elemento
Imprimir("Obteniendo el Tipo del Elemento PI");
Entero tipoElemento;
tipoElemento = diccionarioTipoElemento(dic,"PI");
// Verifica que tipo es
evaluar (tipoElemento)
{
siEs TIPO_ENTERO:
Imprimir("El Elemento es de Tipo Entero");
salirEvaluar;
siEs TIPO_CARACTER:
Imprimir("El Elemento es de Tipo Caracter");
salirEvaluar;
siEs TIPO_DOBLE:
Imprimir("El Elemento es de Tipo Doble");
salirEvaluar;
siEs TIPO_CADENA:
Imprimir("El Elemento es de Tipo Cadena");
salirEvaluar;
otroValor:
Imprimir("El Elemento no tiene Tipo");
salirEvaluar;
}
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario; utilizando los 4 diferentes Tipos posibles, y despliega el Diccionario. Posteriormente declara una variable de Tipo Entero y ejecuta la función para obtener el Tipo de Dato del Elemento PI. Evalúa el valor de la variable y despliega el Tipo de Dato.
- diccionarioVaciar
Función para vaciar un Diccionario.
Esta función utiliza 1 parámetro:
Diccionario diccionario. Este parámetro es correspondiente al Diccionario el cual se va a vaciar.
El siguiente ejemplo muestra como obtener la longitud de un Diccionario.
Ejemplo:
// Variable para el diccionario
Diccionario dic;
// Inicializa el Diccionario
diccionarioInicializar(&dic);
// Se insertan elementos en la diccionario
Imprimir("Insertando Elementos en el Diccionario ...");
// Agregamos un Elemento a la diccionario
diccionarioInsertar(&dic,"RGB",TIPO_CADENA,"Red Green Blue");
diccionarioInsertar(&dic,"LetraA",TIPO_CARACTER,'a');
diccionarioInsertar(&dic,"Medio",TIPO_DOBLE,73.15);
// Desplegar los elementos del Diccionario
Imprimir("Diccionario");
diccionarioImprimir(dic);
CL;
// Ejecuta la Función
Imprimir("Vaciando el Diccionario ...");
diccionarioVaciar(&dic);
CL;
Imprimir("Diccionario impreso despues de vaciar");
diccionarioImprimir(dic);
El Ejemplo anterior primeramente define la variable dic del Tipo Diccionario y la inicializa. A continuación inserta 4 elementos al Diccionario y lo despliega. Posteriormente llama a la función para vaciar el Diccionario y lo imprime de nuevo para verificar que ya se encuentra vacío.