Manual de xsEasyC
Como utilizar Diccionarios

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.

    diccionario Insertar

  • 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.

    diccionario Insertar Indice

  • 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.

    diccionario Eliminar

  • 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.

    diccionario Eliminar Indice

  • 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.

    diccionario Actualizar

  • 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.

    diccionario Actualizar

  • 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.

    diccionario Elemento

  • 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.

    diccionario Llaves

  • 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.

    diccionario Valores

  • 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.

    diccionario Llaves

  • 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.

    diccionario Tipo

  • 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.

    diccionario Tipo Elemento

  • 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.

    diccionario Vaciar