Módulo PdsListVector.

Funciones que trabajan con listas vectores. Más...

Estructuras de datos
struct	PdsListVector
	La estructura tipo PdsListVector . Esta estructura genera una doblemente enlazada lista de vectores. Para usar incluir pds/pdslvector.h. Más...

defines
#define	PDS_OK   1
#define	PDS_WRONG   0

typedefs
typedef struct PdsListVector	PdsListVector

pds_list_vector_new
Creando una lista de vectores
PdsListVector *	pds_list_vector_new (void)
	Crea una lista de tipo PdsListVector vacia. Más...

pds_list_vector_<methods>
Funciones con metodos para lista de vectores
int	pds_list_vector_push (PdsListVector **Lprev, PdsRaNatural N)
	Agrega un elemento a la cima de la lista. Más...
int	pds_list_vector_pop (PdsListVector **L)
	Quita un elemento de la lista. Si no hay elementos retorna PDS_WRONG. Más...
int	pds_list_vector_shift (PdsListVector **L)
	Quita el elemento inicial;mas antiguo; de la lista, si no hay elementos retorna PDS_WRONG. Más...
int	pds_list_vector_unshift (PdsListVector **Lnext, PdsRaNatural N)
	Agrega un elemento al inicio de la lista. Más...
int	pds_list_vector_top (PdsListVector **L)
	Busca el elemento final; superior; de la lista. Más...
int	pds_list_vector_bottom (PdsListVector **L)
	Busca el elemento inicial; inferior; de la lista. Más...

pds_list_vector_<printf>
Funciones para mostrar datos de lista de vectores
int	pds_list_vector_printf (const PdsListVector *L)
	Imprime en pantalla los datos de un nodo de tipo puntero PdsListVector. Más...
int	pds_list_vector_all_printf (const PdsListVector *L)
	Imprime en pantalla todos los datos de la lista. Más...

pds_list_vector_<free>
Liberando memoria.
void	pds_list_vector_free (PdsListVector *L)
	Libera una lista entera de tipo puntero PdsListVector. Más...
void	pds_list_vector_destroy (PdsListVector **L)
	Libera una lista de tipo puntero PdsListVector, y limpia el puntero con NULL. Más...

Descripción detallada

Funciones que trabajan con listas vectores.

Estas funciones trabajan con una lista de vectores de la forma.

Lista de vectores

Documentación de los 'defines'

PDS_OK

#define PDS_OK   1

Valor retornado en caso de exito, este es un valor diferente que cero.

Definición en la línea 58 del archivo pdslvector.h.

PDS_WRONG

#define PDS_WRONG   0

Valor retornado en caso de fracaso, este valor es igual a cero.

Definición en la línea 66 del archivo pdslvector.h.

Documentación de los 'typedefs'

PdsListVector

typedef struct PdsListVector PdsListVector

Definición en la línea 69 del archivo pdslvector.h.

Documentación de las funciones

pds_list_vector_new()

PdsListVector * pds_list_vector_new

(

void

)

Crea una lista de tipo PdsListVector vacia.

Devuelve

Un puntero al vector de tipo PdsListVector.

pds_list_vector_push()

int pds_list_vector_push	(	PdsListVector **	Lprev,
		PdsRaNatural	N
	)

Agrega un elemento a la cima de la lista.

Parámetros

[in,out]	Lprev	El nodo de la cima de la lista.
[in]	N	La cantidad de elementos del vector.

Devuelve

PDS_OK si todo fue bien o PDS_WRONG si no. Si no le das el último nodo da error

pds_list_vector_pop()

int pds_list_vector_pop

(

PdsListVector **

L

)

Quita un elemento de la lista. Si no hay elementos retorna PDS_WRONG.

Parámetros

[in,out]

L

El nodo de la cima de la lista.

Devuelve

PDS_OK si todo fue bien o PDS_WRONG si no. Si no le das el último nodo da error

pds_list_vector_shift()

int pds_list_vector_shift

(

PdsListVector **

L

)

Quita el elemento inicial;mas antiguo; de la lista, si no hay elementos retorna PDS_WRONG.

Parámetros

[in,out]

L

El primer nodo de la lista.

Devuelve

PDS_OK si todo fue bien o PDS_WRONG si no. Si no le das el primer nodo da error.

pds_list_vector_unshift()

int pds_list_vector_unshift	(	PdsListVector **	Lnext,
		PdsRaNatural	N
	)

Agrega un elemento al inicio de la lista.

Parámetros

[in,out]	Lnext	El primer nodo de la lista.
[in]	N	La cantidad de elementos del vector.

Devuelve

PDS_OK si todo fue bien o PDS_WRONG si no. Si no le das el primer nodo da error.

pds_list_vector_top()

int pds_list_vector_top

(

PdsListVector **

L

)

Busca el elemento final; superior; de la lista.

Parámetros

[in,out]

L

Un nodo de la lista, en donde se cargará el último nodo.

Devuelve

PDS_OK si todo fue bien o PDS_WRONG si no.

pds_list_vector_bottom()

int pds_list_vector_bottom

(

PdsListVector **

L

)

Busca el elemento inicial; inferior; de la lista.

Parámetros

[in,out]

L

Un nodo de la lista, en donde se cargará el primer nodo.

Devuelve

PDS_OK si todo fue bien o PDS_WRONG si no.

pds_list_vector_printf()

int pds_list_vector_printf

(

const PdsListVector *

L

)

Imprime en pantalla los datos de un nodo de tipo puntero PdsListVector.

Parámetros

[in]

L

El nodo a imprimir en pantalla.

Devuelve

PDS_OK si todo fue bien o PDS_WRONG si no.

pds_list_vector_all_printf()

int pds_list_vector_all_printf

(

const PdsListVector *

L

)

Imprime en pantalla todos los datos de la lista.

Parámetros

[in]

L

Un nodo de la lista a imprimir en pantalla.

Devuelve

PDS_OK si todo fue bien o PDS_WRONG si no.

pds_list_vector_free()

void pds_list_vector_free

(

PdsListVector *

L

)

Libera una lista entera de tipo puntero PdsListVector.

Parámetros

[in,out]

L

La lista a liberar.

Devuelve

No retorna valor.

pds_list_vector_destroy()

void pds_list_vector_destroy

(

PdsListVector **

L

)

Libera una lista de tipo puntero PdsListVector, y limpia el puntero con NULL.

Parámetros

[in,out]

L

La lista a liberar y limpiar.

Devuelve

No retorna valor.