xref: /aosp_15_r20/frameworks/native/services/surfaceflinger/Utils/RingBuffer.h (revision 38e8c45f13ce32b0dcecb25141ffecaf386fa17f)
1*38e8c45fSAndroid Build Coastguard Worker /*
2*38e8c45fSAndroid Build Coastguard Worker  * Copyright 2023 The Android Open Source Project
3*38e8c45fSAndroid Build Coastguard Worker  *
4*38e8c45fSAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*38e8c45fSAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*38e8c45fSAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*38e8c45fSAndroid Build Coastguard Worker  *
8*38e8c45fSAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*38e8c45fSAndroid Build Coastguard Worker  *
10*38e8c45fSAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*38e8c45fSAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*38e8c45fSAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*38e8c45fSAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*38e8c45fSAndroid Build Coastguard Worker  * limitations under the License.
15*38e8c45fSAndroid Build Coastguard Worker  */
16*38e8c45fSAndroid Build Coastguard Worker 
17*38e8c45fSAndroid Build Coastguard Worker #pragma once
18*38e8c45fSAndroid Build Coastguard Worker 
19*38e8c45fSAndroid Build Coastguard Worker #include <stddef.h>
20*38e8c45fSAndroid Build Coastguard Worker #include <array>
21*38e8c45fSAndroid Build Coastguard Worker 
22*38e8c45fSAndroid Build Coastguard Worker namespace android::utils {
23*38e8c45fSAndroid Build Coastguard Worker 
24*38e8c45fSAndroid Build Coastguard Worker template <class T, size_t SIZE>
25*38e8c45fSAndroid Build Coastguard Worker class RingBuffer {
26*38e8c45fSAndroid Build Coastguard Worker     RingBuffer(const RingBuffer&) = delete;
27*38e8c45fSAndroid Build Coastguard Worker     void operator=(const RingBuffer&) = delete;
28*38e8c45fSAndroid Build Coastguard Worker 
29*38e8c45fSAndroid Build Coastguard Worker public:
30*38e8c45fSAndroid Build Coastguard Worker     RingBuffer() = default;
31*38e8c45fSAndroid Build Coastguard Worker     ~RingBuffer() = default;
32*38e8c45fSAndroid Build Coastguard Worker 
capacity()33*38e8c45fSAndroid Build Coastguard Worker     constexpr size_t capacity() const { return SIZE; }
34*38e8c45fSAndroid Build Coastguard Worker 
size()35*38e8c45fSAndroid Build Coastguard Worker     size_t size() const { return mCount; }
36*38e8c45fSAndroid Build Coastguard Worker 
next()37*38e8c45fSAndroid Build Coastguard Worker     T& next() {
38*38e8c45fSAndroid Build Coastguard Worker         mHead = static_cast<size_t>(mHead + 1) % SIZE;
39*38e8c45fSAndroid Build Coastguard Worker         if (mCount < SIZE) {
40*38e8c45fSAndroid Build Coastguard Worker             mCount++;
41*38e8c45fSAndroid Build Coastguard Worker         }
42*38e8c45fSAndroid Build Coastguard Worker         return mBuffer[static_cast<size_t>(mHead)];
43*38e8c45fSAndroid Build Coastguard Worker     }
44*38e8c45fSAndroid Build Coastguard Worker 
front()45*38e8c45fSAndroid Build Coastguard Worker     T& front() { return (*this)[0]; }
front()46*38e8c45fSAndroid Build Coastguard Worker     const T& front() const { return (*this)[0]; }
47*38e8c45fSAndroid Build Coastguard Worker 
back()48*38e8c45fSAndroid Build Coastguard Worker     T& back() { return (*this)[size() - 1]; }
back()49*38e8c45fSAndroid Build Coastguard Worker     const T& back() const { return (*this)[size() - 1]; }
50*38e8c45fSAndroid Build Coastguard Worker 
51*38e8c45fSAndroid Build Coastguard Worker     T& operator[](size_t index) {
52*38e8c45fSAndroid Build Coastguard Worker         return mBuffer[(static_cast<size_t>(mHead + 1) + index) % mCount];
53*38e8c45fSAndroid Build Coastguard Worker     }
54*38e8c45fSAndroid Build Coastguard Worker 
55*38e8c45fSAndroid Build Coastguard Worker     const T& operator[](size_t index) const {
56*38e8c45fSAndroid Build Coastguard Worker         return mBuffer[(static_cast<size_t>(mHead + 1) + index) % mCount];
57*38e8c45fSAndroid Build Coastguard Worker     }
58*38e8c45fSAndroid Build Coastguard Worker 
clear()59*38e8c45fSAndroid Build Coastguard Worker     void clear() {
60*38e8c45fSAndroid Build Coastguard Worker         mCount = 0;
61*38e8c45fSAndroid Build Coastguard Worker         mHead = -1;
62*38e8c45fSAndroid Build Coastguard Worker     }
63*38e8c45fSAndroid Build Coastguard Worker 
64*38e8c45fSAndroid Build Coastguard Worker private:
65*38e8c45fSAndroid Build Coastguard Worker     std::array<T, SIZE> mBuffer;
66*38e8c45fSAndroid Build Coastguard Worker     int mHead = -1;
67*38e8c45fSAndroid Build Coastguard Worker     size_t mCount = 0;
68*38e8c45fSAndroid Build Coastguard Worker };
69*38e8c45fSAndroid Build Coastguard Worker 
70*38e8c45fSAndroid Build Coastguard Worker } // namespace android::utils
71