Referência ao ficheiro lista.c

Módulo gerenciador da lista. Mais...

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <errno.h>
#include "lista.h"
#include "mydebug.h"
#include "log.h"

Funções
bool	InicLista (struct TipoLista *pLista)
	Inicializa a lista.
bool	VaziaLista (struct TipoLista *pLista)
	Verifica se a lista possui elemento(s).
bool	InsereLista (struct TipoItem *Item, struct TipoLista *pLista)
	Armazena um elemento na lista.
void	ImprimeLista (struct TipoLista *pLista)
	Imprime na saída padrão os elementos da lista.
struct TipoItem	RemoveLista (struct TipoElementoLista *pPos, struct TipoLista *pLista)
	Remove um elemento da lista.
UINT	TamanhoLista (struct TipoLista *pLista)
	Informa o tamanho da lista.

---

Descrição detalhada

Módulo gerenciador da lista.

Todas as definições da lista estão neste módulo.

Versão:

0.0.1

Data:

04/27/2012 10:51:51 AM

Autor:

Alessandro Elias, ae11@inf.ufpr.br

Welton Pereira Martins, wpm11@inf.ufpr.br

---

Documentação das funções

void ImprimeLista

(

struct TipoLista *

pLista

)

Imprime na saída padrão os elementos da lista.

Parâmetros:

pLista

- ponteiro para a lista.

Veja também:

InicLista, VaziaLista, InsereLista, RemoveLista, TamanhoLista

bool InicLista

(

struct TipoLista *

pLista

)

Inicializa a lista.

Parâmetros:

pLista

- ponteiro para a lista.

Retorna:

True caso a inicialização foi bem sucedida, False caso contrário.

Observações:

Iniclista deve ser a primeira função a ser chamada, caso ocorra uma chamada a qualquer uma das outras funções o resultado é imprevisível, pois a fila contém lixo de memória.

Veja também:

VaziaLista, InsereLista, ImprimeLista, RemoveLista, TamanhoLista

bool InsereLista	(	struct TipoItem *	Item,
		struct TipoLista *	pLista
	)

Armazena um elemento na lista.

Parâmetros:

Item	- item que será armazenado na lista.
pLista	- ponteiro para a lista.

Retorna:

TRUE caso o elemento possa ser colocado na lista, False caso contrário.

Observações:

Esta lista é circular duplamente encadeada.

Veja também:

InicLista, VaziaLista, ImprimeLista, RemoveLista, TamanhoLista

struct TipoItem RemoveLista	(	struct TipoElementoLista *	pPos,
		struct TipoLista *	pLista
	)		[read]

Remove um elemento da lista.

Parâmetros:

pPos	- ponteiro para a posição do elemento a ser removido.
pLista	- ponteiro para a lista.

Retorna:

Elemento removido.

Veja também:

InicLista, VaziaLista, InsereLista, ImprimeLista, TamanhoLista

UINT TamanhoLista

(

struct TipoLista *

pLista

)

Informa o tamanho da lista.

Parâmetros:

pLista

- ponteiro para a lista.

Retorna:

Tamanho da lista.

bool VaziaLista

(

struct TipoLista *

pLista

)

Verifica se a lista possui elemento(s).

Parâmetros:

pLista

- ponteiro para a lista.

Retorna:

TRUE caso a lista esteja vazia, FALSE caso contrário.

Veja também:

InicLista, InsereLista, ImprimeLista, RemoveLista, TamanhoLista