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	列の位置が不正です

関連項目

条件キーの指定

load、findメソッド

使用例 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) 共にゼロからです") ;

}

replace¶

ドキュメント目次

目次