API version 1

- ‐

CsvDocument

CSVデータを保持するクラスです。

CsvDocumentクラスには以下の特徴があります。

  1. 1個のCsvDocumentオブジェクトにすべてのセルデータが格納され、軽量です。

  2. 行、列とも自由に追加、削除ができます。

  3. ソートやマージ、ファイル入出力が可能です。

行や列を番号で指定する場合、上端の行が「0」で、下端の行は「行の数(rowsプロパティ値)-1」になります。

また、左端の列が「0」で、右端の列は「列の数(columnsプロパティ値)-1」になります。

条件キーの指定

find、load、parse、replace、save、splice、toStringメソッドでは入力/出力を行う行を条件指定することができますが、その書式は 「<列指定> [<比較型>] <演算子> <比較値>」の組になっており、各列は下記の意味と解釈されます。

複数の条件を指定した場合は、全ての条件に合致した行が処理されます。

列指定

検索キーとなる列を指定します。

指定内容

意味

数値

0から始まる列番号

[列名]

列名

比較型

比較するデータの型を指定します。

指定内容

意味

n または N

数値として比較

省略時

文字列として比較

演算子

比較方法を指定します。

指定内容

意味

==

カラム指定値と比較値が等しい

!=

カラム指定値と比較値が異なる

>

カラム指定値が比較値より大きい

>=

カラム指定値が比較値より大きいまたは等しい

<

カラム指定値が比較値より小さい

<=

カラム指定値が比較値より小さいまたは等しい

比較値

比較対象の値を指定します。

指定内容

意味

[列番号]

同じ行の別の列と比較します。

それ以外

指定した値と比較します。

指定例

内容

"0==A"

1列目がAになっている行に合致します。

"1n>100"

2列目が数値として100より大きい行に合致します。

"2==[3]"

3列目と4列目が文字列として等しい行に合致します。

"[value]n!=5"

列名「value」の列が数値として5と異なる行に合致します。