力扣 622. 设计循环队列

题目来源：力扣（LeetCode）
链接：https://leetcode-cn.com/problems/design-circular-queue

设计你的循环队列实现。 循环队列是一种线性数据结构，其操作表现基于 FIFO（先进先出）原则并且队尾被连接在队首之后以形成一个循环。它也被称为“环形缓冲器”。

循环队列的一个好处是我们可以利用这个队列之前用过的空间。在一个普通队列里，一旦一个队列满了，我们就不能插入下一个元素，即使在队列前面仍有空间。但是使用循环队列，我们能使用这些空间去存储新的值。

你的实现应该支持如下操作：

MyCircularQueue(k): 构造器，设置队列长度为 k 。
Front: 从队首获取元素。如果队列为空，返回 -1 。
Rear: 获取队尾元素。如果队列为空，返回 -1 。
enQueue(value): 向循环队列插入一个元素。如果成功插入则返回真。
deQueue(): 从循环队列中删除一个元素。如果成功删除则返回真。
isEmpty(): 检查循环队列是否为空。
isFull(): 检查循环队列是否已满。

---

基本思路

                 空的循环队列                                       满的循环队列

定义一个循环队列结构体，成员变量包括队头front、队尾rear、队列容量k和一个用于储存数据的int*类型的data指针。

重点在于循环队列的判空和判满条件如何设置。对于判空，我们容易想到front == rear这一条件。而判满则不是rear + 1 == front。我们规定，队列中保留一个空白位置不存储任何数据。以上图为例，队尾位于8，而队头位于1的位置，因此，应该使用(rear + 1) % (k + 1) == front来作为判满条件（k为容量，即7，+ 1是为了把空白位置所占的空间也计算入内）。

那么接下来，我们使用C语言来实现循环队列。

二、代码实现

typedef struct {
    int* _data;
    int _front;
    int _rear;
    int _k;
} MyCircularQueue;


MyCircularQueue* myCircularQueueCreate(int k) {
    MyCircularQueue* mq = (MyCircularQueue*)malloc(sizeof(MyCircularQueue));
    mq->_data = (int*) malloc(sizeof(int) * (k + 1));
    mq->_front = mq->_rear = 0; 
    mq->_k = k;
    return mq;
}

注意，初始化队列的时候，需要申请k + 1的内存空间，这一点与上文所述一致。

bool myCircularQueueIsEmpty(MyCircularQueue* obj) {
        if(obj->_front == obj->_rear){		//判空
        return true;
    }
    else{
        return false;
    }
}

bool myCircularQueueIsFull(MyCircularQueue* obj) {
    if((obj->_rear + 1) % (obj->_k + 1) == obj->_front){		//判满
        return true;
    }
    else{
        return false;
    }
}

bool myCircularQueueEnQueue(MyCircularQueue* obj, int value) {
    if(myCircularQueueIsFull(obj)){
        return false;
    }
    obj->_data[obj->_rear] = value;
    obj->_rear++;
    if(obj->_rear > obj->_k){
        obj->_rear = 0;
    }
    return true;
}

入队之前需要先判满，若队列内仍有空间，则将数据插入队尾，再更新队尾位置。由于队列是循环的，若队尾的位置已经大于容量，则将队尾返回到0的位置。

bool myCircularQueueDeQueue(MyCircularQueue* obj) {
    if(myCircularQueueIsEmpty(obj)){
        return false;
    }
    obj->_front++;
    if(obj->_front > obj->_k){
         obj->_front = 0;
    }
    return true;
}

同理，出队之前需要先判空，若不为空则更新队头，同样需要注意队头的位置是否合法。

int myCircularQueueFront(MyCircularQueue* obj) {
    if(myCircularQueueIsEmpty(obj)){
        return -1;
    }
    return obj->_data[obj->_front];
}

取队头元素时要注意符合题目要求，若队列为空返回-1。

int myCircularQueueRear(MyCircularQueue* obj) {
    if(myCircularQueueIsEmpty(obj)){
        return -1;
    }
    if(obj->_rear == 0){
        return obj->_data[obj->_k];    
    }
    return obj->_data[obj->_rear - 1];
}

取队尾元素的时候还要额外注意队尾位于0位置的特殊情况。此情况下，不能直接取obj->_data[obj->_rear - 1]，因为我们保留了一个空白位置，不储存任何数据，这样就无法取到正确的值。因此，取obj->_data[obj->_k]即可。

void myCircularQueueFree(MyCircularQueue* obj) {
    free(obj->_data);
    free(obj);
}

/**
 * Your MyCircularQueue struct will be instantiated and called as such:
 * MyCircularQueue* obj = myCircularQueueCreate(k);
 * bool param_1 = myCircularQueueEnQueue(obj, value);
 \4
 * bool param_2 = myCircularQueueDeQueue(obj);
 
 * int param_3 = myCircularQueueFront(obj);
 
 * int param_4 = myCircularQueueRear(obj);
 
 * bool param_5 = myCircularQueueIsEmpty(obj);
 
 * bool param_6 = myCircularQueueIsFull(obj);
 
 * myCircularQueueFree(obj);
*/