队列的实现（使用链表）

P. S.：以下代码均在VS2019环境下测试，不代表所有编译器均可通过。 P. S.：测试代码均未展示头文件stdio.h的声明，使用时请自行添加。
  

1、队列的概念

  只允许在一端进行插入数据操作，在另一端进行删除数据操作的特殊线性表，队列具有先进先出FIFO(First In First Out) 入队列：进行插入操作的一端称为队尾 出队列：进行删除操作的一端称为队头

  对于队列的实现我们可以选择数组和链表的形式，但如果是数组的话，静态和动态数组都有它的局限性，故本文主要拟使用链表的形式来实现队列。
  下面进入正文。

2、队列的链表实现方法

2.1 前言

  构建队列的需求有三个文件，包括Queue.c（用来书写逻辑的内容）、Queue.h（用来书写逻辑的声明）、test.c（用来测试我们所书写的代码）。

2.2 正文

  和我们书写代码的规则一致，使用链表实现队列时，往往会需要使用到结构体变量，在通常情况下我们都会将其进行重命名，以方便我们后续代码的使用。
  在此我们书写一个结构体变量QueueNode来表示链表中我们的节点，并对其重命名，结果如下：

typedef struct QueueNode
{
	int val;//对类型重命名后此行代码改为QDataType val;
	struct QueueNode* next;
}QNode,* pQNode;

  因为在实际使用中我们队列中的元素往往是多样的，故在此对类型进行重命名，以便后续需要更改时更加快捷，结果如下：

typedef int QDataType;

  当我们写完节点的结构体后，思考一下，如果需要实现队列的功能，“先进先出”，那么就需要用两个指针来分别标记头节点和尾节点。所以我们如果要实现插入数据的功能时，就要将函数写成以下形式。

void QueuePush(pQNode* phead,pQNode* ptail,QDataType x);

  而后面每个函数都需要传入两个参数，并且还用到了二级指针，十分容易出现错误，故我们可以将头节点，尾节点分装成一个结构体，来表示整个队列的信息，并且可以额外加入一个变量 size 来记录队列中的数据个数。故此结构体如下，同样进行重命名以便后续使用：

typedef struct Queue
{
	pQNode phead;
	pQNode ptail;
	int size;
}Queue, * pQueue;

  下面我们就可以在头文件中一次性将需要实现的接口函数写出来，以便我们在源文件中实现。

//初始化队列信息
void QueueInit(pQueue pq);

//销毁队列
void QueueDestroy(pQueue pq);

//队列插入信息
void QueuePush(pQueue pq, QDataType x);

//队列消除信息
void QueuePop(pQueue pq);

//队列判断是否为空
bool QueueEmpty(pQueue pq);

//队列数据个数查询
int QueueSize(pQueue pq);

//队列队首的数据
QDataType QueueFront(pQueue pq);

//队列队尾的数据
QDataType QueueBack(pQueue pq);

  下面进入相关接口的函数实现。

2.2.1 队列的初始化

  对于栈的初始化，代码如下：

void QueueInit(pQueue pq)
{
	assert(pq);
	pq->phead = pq->ptail = NULL;
	pq->size = 0;
}

2.2.2 队列的销毁

  对于栈的销毁，代码如下：

void QueueDestroy(pQueue pq)
{
	assert(pq);
	pQNode cur = pq->phead;
	while(cur)
	{
		pQNode next = cur->next;
		free(cur);
		cur = next;
	}
	pq->phead = pq->ptail = NULL;
	pq->size = 0;
}

2.2.3 队列插入信息

  队列插入信息代码如下：

void QueuePush(pQueue pq, QDataType x)
{
	assert(pq);
	pQNode newnode = (pQNode)malloc(sizeof(QNode));
	if(newnode == NULL)
	{
		perror("QueuePush:malloc");
		return;
	}
	newnode->next = NULL;
	newnode->val = x;
	if(pq->ptail == NULL)//只有一个节点
	{
		pq->ptail = pq->phead = newnode;
	}
	else//多个节点
	{
		pq->ptail->next = newnode;
		pq->ptail = newnode;
	}
	pq->size++;
}

2.2.4 队列删除信息

  队列删除信息代码如下：

void QueuePop(pQueue pq)
{
	assert(pq);
	assert(pq->size != 0);
	if(pq->phead == pq->ptail)//只有一个节点
	{	
		free(pq->phead);
		pq->phead = pq->ptail = NULL;
	}	
	else//多个节点
	{
		pQNode tmp = pq->phead->next;
		free(pq->phead);
		pq->phead = tmp;
	}
	pq->size--;
}

2.2.5 判断队列是否为空

  判断队列是否为空代码如下：

