CSVDocument.Replaceメソッド

説明

指定された列の複数のセルのデータを一括で置き換えます。

検索条件を指定して置き換えるセルを選択できます。

呼出形式

var ret = csvdoc.Replace( row, col, val [, cond1 [, cond2, … ] ] )

戻り値

更新されたセルの数

引数

integer row

置き換えを開始する行の0で始まる行番号

rowで指定した行以降が置き換えの対象となります。

integer col

置き換える列の0で始まる列番号

String val

設定する文字列

文字列を直接指定するか、以下の書式で別の列の値を指定できます。

"[列番号]"

例

"[3]"

この例では、条件に一致したセルを、同じ行の4列目の値で置き換えます。

置き換える文字列が"["で始まる場合、"\["でエスケープします。\はCRS言語のエスケープ文字となるため、CRSスクリプト中に文字列定数で指定する場合には、2重に\を指定する必要がある点に注意してください。

例

"\\[12\\]"

String cond

置き換えるセルの検索条件

Loadメソッドと同様の書式で指定します。

検索条件は、最大で列の数と同じだけ指定することができ、複数指定した場合はANDにより結合されます。

例外

CSV-14

列の位置が不正です

使用例

var csvdoc = new CSVDocument;
csvdoc.Get("http://server/data1.csv");
 
/* すべての行の1列目を"new data"に更新 */
csvdoc.Replace(0, 0, "new data");
 
/* すべての行の2列目を3列目と同じ値に更新 */
csvdoc.Replace(0, 1, "[2]");
 
/* 4列目が"1"の行の5列目を3列目と同じ値に更新 */
csvdoc.Replace(0, 4, "[2]", "3==1");
 
/* 6列目が7列目と同じ行のを8列目を3列目と同じ値に更新 */
csvdoc.Replace(0, 7, "[2]", "5==[6]");

関連項目

Load、Findメソッド