# smplque FIFOキューを構造のコンテナクラスです。 ```cpp template smplbuf_local template smplbuf_attach template smplbuf_heap ``` `smplque`は要素の型`T`と[メモリの確保方法`alloc`](/v0.1.3/api-reference/classes/alloc.md)で指定したメモリ領域に対してFIFOキューの操作を提供するコンテナクラスです。`alloc`の指定は煩雑であるため`using`を用いた別名定義が行っています。 {% hint style="warning" %} 要素型は原則として数値や数値などを格納する構造体を想定しています。デストラクタによる破棄手続きが必要なオブジェクトを格納することを想定していません（キューから要素を抹消する際にオブジェクトを抹消する処理をしていないため）。 {% endhint %} 宣言時に割り込み禁止設定を行うクラス`Intr`を登録することが出来ます。このクラスは指定しない場合は、割り込み禁止制御を行わない通常の動作となります。 オブジェクトの宣言例です。宣言の直後に初期化用のメソッド呼び出しを行います。いずれも初期化直後の最大サイズは128バイトで、サイズは0です。必要に応じてサイズを拡張しながら使用します。 ```cpp // 内部に固定配列 smplque_local q1; q1.init_local(); // すでにある配列を利用する uint8_t buf[128]; smplque_attach q2; q2.attach(buf, 128); // ヒープに確保する smplque_heap q3; q3.init_heap(128); ``` FIFOキューですので`push()`,`pop()`,`front()`といったメソッドを用いて操作します。 ```cpp smplque_local q1; q1.init_local(); q1.push(1); q1.push(4); q1.push(9); q1.push(16); q1.push(25); while(!q1.empty()) { Serial << int(q1.front()) << ','; q1.pop(); } // output -> 1,4,9,16,25, ``` イテレータによるアクセスも可能です。 ```cpp smplque_local q1; q1.init_local(); q1.push(1); q1.push(4); q1.push(9); q1.push(16); q1.push(25); for(int x : q1) { Serial << int(x) << ','; } auto&& minmax = std::minmax_element(q1.begin(), q1.end()); Serial << "min=" << int(*minmax.first) << ",max=" << int(*minmax.second); // output -> 1,4,9,16,25,min=1,max=25[] ``` ## 宣言・初期化 ```cpp smplbuf_local smplbuf_local::init_local() smplbuf_attach smplbuf_attach::attach(T* buf, uint16_t N) smplbuf_heap smplbuf_heap::init_heap(uint16_t N); //例 // 内部に固定配列 smplque_local q1; q1.init_local(); // すでにある配列を利用する uint8_t buf[128]; smplque_attach q2; q2.attach(buf, 128); // ヒープに確保する smplque_heap q3; q3.init_heap(128); ``` 型`T`でサイズ`N`のコンテナを宣言します。宣言後に初期化のメソッドを呼び出します。 `smplque_local`のみ、ローカルオブジェクトとして宣言する場合は、初期化メソッド`.init_local()`を省略できます。 {% hint style="danger" %} `smplque_local`のグローバルオブジェクトを生成する場合は、`smplbuf`コンテナの使用前に`.init_local()`メソッドを呼び出します。 {% endhint %} ## メソッド ### push(), pop(), front(), back() ```cpp inline void push(T&& c) inline void push(T& c) inline void pop() inline T& front() inline T& back() inline T& pop_front() ``` `push()`はエントリをキューに追加します。 `pop()`はエントリをキューから抹消します。 `front()`は先頭のエントリ（一番最初に追加されたもの)を参照します。 `back()`は末尾のエントリ（一番最後に追加されたもの)を参照します。 `pop_front()`は先頭のエントリを戻り値として参照し、同時にそのエントリをキューから抹消します。 ### empty(), size(), is\_full() ```cpp inline bool empty() inline bool is_full() inline uint16_t size() inline uint16_t capacity() ``` `empty()`は配列に要素が格納されていない場合に`true`を戻します。`is_full()`は反対に配列サイズ一杯まで要素が格納されているときに`true`を戻します。 `size()`はキューに格納されている要素数を返します。 `capacity()`はキューの最大格納数を返します。 ### clear() ```cpp inline void clear() ``` キューのすべての要素を抹消します。 ### operator \[] ```cpp inline T& operator[] (int i) ``` 要素にアクセスします。`0`が最初に追加した要素です。 ## イテレータ ```cpp inline smplque::iterator begin() inline smplque::iterator end() ``` `begin()`と`end()`によるイテレータを取得できます。イテレータの先頭はキューの最初に登録した要素です。イテレータを用いることで範囲for文やアルゴリズムが利用できます。 応用として[axis\_xyzt構造体の特定のメンバーに注目したイテレータによるアクセス](/v0.1.3/api-reference/classes/axis_xyzt.md)があります。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://mwx.twelite.info/v0.1.3/api-reference/classes/smplque.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.