API version 1
- ‐
replace¶
指定された列の複数のセルのデータを一括で置き換えます。
列番号と検索条件を指定することで、条件に合致した行については、指定列のセル値を置き換えます。
呼出形式一覧
呼出形式 |
説明 |
---|---|
integer replace(integer startRow, integer col, string data[, string key_1[, ... key_N]]) |
複数のセルのデータを一括で置き換えます。 |
戻り値一覧
戻り値 |
説明 |
---|---|
integer |
置き換えを行った行数を返します。 |
引数一覧
引数 |
説明 |
---|---|
startRow |
置き換えを開始する0で始まる行番号を指定します。 |
col |
置き換え対象の0で始まる列番号を指定します。 |
data |
置き換え後のデータを指定します。 [数値]の形式(例: [4])を指定した場合は、指定した列番号のセルの値で置き換えます。
それ以外の場合は、引数文字列で置き換えます。ただし、「
\ 」という文字は無視されます。(「
[4] 」という文字列を指定したい場合は「\[4] 」と指定します。「\ 」を指定したい場合は「\\ 」と記述します。) |
key_1 |
検索条件を指定します。条件に合致する行に対して、セルデータの置き換えが行われます。指定がない場合は全行が置き換え対象となります。
指定方法の詳細については 条件キーの指定を参照してください。
|
key_N |
任意の数の引数を指定することができます。
2個以上の条件を指定した場合は、全ての条件に合致する行を抽出します。
|
例外
識別子 |
説明 |
---|---|
CRS::Common::Core::CSVDocument-2:2 |
列の位置が不正です |
関連項目
使用例
CRSダウンロード
Form csvDoc_02 {
x = 0;
y = 0;
width = 800;
height = 600;
var csn = new CSVDocument;
csn << csv {
01,01,02,03,04
10,11,12,13,14
20,21,22,23,24
30,31,32,33,34
} ;
var csd = new CSVDocument;
csd << csv {
0-A,0-B,0-C,0-D,0-F
1-A,1-B,1-C,1-D,1-F
2-A,2-B,2-C,2-D,2-F
3-A,3-B,3-C,3-D,3-F
} ;
print("2の列の値が 12の行は ",csn.find(0,"2N==12") ) ;
print("2の列が文字2-Cの行は ",csd.find(0,"2==2-C") ) ;
print("1行2列の値は ",csd.getCell(1,2));
var ret = csd.replace(0,2,"R-1","2==1-C") ;
print("2列が1-Cのセルを置き換えると ",csd.getCell(1,2));
print("CSVデータの値を文字列で出します ",csd.tostring(1) );
var cnw = csn.merge(csd) ;
print("ふたつをマージすると ",cnw.tostring(1) );
print("大きくなったCSVの6行2列の値は ",cnw.getCell(6,2));
cnw.truncate(5) ;
print("5行目以降を削除すると ",cnw.tostring(1) );
print("注) インデックスは行 (rows)、列(columns) 共にゼロからです") ;
}