bool QueueEmpty(pQueue pq)
{
	assert(pq);
	return pq->size == 0;
}

2.2.6 队列中数据个数

  队列中数据个数的代码如下：

int QueueSize(pQueue pq)
{
	assert(pq);
	return pq->size;
}

2.2.7 队首的数据

  取队首数据代码如下

QDataType QueueFront(pQueue pq)
{
	assert(pq);
	assert(pq->size != 0);
	return pq->phead->val;
}

2.2.8 队尾的数据

  取队尾数据代码如下

QDataType QueueBack(pQueue pq)
{
	assert(pq);
	assert(pq->size != 0);
	return pq->ptail->val;
}

3、完整代码展示

  Queue.h:

#pragma once

#include <stdio.h>
#include <stdbool.h>
#include <stdlib.h>
#include <assert.h>

typedef int QDataType;

typedef struct QueueNode
{
	struct QueueNode* next;
	QDataType val;
}QNode, * pQNode;

typedef struct Queue
{
	pQNode phead;
	pQNode ptail;
	int size;
}Queue, * pQueue;

//队列初始化
void QueueInit(pQueue pq);

//队列销毁
void QueueDestroy(pQueue pq);

//队列插入数据
void QueuePush(pQueue pq, QDataType x);

//队列删除数据
void QueuePop(pQueue pq);

//队列数据个数
int QueueSize(pQueue pq);

//队列判空
bool QueueEmpty(pQueue pq);

//取队列头数据
QDataType	QueueFront(pQueue pq);

//取队列尾数据
QDataType QueueBack(pQueue pq);

  Queue.c:

#include "Queue.h"

//队列初始化
void QueueInit(pQueue pq)
{
	assert(pq);
	pq->phead = NULL;
	pq->ptail = NULL;
	pq->size = 0;
}

//队列销毁
void QueueDestroy(pQueue pq)
{
	assert(pq);
	pQNode cur = pq->phead;
	while (cur)
	{
		pQNode next = cur->next;
		free(cur);
		cur = next;
	}
	pq->phead = pq->ptail = NULL;
	pq->size = 0;
}

//队列插入数据
void QueuePush(pQueue pq, QDataType x)
{
	assert(pq);
	pQNode tmp = (pQNode)malloc(sizeof(QNode));
	if (tmp == NULL)
	{
		perror("QueuePush:malloc");
		return;
	}
	tmp->next = NULL;
	tmp->val = x;
	if (pq->ptail == NULL)
	{
		pq->phead = pq->ptail = tmp;
	}
	else
	{
		pq->ptail->next = tmp;
		pq->ptail = tmp;
	}
	pq->size++;
}

//队列删除数据
void QueuePop(pQueue pq)
{
	assert(pq);
	assert(pq->size != 0);
	if (pq->phead == pq->ptail)
	{
		free(pq->phead);
		pq->phead = pq->ptail = NULL;
	}
	else
	{
		pQNode tmp = pq->phead->next;
		free(pq->phead);
		pq->phead = tmp;
	}
	pq->size--;
}

//队列数据个数
int QueueSize(pQueue pq)
{
	assert(pq);
	return pq->size;
}

//队列判空
bool QueueEmpty(pQueue pq)
{
	assert(pq);
	return pq->size == 0;
}

//取队列头数据
QDataType	QueueFront(pQueue pq)
{
	assert(pq);
	assert(pq->size != 0);
	return pq->phead->val;
}

//取队列尾数据
QDataType QueueBack(pQueue pq)
{
	assert(pq);
	assert(pq->size != 0);
	return pq->ptail->val;
}

  test.c:

#include "Queue.h"

int main()
{
	Queue s;
	QueueInit(&s);
	QueuePush(&s, 1);
	QueuePush(&s, 2);
	QueuePush(&s, 3);
	QueuePush(&s, 4);
	printf("%d\n", QueueFront(&s));
	printf("%d\n", QueueBack(&s));
	QueuePop(&s);
	printf("%d\n", QueueFront(&s));
	printf("%d\n", QueueSize(&s));
	QueuePop(&s);
	QueuePop(&s);
	printf("%d\n", QueueSize(&s));
	if (QueueEmpty(&s))
		printf("空了\n");
	else
		printf("有东西\n");
	QueuePop(&s);
	if (QueueEmpty(&s))
		printf("空了\n");
	else
		printf("有东西\n");
	QueueDestroy(&s);

	return 0;
}

4、结语

  十分感谢您观看我的原创文章。
  本文主要用于个人学习和知识分享，学习路漫漫，如有错误，感谢指正。
  如需引用，注明地址。