# smplbuf 内部が配列構造のコンテナクラスです。初期化時にバッファの最大サイズを決定しますが、その最大サイズまでの範囲で可変長の配列として振る舞います。 ```cpp template smplbuf_local template smplbuf_attach template smplbuf_heap ``` `smplbuf`は要素の型`T`と[メモリの確保方法`alloc`](/v0.1.3/api-reference/classes/alloc.md)で指定したメモリ領域に対して配列の操作を提供するコンテナクラスです。`alloc`の指定は煩雑であるため`using`を用いた別名定義が行っています。 オブジェクトの宣言例です。宣言の直後に初期化用のメソッド呼び出しを行います。いずれも初期化直後の最大サイズは128バイトで、サイズは0です。必要に応じてサイズを拡張しながら使用します。 ```cpp // 内部に固定配列 smplbuf_local b1; b1.init_local(); //グローバル定義でなければ省略可能 // すでにある配列を利用する uint8_t buf[128]; smplbuf_attach b2; b2.attach(buf, 0, 128); // ヒープに確保する smplbuf_heap b3; b3.init_heap(128); ``` 上記の`uint8_t`型に限り別名定義があります。 ```cpp template smplbuf_u8 // smplbuf> smplbuf_u8_attach // smplbuf> smplbuf_u8_heap // smplbuf> ``` 通常の配列のように\[]演算子などを用いて要素にアクセスできますし、イテレータを用いたアクセスも可能です。 ```cpp smplbuf_u8<32> b1; b1.reserve(5); b1[0] = 1; b1[1] = 4; b1[2] = 9; b1[3] = 16; b1[4] = 25; for(uint8_t x : b1) { Serial << int(x) << ","; } ``` `push_back()`メソッドを定義しています。末尾にデータを追記するタイプのアルゴリズムが使用可能になります。 ## 宣言・初期化 ```cpp smplbuf_local smplbuf_local::init_local() smplbuf_attach smplbuf_attach::attach(T* buf, uint16_t size, uint16_t N) smplbuf_heap smplbuf_heap::init_heap(uint16_t N) // 例 // 内部に固定配列 smplbuf_local b1; b1.init_local(); // すでにある配列を利用する uint8_t buf[128]; smplbuf_attach b2; b2.attach(buf, 0, 128); // ヒープに確保する smplbuf_heap b3; b3.init_heap(128); ``` 型`T`でサイズ`N`のコンテナを宣言します。宣言後に初期化のメソッドを呼び出します。 `smplbuf_attach`では、使用するバッファの先頭ポインタ`T* buf`と配列の初期サイズ`size`と最大サイズ`N`を指定します。 `smplbuf_local`のみ、ローカルオブジェクトとして宣言する場合は、初期化メソッド`.init_local()`を省略できます。 {% hint style="danger" %} `alloc_local`でグローバルオブジェクトを生成する場合は、`smplbuf`コンテナの使用前に`.init_local()`メソッドを呼び出します。 {% endhint %} ## 初期化子リスト ```cpp void in_some_func() { smplbuf_local b1; b1.init_local(); b1 = { 0, 1, 2, 3, 4 }; smplbuf_local b2{0, 1, 2, 3, 4}; } ``` 初期化子リスト（イニシャライザリスト）`{ ... }` によるメンバーの初期化をできます。`smplbuf_local`のローカル宣言でのコンストラクタでの利用を除き、初期化のメソッドを呼び出した後に有効です。 * 代入演算子の右辺値 (`smplbuf_local`, `smplbuf_attach`, `smplbuf_heap`) * コンストラクタ(`smplbuf_local`のローカル宣言、グローバル宣言は不可) ## メソッド ### append(), push\_back(), pop\_back() ```cpp inline bool append(T&& c) inline bool append(const T& c) inline void push_back(T&& c) inline void push_back(const T& c) ``` 末尾にメンバー`c`を追加します。`append()`の戻り値は`bool`で、バッファが一杯で追加できないときに`false`が返ります。 `pop_back()`は末尾のエントリを抹消します。 ### empty(), size(), capacity() ```cpp inline bool empty() inline bool is_end() inline uint16_t size() inline uint16_t capacity() ``` `empty()`は配列に要素が格納されていない場合に`true`を戻します。`is_end()`は反対に配列サイズ一杯まで要素が格納されているときに`true`を戻します。 `size()`は配列の要素数を返します。 `capacity()`は配列の最大格納数を返します。 ### reserve(), reserve\_hear(), redim() ```cpp inline bool reserve(uint16_t len) inline void reserve_head(uint16_t len) inline void redim(uint16_t len) ``` `reserve()`は配列のサイズを拡張します。配列が格納されていない領域はデフォルトで初期化されます。 `reserve_hear()`は配列の先頭部に指定したサイズの領域を確保します。コンテナオブジェクトからは参照できない領域となります。例えばパケットペイロードのヘッダ部分を読み飛ばした部分配列にアクセスするようなコンテナとして利用できるようにします。確保した領域を戻しすべてアクセスできるようにコンテナを戻すには確保時と同じ負の値を与えます。 `redim()`は利用領域のサイズを変更します。`reserve()`と違い、未使用領域の初期化を行いません。 ### operator \[] ```cpp inline T& operator [] (int i) inline T operator [] (int i) const ``` 要素にアクセスします。 `i`に負の値を与えるとバッファー末尾からの要素となります。`-1`の場合は末尾の要素、`-2`は末尾から一つ手前となります。 --- # 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/smplbuf.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.