p5.Table

Tableオブジェクトは、従来のスプレッドシートのように、 複数の行と列でデータを保存します。テーブルは、 ゼロから動的に、または既存のファイルからデータを使用して 生成することができます。

シンタックス

p5.Table([rows])

パラメーター

rows
p5.TableRow[]:

p5.TableRowオブジェクトの配列

フィールド

columns

テーブルが「ヘッダー」パラメータで読み込まれた場合、 テーブルの列名を含む配列。

rows

テーブルの行を構成するp5.TableRowオブジェクトを含む配列。 getRows()を呼び出した場合と同じ結果です。

メソッド

addRow

addRow()を使用して、p5.Tableオブジェクトに新しいデータ行を 追加します。デフォルトでは、 空の行が作成されます。通常、新しい行への参照を TableRowオブジェクトに保存し(上の例のnewRowを参照)、 その後set()を使用して個々の値を設定します。

p5.TableRowオブジェクトがパラメータとして含まれている場合、 その行が複製されてテーブルに追加されます。

removeRow

テーブルオブジェクトから行を削除します。

getRow

指定されたp5.TableRowへの参照を返します。この参照は 選択された行の値を取得および設定するために使用できます。

getRows

テーブルからすべての行を取得します。p5.TableRowの配列を返します。

findRow

提供された値を含むテーブルの最初の行を見つけ、 その行への参照を返します。複数の行が一致する可能性がある場合でも、 最初に一致した行のみが返されます。検索する列は、 IDまたはタイトルのいずれかで指定できます。

findRows

提供された値を含むテーブルの行を見つけ、 それらの行への参照を返します。配列を返すため、 上の例に示すように、forを使用してすべての行を 反復処理する必要があります。検索する列は、 IDまたはタイトルのいずれかで指定できます。

matchRow

提供された正規表現に一致するテーブルの最初の行を見つけ、 その行への参照を返します。複数の行が一致する可能性がある場合でも、 最初に一致した行のみが返されます。検索する列は、 IDまたはタイトルのいずれかで指定できます。

matchRows

提供された正規表現に一致するテーブルの行を見つけ、 それらの行への参照を返します。配列を返すため、 例に示すように、forを使用してすべての行を反復処理する必要があります。 検索する列は、IDまたはタイトルのいずれかで指定できます。

getColumn

指定された列のすべての値を取得し、それらを配列として返します。 列はIDまたはタイトルのいずれかで指定できます。

clearRows

テーブルからすべての行を削除します。すべての行が削除されますが、 列と列のタイトルは維持されます。

addColumn

addColumn()を使用して、Tableオブジェクトに新しい列を 追加します。通常、タイトルを指定して、後で列を 名前で簡単に参照できるようにしたいでしょう。(タイトルが 指定されていない場合、新しい列のタイトルはnullになります。)

getColumnCount

テーブルの総列数を返します。

getRowCount

テーブルの総行数を返します。

removeTokens

指定された文字(または「トークン」)を削除します。

列が指定されていない場合、すべての列と行の値が 処理されます。特定の列は、IDまたはタイトルの いずれかで参照できます。

trim

文字列テーブル値の先頭と末尾の空白(スペースやタブなど)を トリムします。列が指定されていない場合、すべての列と行の 値がトリムされます。特定の列は、IDまたはタイトルの いずれかで参照できます。

removeColumn

removeColumn()を使用して、Tableオブジェクトから 既存の列を削除します。削除する列は、 タイトル(文字列)またはインデックス値(整数)の いずれかで識別できます。 removeColumn(0)は最初の列を削除し、removeColumn(1)は 2番目の列を削除し、以下同様です。

set

テーブルの指定された行と列に値を格納します。 行はIDで指定され、列はIDまたはタイトルの いずれかで指定できます。

setNum

テーブルの指定された行と列にFloat値を格納します。 行はIDで指定され、列はIDまたはタイトルの いずれかで指定できます。

setString

テーブルの指定された行と列に文字列値を格納します。 行はIDで指定され、列はIDまたはタイトルの いずれかで指定できます。

get

テーブルの指定された行と列から値を取得します。 行はIDで指定され、列はIDまたはタイトルの いずれかで指定できます。

getNum

テーブルの指定された行と列からFloat値を取得します。 行はIDで指定され、列はIDまたはタイトルの いずれかで指定できます。

getString

テーブルの指定された行と列から文字列値を取得します。 行はIDで指定され、列はIDまたはタイトルの いずれかで指定できます。

getObject

すべてのテーブルデータを取得し、オブジェクトとして返します。列名が 渡された場合、各行オブジェクトはその属性をタイトルとして 保存されます。

getArray

すべてのテーブルデータを取得し、多次元配列として返します。

Notice any errors or typos? Please let us know. Please feel free to edit src/io/p5.Table.js and open a pull request!

関連するリファレンス