Referência ao ficheiro pilha.c

Módulo gerenciador da pilha. Mais...

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

Funções
bool	InicPilha (struct TipoPilha *pPilha)
	Inicializa a pilha.
bool	Push (TipoItem *item, struct TipoPilha *pPilha)
	Armazena um elemento no topo da pilha.
TipoItem *	Pop (struct TipoPilha *pPilha)
	Remove elemento do topo da pilha.
bool	VaziaPilha (struct TipoPilha *pPilha)
	Verifica se a pilha possui elemento(s).
UINT	TamanhoPilha (struct TipoPilha *pPilha)
	Obtem número de elementos da pilha.
void	ImprimePilha (struct TipoPilha *pPilha)
	Imprime na saída padrão a lista de elementos da pilha.

---

Descrição detalhada

Módulo gerenciador da pilha.

Todas as definições da pilha estao 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 ImprimePilha

(

struct TipoPilha *

pPilha

)

Imprime na saída padrão a lista de elementos da pilha.

Parâmetros:

pPilha

- ponteiro para a pilha.

Veja também:

lePilha, InicPilha, Push, Pop, VaziaPilha, TamanhoPilha

bool InicPilha

(

struct TipoPilha *

pPilha

)

Inicializa a pilha.

Parâmetros:

pPilha

- ponteiro para a pilha.

Retorna:

TRUE em caso a inicialização foi bem sucedida, FALSE caso contrário.

Observações:

InicPilha deve ser a primeria função a ser chamada, caso ocorra uma chamada a qualquer uma das outra funções o resultado e imprevisível, pois a pilha contem lixo de memória.

Veja também:

Push, Pop, VaziaPilha, TamanhoPilha, ImprimePilha

TipoItem* Pop

(

struct TipoPilha *

pPilha

)

Remove elemento do topo da pilha.

Parâmetros:

pPilha

- ponteiro para pilha.

Retorna:

Ponteiro para elemento que foi removido.

Veja também:

lePilha, Push, Pop, VaziaPilha, TamanhoPilha, ImprimePilha

bool Push	(	TipoItem *	item,
		struct TipoPilha *	pPilha
	)

Armazena um elemento no topo da pilha.

Parâmetros:

item	- item que sera armazenado no topo da pilha.
pPilha	- ponteiro para a pilha.

Retorna:

TRUE em caso elemento pode ser colocado no topo da pilha, FALSE caso contrário.

Observações:

A política desta pilha e LIFO (last in first out).

Veja também:

lePilha, InicPilha, Pop, VaziaPilha, TamanhoPilha, ImprimePilha

UINT TamanhoPilha

(

struct TipoPilha *

pPilha

)

Obtem número de elementos da pilha.

Parâmetros:

pPilha

- ponteiro para a pilha.

Retorna:

número de elementos da pilha.

Veja também:

lePilha, InicPilha, Push, Pop, VaziaPilha, ImprimePilha

bool VaziaPilha

(

struct TipoPilha *

pPilha

)

Verifica se a pilha possui elemento(s).

Parâmetros:

pPilha

- ponteiro para a pilha.

Retorna:

TRUE em caso a pilha esta vazia, FALSE caso contrário.

Observações:

A política desta pilha e LIFO (last in first out).

Veja também:

lePilha, InicPilha, Push, TamanhoPilha, ImprimePilha