Diferencias entre las revisiones 5 y 6
Versión 5 con fecha 2007-12-14 20:50:18
Tamaño: 23131
Comentario:
Versión 6 con fecha 2008-12-04 08:48:56
Tamaño: 23156
Editor: anónimo
Comentario: converted to 1.6 markup
Los textos eliminados se marcan así. Los textos añadidos se marcan así.
Línea 3: Línea 3:
[[TableOfContents()]] <<TableOfContents>>
Línea 26: Línea 26:
attachment:lista.png {{attachment:lista.png}}
Línea 67: Línea 67:
||Insertar al principio.||GSList* g_slist_prepend (GSList *list, gpointer data)[[Anchor(g_slist_prepend)]]||
||Insertar al final.||GSList* g_slist_append (GSList *list, gpointer data)[[Anchor(g_slist_append)]]||
||Insertar en la posición indicada.||GSList* g_slist_insert (GSList *list, gpointer data, gint position)[[Anchor(g_slist_insert)]]||
||Insertar en orden.||GSList* g_slist_insert_sorted (GSList *list, gpointer data, GCompareFunc func)[[Anchor(g_slist_insert_sorted)]]||

Las funciones de inserción al principio de la lista, ''[#g_slist_prepend g_slist_prepend]'', y al final, ''[#g_slist_append g_slist_append]'', son sencillas de usar. Sólo hay que pasarles como parámetros la lista donde queremos añadir el dato así como el dato a insertar y la función devuelve una lista con el nuevo dato insertado.

La función ''[#g_slist_insert g_slist_insert]'' inserta el dato en la posición indicada. Su uso también es sencillo como puede verse en el siguiente ejemplo.
||Insertar al principio.||GSList* g_slist_prepend (GSList *list, gpointer data)<<Anchor(g_slist_prepend)>>||
||Insertar al final.||GSList* g_slist_append (GSList *list, gpointer data)<<Anchor(g_slist_append)>>||
||Insertar en la posición indicada.||GSList* g_slist_insert (GSList *list, gpointer data, gint position)<<Anchor(g_slist_insert)>>||
||Insertar en orden.||GSList* g_slist_insert_sorted (GSList *list, gpointer data, GCompareFunc func)<<Anchor(g_slist_insert_sorted)>>||

Las funciones de inserción al principio de la lista, ''[[#g_slist_prepend|g_slist_prepend]]'', y al final, ''[[#g_slist_append|g_slist_append]]'', son sencillas de usar. Sólo hay que pasarles como parámetros la lista donde queremos añadir el dato así como el dato a insertar y la función devuelve una lista con el nuevo dato insertado.

La función ''[[#g_slist_insert|g_slist_insert]]'' inserta el dato en la posición indicada. Su uso también es sencillo como puede verse en el siguiente ejemplo.
Línea 92: Línea 92:
En este ejemplo se utiliza la función ''[#g_slist_length g_slist_length]'' para obtener el número de nodos que contiene la lista. A esta función hay que pasarle como parámetro la lista de la que se desea obtener el número de nodos y devuelve como resultado el número de nodos de ésta.

[[Anchor(g_slist_length)]]
En este ejemplo se utiliza la función ''[[#g_slist_length|g_slist_length]]'' para obtener el número de nodos que contiene la lista. A esta función hay que pasarle como parámetro la lista de la que se desea obtener el número de nodos y devuelve como resultado el número de nodos de ésta.

<<Anchor(g_slist_length)>>
Línea 99: Línea 99:
La función ''[#g_slist_insert_sorted g_slist_insert_sorted]'' inserta los elementos a la lista de forma ordenada. Esta función utiliza el parámetro `GCompareFunc` para insertar el dato en la posición correcta. La función ''[[#g_slist_insert_sorted|g_slist_insert_sorted]]'' inserta los elementos a la lista de forma ordenada. Esta función utiliza el parámetro `GCompareFunc` para insertar el dato en la posición correcta.
Línea 126: Línea 126:
||Eliminar un nodo.||GSList* g_slist_remove (GSList *list, gconstpointer data)[[Anchor(g_slist_remove)]]||
||Eliminar nodos según un patrón.||GSList* g_slist_remove_all (GSList *list, gconstpointer data)[[Anchor(g_slist_remove_all)]]||

Las dos funciones expuestas para la eliminación de nodos, si bien tienen una definición prácticamente idéntica, el resultado obtenido es distinto. En el caso de ''[#g_slist_remove g_slist_remove]'', se eliminará el nodo que contenga el valor data. Si hay varios nodos con el mismo valor, sólo se eliminará el primero. Si ningún nodo contiene ese valor, no se realiza ningún cambio en el `GSList`. En el caso de ''[#g_slist_remove_all g_slist_remove_all]'', se eliminan todos los nodos de la lista que contengan el valor data y nos devuelve la nueva lista resultante de la eliminación de los nodos.
||Eliminar un nodo.||GSList* g_slist_remove (GSList *list, gconstpointer data)<<Anchor(g_slist_remove)>>||
||Eliminar nodos según un patrón.||GSList* g_slist_remove_all (GSList *list, gconstpointer data)<<Anchor(g_slist_remove_all)>>||

Las dos funciones expuestas para la eliminación de nodos, si bien tienen una definición prácticamente idéntica, el resultado obtenido es distinto. En el caso de ''[[#g_slist_remove|g_slist_remove]]'', se eliminará el nodo que contenga el valor data. Si hay varios nodos con el mismo valor, sólo se eliminará el primero. Si ningún nodo contiene ese valor, no se realiza ningún cambio en el `GSList`. En el caso de ''[[#g_slist_remove_all|g_slist_remove_all]]'', se eliminan todos los nodos de la lista que contengan el valor data y nos devuelve la nueva lista resultante de la eliminación de los nodos.
Línea 143: Línea 143:
||Buscar un nodo según un valor.||GSList* g_slist_find (GSList *list, gconstpointer data)[[Anchor(g_slist_find)]]||
||Buscar un nodo según un criterio.||GSList* g_slist_find_custom (GSList *list, gconstpointer data, GCompareFunc func)[[Anchor(g_slist_find_custom)]]||
||Localizar el índice de un nodo.||GSList* g_slist_index (GSList *list, gconstpointer data)[[Anchor(g_slist_index)]]||
||Localizar la posición de un nodo.||GSList* g_slist_position (GSList *list, GSList *llink)[[Anchor(g_slist_position)]]||
||Obtener el último nodo.||GSList* g_slist_last (GSList *list)[[Anchor(g_slist_last)]]||
||Obtener el siguiente nodo.||g_slist_next (slist)[[Anchor(g_slist_next)]]||
||Obtener un nodo por su posición.||GSList* g_slist_nth (GSList *list, guint n)[[Anchor(g_slist_nth)]]||
||Obtener el dato de un nodo según su posición.||gpointer g_slist_nth_data (GSList *list, guint n)[[Anchor(g_slist_nth_data)]]||

Todas estas funciones, a excepción de ''[#g_slist_nth_data g_slist_nth_data]'', devuelven un nodo de la lista o `NULL` si el elemento no existe. La función ''[#g_slist_nth_data g_slist_nth_data]'' devuelve el valor del elemento según la posición que se le pasa como argumento en el parámetro n o `NULL` si la posición que se le pasa está más allá del final de la lista.

La función ''[#g_slist_next g_slist_next]'', es una macro que nos devuelve el siguiente nodo. Esta macro la podemos utilizar para recorrer la lista.
||Buscar un nodo según un valor.||GSList* g_slist_find (GSList *list, gconstpointer data)<<Anchor(g_slist_find)>>||
||Buscar un nodo según un criterio.||GSList* g_slist_find_custom (GSList *list, gconstpointer data, GCompareFunc func)<<Anchor(g_slist_find_custom)>>||
||Localizar el índice de un nodo.||GSList* g_slist_index (GSList *list, gconstpointer data)<<Anchor(g_slist_index)>>||
||Localizar la posición de un nodo.||GSList* g_slist_position (GSList *list, GSList *llink)<<Anchor(g_slist_position)>>||
||Obtener el último nodo.||GSList* g_slist_last (GSList *list)<<Anchor(g_slist_last)>>||
||Obtener el siguiente nodo.||g_slist_next (slist)<<Anchor(g_slist_next)>>||
||Obtener un nodo por su posición.||GSList* g_slist_nth (GSList *list, guint n)<<Anchor(g_slist_nth)>>||
||Obtener el dato de un nodo según su posición.||gpointer g_slist_nth_data (GSList *list, guint n)<<Anchor(g_slist_nth_data)>>||

Todas estas funciones, a excepción de ''[[#g_slist_nth_data|g_slist_nth_data]]'', devuelven un nodo de la lista o `NULL` si el elemento no existe. La función ''[[#g_slist_nth_data|g_slist_nth_data]]'' devuelve el valor del elemento según la posición que se le pasa como argumento en el parámetro n o `NULL` si la posición que se le pasa está más allá del final de la lista.

La función ''[[#g_slist_next|g_slist_next]]'', es una macro que nos devuelve el siguiente nodo. Esta macro la podemos utilizar para recorrer la lista.
Línea 174: Línea 174:
||Vacía la lista y libera la memoria usada.||void g_slist_free (GSList *list)[[Anchor(g_slist_free)]]||

La función ''[#g_slist_free g_slist_free]'' libera la memoria de la lista que se le pasa como parámetro.
||Vacía la lista y libera la memoria usada.||void g_slist_free (GSList *list)<<Anchor(g_slist_free)>>||

La función ''[[#g_slist_free|g_slist_free]]'' libera la memoria de la lista que se le pasa como parámetro.
Línea 226: Línea 226:
||Insertar al principio.||GList* g_list_prepend (GList *list, gpointer data)[[Anchor(g_list_prepend)]]||
||Insertar al final.||GList* g_list_append (GList *list, gpointer data)[[Anchor(g_list_append)]]||
||Insertar en la posición indicada.||GList* g_list_insert (GList *list, gpointer data, gint position)[[Anchor(g_list_insert)]]||
||Insertar en orden.||GList* g_list_insert_sorted (GList *list, gpointer data, GCompareFunc func)[[Anchor(g_list_insert_sorted)]]||
||Insertar al principio.||GList* g_list_prepend (GList *list, gpointer data)<<Anchor(g_list_prepend)>>||
||Insertar al final.||GList* g_list_append (GList *list, gpointer data)<<Anchor(g_list_append)>>||
||Insertar en la posición indicada.||GList* g_list_insert (GList *list, gpointer data, gint position)<<Anchor(g_list_insert)>>||
||Insertar en orden.||GList* g_list_insert_sorted (GList *list, gpointer data, GCompareFunc func)<<Anchor(g_list_insert_sorted)>>||
Línea 262: Línea 262:
||Eliminar un nodo.||GList* g_list_remove (GList *list, gconstpointer data)[[Anchor(g_list_remove)]]||
||Eliminar nodos según un patrón.||GList* g_list_remove_all (GList *list, gconstpointer data)[[Anchor(g_list_remove_all)]]||
||Eliminar un nodo.||GList* g_list_remove (GList *list, gconstpointer data)<<Anchor(g_list_remove)>>||
||Eliminar nodos según un patrón.||GList* g_list_remove_all (GList *list, gconstpointer data)<<Anchor(g_list_remove_all)>>||
Línea 278: Línea 278:
||Buscar un nodo según un valor.||GList* g_list_find (GList *list, gconstpointer data)[[Anchor(g_list_find)]]||
||Buscar un nodo según un criterio.||GList* g_list_find_custom (GList *list, gconstpointer data, GCompareFunc func)[[Anchor(g_list_find_custom)]]||
||Localizar el índice de un nodo.||GList* g_list_index (GList *list, gconstpointer data)[[Anchor(g_list_index)]]||
||Localizar la posición de un nodo.||GList* g_list_position (GList *list, GSList *llink)[[Anchor(g_list_position)]]||
||Obtener el último nodo.||GList* g_list_last (GList *list)[[Anchor(g_list_last)]]||
||Obtener el siguiente nodo.||g_list_next (list)[[Anchor(g_list_next)]]||
||Obtener un nodo por su posición.||GList* g_list_nth (GList *list, guint n)[[Anchor(g_list_nth)]]||
||Obtener el dato de un nodo según su posición.||gpointer g_list_nth_data (GList *list, guint n)[[Anchor(g_list_nth_data)]]||
||Buscar un nodo según un valor.||GList* g_list_find (GList *list, gconstpointer data)<<Anchor(g_list_find)>>||
||Buscar un nodo según un criterio.||GList* g_list_find_custom (GList *list, gconstpointer data, GCompareFunc func)<<Anchor(g_list_find_custom)>>||
||Localizar el índice de un nodo.||GList* g_list_index (GList *list, gconstpointer data)<<Anchor(g_list_index)>>||
||Localizar la posición de un nodo.||GList* g_list_position (GList *list, GSList *llink)<<Anchor(g_list_position)>>||
||Obtener el último nodo.||GList* g_list_last (GList *list)<<Anchor(g_list_last)>>||
||Obtener el siguiente nodo.||g_list_next (list)<<Anchor(g_list_next)>>||
||Obtener un nodo por su posición.||GList* g_list_nth (GList *list, guint n)<<Anchor(g_list_nth)>>||
||Obtener el dato de un nodo según su posición.||gpointer g_list_nth_data (GList *list, guint n)<<Anchor(g_list_nth_data)>>||
Línea 303: Línea 303:
||Vacía la lista y libera la memoria usada.||void g_list_free (GList *list)[[Anchor(g_list_free)]]|| ||Vacía la lista y libera la memoria usada.||void g_list_free (GList *list)<<Anchor(g_list_free)>>||
Línea 339: Línea 339:
||Iniciar cola.||GQueue* g_queue_new (void)[[Anchor(g_queue_new)]]||
||Cola vacía.||gboolean g_queue_is_empty (GQueue* queue)[[Anchor(g_queue_is_empty)]]||
||Consultar frente cola.||gpointer g_queue_peek_head (GQueue* queue)[[Anchor(g_queue_peek_head)]]||
||Consultar final cola.||gpointer g_queue_peek_tail (GQueue* queue)[[Anchor(g_queue_peek_tail)]]||
||Meter||void g_queue_push_tail (GQueue* queue, gpointer data)[[Anchor(g_queue_push_tail)]]||
||Sacar||gpointer g_queue_pop_head (GQueue* queue)[[Anchor(g_queue_pop_head)]]||
||Vaciar cola.||void g_queue_free (GQueue* queue)[[Anchor(g_queue_free)]]||
||Iniciar cola.||GQueue* g_queue_new (void)<<Anchor(g_queue_new)>>||
||Cola vacía.||gboolean g_queue_is_empty (GQueue* queue)<<Anchor(g_queue_is_empty)>>||
||Consultar frente cola.||gpointer g_queue_peek_head (GQueue* queue)<<Anchor(g_queue_peek_head)>>||
||Consultar final cola.||gpointer g_queue_peek_tail (GQueue* queue)<<Anchor(g_queue_peek_tail)>>||
||Meter||void g_queue_push_tail (GQueue* queue, gpointer data)<<Anchor(g_queue_push_tail)>>||
||Sacar||gpointer g_queue_pop_head (GQueue* queue)<<Anchor(g_queue_pop_head)>>||
||Vaciar cola.||void g_queue_free (GQueue* queue)<<Anchor(g_queue_free)>>||
Línea 437: Línea 437:
||Iniciar pila.||GQueue* g_queue_new (void)[[Anchor(g_queue_new)]]||
||Pila vacía.||gboolean g_queue_is_empty (GQueue* queue)[[Anchor(g_queue_is_empty)]]||
||Consultar pila.||gpointer g_queue_peek_head (GQueue* queue)[[Anchor(g_queue_peek_head)]]||
||Meter.||void g_queue_push_head (GQueue* queue, gpointer data)[[Anchor(g_queue_push_head)]]||
||Sacar.||gpointer g_queue_pop_head (GQueue* queue)[[Anchor(g_queue_pop_head)]]||
||Vaciar pila.||void g_queue_free (GQueue* queue)[[Anchor(g_queue_free)]]||
||Iniciar pila.||GQueue* g_queue_new (void)<<Anchor(g_queue_new)>>||
||Pila vacía.||gboolean g_queue_is_empty (GQueue* queue)<<Anchor(g_queue_is_empty)>>||
||Consultar pila.||gpointer g_queue_peek_head (GQueue* queue)<<Anchor(g_queue_peek_head)>>||
||Meter.||void g_queue_push_head (GQueue* queue, gpointer data)<<Anchor(g_queue_push_head)>>||
||Sacar.||gpointer g_queue_pop_head (GQueue* queue)<<Anchor(g_queue_pop_head)>>||
||Vaciar pila.||void g_queue_free (GQueue* queue)<<Anchor(g_queue_free)>>||
Línea 514: Línea 514:
'''''Volver a:''''' [:Documentacion/Desarrollo/Glib:GLib] '''''Volver a:''''' [[Documentacion/Desarrollo/Glib|GLib]]

Estructuras de datos: listas enlazadas, pilas y colas

Listas enlazadas.

Introducción

La lista enlazada es un TDA que nos permite almacenar datos de una forma organizada, al igual que los vectores pero, a diferencia de estos, esta estructura es dinámica, por lo que no tenemos que saber "a priori" los elementos que puede contener.

En una lista enlazada, cada elemento apunta al siguiente excepto el último que no tiene sucesor y el valor del enlace es null. Por ello los elementos son registros que contienen el dato a almacenar y un enlace al siguiente elemento. Los elementos de una lista, suelen recibir también el nombre de nodos de la lista.

            struct lista {
            gint dato;                                           (1)
            lista *siguiente;                                    (2)
            };

(1)

  • Representa el dato a almacenar. Puede ser de cualquier tipo; en este ejemplo se trata de una lista de enteros.

(2)

  • Es un puntero al siguiente elemento de la lista; con este puntero enlazamos con el sucesor, de forma que podamos construir la lista.

Figura 6-9.1. Esquema de un nodo y una lista enlazada.

lista.png

Para que esta estructura sea un TDA lista enlazada, debe tener unos operadores asociados que permitan la manipulación de los datos que contiene. Los operadores básicos de una lista enlazada son:

  • Insertar: inserta un nodo con dato x en la lista, pudiendo realizarse esta inserción al principio o final de la lista o bien en orden.
  • Eliminar: elimina un nodo de la lista, puede ser según la posición o por el dato.
  • Buscar: busca un elemento en la lista.
  • Localizar: obtiene la posición del nodo en la lista.
  • Vaciar: borra todos los elementos de la lista

Después de esta breve introducción, que sólo pretende servir como recordatorio, pasaremos a ver cómo es la estructura GSList que, junto con el conjunto de funciones que la acompañan, forman el TDA lista enlazada en GLib.

GSList

La definición de la estructura GSList o, lo que es lo mismo, un nodo de la lista, está definido de la siguiente manera:

            struct GSList {
              gpointer data;                                     (3)
              GSList *next;                                      (4)
            };

(3)

  • Representa el dato a almacenar. Se utiliza un puntero genérico por lo que puede almacenar un puntero a cualquier tipo de dato o bien almacenar un entero utilizando las macros de conversión de tipos.

(4)

  • Se trata de un puntero al siguiente elemento de la lista.

Las macros de conversión disponibles son las siguientes:

  • GINT_TO_POINTER ()

  • GPOINTER_TO_INT ()

  • GUINT_TO_POINTER ()

  • GPOINTER_TO_UINT ()

Más adelante, en esta misma sección, se verán ejemplos del uso de estas macros.

Las funciones que acompañan a la estructura GSList y que implementan los operadores básicos de las listas enlazadas, son las siguientes:

Tabla 6-9.1. Operadores de inserción en listas enlazadas.

Operador

Funciones asociadas a GSList.

Insertar al principio.

GSList* g_slist_prepend (GSList *list, gpointer data)

Insertar al final.

GSList* g_slist_append (GSList *list, gpointer data)

Insertar en la posición indicada.

GSList* g_slist_insert (GSList *list, gpointer data, gint position)

Insertar en orden.

GSList* g_slist_insert_sorted (GSList *list, gpointer data, GCompareFunc func)

Las funciones de inserción al principio de la lista, g_slist_prepend, y al final, g_slist_append, son sencillas de usar. Sólo hay que pasarles como parámetros la lista donde queremos añadir el dato así como el dato a insertar y la función devuelve una lista con el nuevo dato insertado.

La función g_slist_insert inserta el dato en la posición indicada. Su uso también es sencillo como puede verse en el siguiente ejemplo.

Ejemplo 6-9.1. Insertar un nuevo dato en una posición determinada.

   1     /* obtiene el numero de nodos de la lista */
   2     length = g_slist_length (list);
   3 
   4     g_print ("\nEscribe el nº de indice donde se insertara el dato (el indice maximo es %d): ", length);
   5     scanf ("%d", &index);
   6 
   7     /* inserta el valor en la posicion indicada */
   8 
   9     if (index < length) {
  10       list = g_slist_insert (list, GINT_TO_POINTER (value), index);
  11       print_list (list);
  12         }

En este ejemplo se utiliza la función g_slist_length para obtener el número de nodos que contiene la lista. A esta función hay que pasarle como parámetro la lista de la que se desea obtener el número de nodos y devuelve como resultado el número de nodos de ésta.

guint * g_slist_length ( GSList * list );

La función g_slist_insert_sorted inserta los elementos a la lista de forma ordenada. Esta función utiliza el parámetro GCompareFunc para insertar el dato en la posición correcta.

GCompareFunc es una función que se utiliza para comparar dos valores y saber así cual de ellos hay que insertar primero. En los dos ejemplos que hay a continuación, se puede observar una función de tipo GCompareFunc y su uso para insertar datos en una lista en orden creciente.

Ejemplo 6-9.2. Parámetro GCompareFunc para insertar en orden creciente.

   1 gint compare_value1 (gconstpointer a, gconstpointer b) {
   2   gint *value1 = (gint *) a;
   3   gint *value2 = (gint *) b;
   4 
   5   return value1 > value2;
   6 }

Ejemplo 6-9.3. Insertar elementos en orden creciente.

   1   gint values[] = {8, 14, 5, 12, 1, 27, 3, 13};
   2   gint i;
   3   /* insertando valores en orden creciente */
   4   for (i = 0; i < 8; i++) {
   5     list =  g_slist_insert_sorted (list, GINT_TO_POINTER (values[i]),
   6                                    compare_value1);
   7   }

Tabla 6-9.2. Operadores de eliminación en listas enlazadas.

Operador

Funciones asociadas a GSList.

Eliminar un nodo.

GSList* g_slist_remove (GSList *list, gconstpointer data)

Eliminar nodos según un patrón.

GSList* g_slist_remove_all (GSList *list, gconstpointer data)

Las dos funciones expuestas para la eliminación de nodos, si bien tienen una definición prácticamente idéntica, el resultado obtenido es distinto. En el caso de g_slist_remove, se eliminará el nodo que contenga el valor data. Si hay varios nodos con el mismo valor, sólo se eliminará el primero. Si ningún nodo contiene ese valor, no se realiza ningún cambio en el GSList. En el caso de g_slist_remove_all, se eliminan todos los nodos de la lista que contengan el valor data y nos devuelve la nueva lista resultante de la eliminación de los nodos.

Ejemplo 6-9.4. Elimina un elemento de la lista.

   1   if (list2 != NULL) {
   2     g_print ("\nEl dato %d sera eliminado de la lista.\n", list2->data);
   3 
   4     /* eliminando un elemento de la lista */
   5     g_slist_remove (list, list2->data);
   6    }

Tabla 6-9.3. Operadores de búsqueda en listas enlazadas.

Operador

Funciones asociadas a GSList.

Buscar un nodo según un valor.

GSList* g_slist_find (GSList *list, gconstpointer data)

Buscar un nodo según un criterio.

GSList* g_slist_find_custom (GSList *list, gconstpointer data, GCompareFunc func)

Localizar el índice de un nodo.

GSList* g_slist_index (GSList *list, gconstpointer data)

Localizar la posición de un nodo.

GSList* g_slist_position (GSList *list, GSList *llink)

Obtener el último nodo.

GSList* g_slist_last (GSList *list)

Obtener el siguiente nodo.

g_slist_next (slist)

Obtener un nodo por su posición.

GSList* g_slist_nth (GSList *list, guint n)

Obtener el dato de un nodo según su posición.

gpointer g_slist_nth_data (GSList *list, guint n)

Todas estas funciones, a excepción de g_slist_nth_data, devuelven un nodo de la lista o NULL si el elemento no existe. La función g_slist_nth_data devuelve el valor del elemento según la posición que se le pasa como argumento en el parámetro n o NULL si la posición que se le pasa está más allá del final de la lista.

La función g_slist_next, es una macro que nos devuelve el siguiente nodo. Esta macro la podemos utilizar para recorrer la lista.

Ejemplo 6-9.5. Función que imprime una lista.

   1 void print_list (GSList *list) {
   2 
   3   gint i = 0;
   4 
   5   while (list != NULL) {
   6     g_print ("Node %d content: %d.\n", i, list->data);
   7 
   8     /* apunta al siguiente nodo de la lista */
   9     list = g_slist_next (list);
  10     i++;
  11   }
  12 }

Tabla 6-9.4. Operador para vaciar la lista.

Operador

Funciones asociadas a GSList.

Vacía la lista y libera la memoria usada.

void g_slist_free (GSList *list)

La función g_slist_free libera la memoria de la lista que se le pasa como parámetro.

Con estas funciones, quedan definidos los operadores básicos del TDA lista enlazada. GSList trae otras funciones además de los operadores básicos. Para más información sobre estas, está disponible el manual de referencia de GLib.

Listas doblemente enlazadas.

Introducción.

El TDA lista doblemente enlazada, al igual que la lista enlazada, es un TDA dinámico lineal pero, a diferencia de este, cada nodo de la lista doblemente enlazada contiene dos punteros, de forma que uno apunta al siguiente nodo y el otro al predecesor. Esta característica, permite que se pueda recorrer la lista en ambos sentidos, cosa que no es posible en las listas simples.

La declaración del tipo lista doblemente enlazada de enteros es la siguiente:

            struct lista_doble {
            gint dato;                                           (5)
            lista_doble *siguiente;                              (6)
            lista_doble *anterior;                               (7)
            };

(5)

  • Representa el dato a almacenar, que puede ser de cualquier tipo. En este ejemplo se trataría de una lista de enteros.

(6)

  • Se trata de un puntero al siguiente elemento de la lista. Con este puntero se enlaza con el sucesor, de forma que podamos construir la lista.

(7)

  • Es un puntero al elemento anterior de la lista. Este puntero enlaza con el elemento predecesor de la lista y permite recorrerla en sentido inverso.

Sobre este TDA se definen los mismos operadores básicos que en las listas simples.

GList

La definición de la estructura GList, que es un nodo de la lista doblemente enlazada, está definido de la siguiente manera:

            struct GList
            {
            gpointer data;                                       (8)
            GList *next;                                         (9)
            GList *prev;                                         (10)
            };

(8)

  • Representa el dato que se va a almacenar. Se utiliza un puntero genérico por lo que puede almacenar un puntero a cualquier tipo de dato o bien almacenar un entero utilizando las macros de conversión de tipos.

(9)

  • Se trata de un puntero al siguiente elemento de la lista.

(10)

  • Se trata de un puntero al elemento anterior de la lista.

Las funciones que acompañan a la estructura GList, que implementan los operadores básicos de las listas enlazadas, son las siguientes:

Tabla 6-9.5. Operadores de inserción en listas doblemente enlazadas.

Operador

Funciones asociadas a GList

Insertar al principio.

GList* g_list_prepend (GList *list, gpointer data)

Insertar al final.

GList* g_list_append (GList *list, gpointer data)

Insertar en la posición indicada.

GList* g_list_insert (GList *list, gpointer data, gint position)

Insertar en orden.

GList* g_list_insert_sorted (GList *list, gpointer data, GCompareFunc func)

Como puede observarse en la definición de las funciones, su uso es el mismo que en las listas simples, al igual que las macros de conversión, por lo que todo lo explicado en esa sección es válido en el caso de las listas doblemente enlazadas.

Ejemplo 6-9.6. Insertar un nuevo dato en una posición determinada.

   1     /* obtiene el numero de nodos de la lista */
   2     length = g_list_length (list);
   3 
   4     g_print ("\nEscribe el numero de indice donde se insertara el dato (el indice maximo es %d): ", length);
   5     scanf ("%d", &index);
   6 
   7     /* inserta el valor en la posicion indicada */
   8 
   9     if (index < length) {
  10       list = g_list_insert (list, GINT_TO_POINTER (value), index);
  11       print_list (list);
  12         }

Ejemplo 6-9.7. Insertar elementos en orden creciente.

   1   gint values[] = {8, 14, 5, 12, 1, 27, 3, 13};
   2   gint i;
   3 
   4   for (i = 0; i < 8; i++) {
   5     list =  g_list_insert_sorted (list, GINT_TO_POINTER (values[i]),
   6                                    compare_value1);
   7   }

Tabla 6-9.6. Operadores de eliminación en listas doblemente enlazadas.

Operador

Funciones asociadas a GList

Eliminar un nodo.

GList* g_list_remove (GList *list, gconstpointer data)

Eliminar nodos según un patrón.

GList* g_list_remove_all (GList *list, gconstpointer data)

Ejemplo 6-9.8. Eliminar un elemento de la lista.

   1   if (list2 != NULL) {
   2     g_print ("\nEl dato %d sera eliminado de la lista.\n", list2->data);
   3 
   4     /* eliminando un elemento de la lista */
   5     g_list_remove (list, list2->data);
   6     print_list (list);
   7    }

Tabla 6-9.7. Operadores de búsqueda en listas doblemente enlazadas.

Operador

Funciones asociadas a GList.

Buscar un nodo según un valor.

GList* g_list_find (GList *list, gconstpointer data)

Buscar un nodo según un criterio.

GList* g_list_find_custom (GList *list, gconstpointer data, GCompareFunc func)

Localizar el índice de un nodo.

GList* g_list_index (GList *list, gconstpointer data)

Localizar la posición de un nodo.

GList* g_list_position (GList *list, GSList *llink)

Obtener el último nodo.

GList* g_list_last (GList *list)

Obtener el siguiente nodo.

g_list_next (list)

Obtener un nodo por su posición.

GList* g_list_nth (GList *list, guint n)

Obtener el dato de un nodo según su posición.

gpointer g_list_nth_data (GList *list, guint n)

Ejemplo 6-9.9. Busca un valor dado en la lista.

   1   g_print ("\nEntra un valor entero a buscar: ");
   2   scanf ("%d", &value);
   3   g_print ("\n");
   4 
   5   /* buscando un elemento en la lista */
   6   list2 = g_list_find (list, GINT_TO_POINTER (value));
   7 
   8   if (list2 != NULL) {
   9     index = g_list_index (list, list2->data);
  10     g_print ("\nEl valor %d esta en el nodo %d.\n", list2->data, index);

Tabla 6-9.8. Operador para vaciar la lista

Operador

Funciones asociadas a GList

Vacía la lista y libera la memoria usada.

void g_list_free (GList *list)

Con estas funciones, quedan definidos los operadores básicos del TDA lista enlazada. Al igual que GSList, GList trae otras funciones además de los operadores básicos. Para más información sobre estas, está disponible el manual de referencia de GLib.

GQueue: pilas y colas.

Otra de las novedades que incorpora esta versión de GLib es la estructura GQueue que, junto con las funciones que la acompañan, nos proporciona la posibilidad de implementar los TDA cola y pila estándar.

GQueue utiliza estructuras GList para almacenar los elementos. La declaración de la estructura de datos es la siguiente.

            struct GQueue {
               GList  *head;                                     (11)
               GList  *tail;                                     (12)
               guint length;                                     (13)
               };

(11)

  • Es un puntero al primer elemento de la cola.

(12)

  • Es un puntero al último elemento de la cola.

(13)

  • Esta variable almacena el número de elementos de la cola.

Aunque para referirnos al TDA GQueue utilizamos el término cola, con esta misma estructura también tenemos la posibilidad de implementar el TDA pila, gracias a las funciones que lo acompañan.

Colas

Una cola es una estructura de datos donde el primer elemento en entrar es el primero en salir, también denominadas estructuras FIFO (First In, First Out).

Esta estructura de datos se puede definir como una lista enlazada con acceso FIFO a la que sólo se tiene acceso al final de la lista para meter elementos y al principio de esta para sacarlos.

Los operadores asociados a este TDA y las funciones que los implementan en GLib son:

Tabla 6-9.9. Operadores asociados al TDA Cola.

Operador

Funciones asociadas a GQueue.

Iniciar cola.

GQueue* g_queue_new (void)

Cola vacía.

gboolean g_queue_is_empty (GQueue* queue)

Consultar frente cola.

gpointer g_queue_peek_head (GQueue* queue)

Consultar final cola.

gpointer g_queue_peek_tail (GQueue* queue)

Meter

void g_queue_push_tail (GQueue* queue, gpointer data)

Sacar

gpointer g_queue_pop_head (GQueue* queue)

Vaciar cola.

void g_queue_free (GQueue* queue)

Iniciar cola.

El operador "Iniciar cola" es el encargado de crear una nueva cola y ponerla en estado de cola vacía.

Ejemplo 6-9.10. Creando una nueva cola.

   1    GQueue* cola;
   2    cola = g_queue_new ();

Cola vacía.

Este operador consulta si la cola está vacía. Es necesaria su utilización antes de realizar la operación de "sacar elementos" de la cola.

Ejemplo 6-9.11. Función que comprueba si una cola está vacía.

   1 gboolean cola_vacia (GQueue* cola) {
   2    return g_queue_is_empty (cola);
   3 }

Consultar el frente.

Esta operación consulta el contenido del frente de la cola sin sacarlo.

Ejemplo 6.9-12. Función que consulta el frente de la cola.

   1 gpointer consultar_frente (GQueue* cola) {
   2    return g_queue_peek_head (cola);
   3 }

Consultar el final.

Esta operación consulta el contenido del final de la cola sin sacarlo.

Ejemplo 6-9.13. Función que consulta el final de la cola.

   1 gpointer consultar_final (GQueue* cola) {
   2    return g_queue_peek_tail (cola);
   3 }

Meter

Este operador introduce elementos al final de la cola.

Ejemplo 6-9.14. Introducir un nuevo elemento en la cola.

   1 GQueue* meter_cola (GQueue* cola, gpointer dato) {
   2    g_queue_push_tail (cola, dato);
   3 
   4    return cola;
   5 }

Sacar

El operador "sacar" elimina elementos del frente de la cola.

Ejemplo 6-9.15. Saca un elemento de la cola.

   1 gpointer sacar_cola (GQueue* cola) {
   2    gpointer dato;
   3 
   4    dato = g_queue_pop_head (cola);
   5 
   6    return dato;
   7 }

Vaciar cola.

Elimina el contenido de una cola inicializándola a una cola vacía.

Ejemplo 6-9.16. Vacía la cola.

   1   g_queue_free (cola);

Pilas

Una pila, es una estructura de datos en la que el último elemento en entrar es el primero en salir, por lo que también se denominan estructuras LIFO (Last In, First Out).

En esta estructura sólo se tiene acceso a la cabeza o cima de la pila.

Los operadores asociados a este TDA y las funciones que los implementan en GLib son:

Tabla 6-9.10. Operadores asociados al TDA Pila.

Operador

Funciones asociadas a GQueue.

Iniciar pila.

GQueue* g_queue_new (void)

Pila vacía.

gboolean g_queue_is_empty (GQueue* queue)

Consultar pila.

gpointer g_queue_peek_head (GQueue* queue)

Meter.

void g_queue_push_head (GQueue* queue, gpointer data)

Sacar.

gpointer g_queue_pop_head (GQueue* queue)

Vaciar pila.

void g_queue_free (GQueue* queue)

Iniciar pila.

El operador "iniciar pila" es el encargado de crear una nueva pila y inicializarla al estado de pila vacía.

Ejemplo 6-9.17. Creando una nueva pila.

   1    GQueue* pila;
   2    pila = g_queue_new ();

Pila vacía.

Este operador consulta si la pila está vacía. Es necesaria su utilización antes de realizar la operación de sacar elementos de la pila.

Ejemplo 6-9.18. Función que comprueba si una pila está vacía.

   1 gboolean pila_vacia (GQueue* pila) {
   2    return g_queue_is_empty (pila);
   3 }

Consultar pila.

Esta operación, consulta el contenido de la cima de la pila sin sacarlo.

Ejemplo 6-9.19. Función que consulta la cima de la pila.

   1 gpointer consultar_pila (GQueue* pila) {
   2    return g_queue_peek_head (pila);
   3 }

Meter

El operador "meter", introduce elementos en la cima de la pila.

Ejemplo 6-9.20. Introducir un nuevo elemento en la pila.

   1 GQueue* meter_pila (GQueue* pila, gpointer dato) {
   2    g_queue_push_head (pila, dato);
   3 
   4    return pila;
   5 }

Sacar

El operador sacar, saca elementos de la cima de la pila.

Ejemplo 6-9.21. Saca un elemento de la pila.

   1 gpointer sacar_pila (GQueue* pila) {
   2    gpointer dato;
   3 
   4    dato = g_queue_pop_head (pila);
   5 
   6    return dato;
   7 }

Vaciar pila.

Elimina el contenido de una pila inicializándola a una pila vacía.

Ejemplo 6-9.22. Vacía la pila

   1   g_queue_free (pila);


Volver a: GLib

Documentacion/Desarrollo/Glib/EstructuraDeDatosListasEnlazadasPilasYColas (última edición 2008-12-04 08:48:56 efectuada por anónimo)