wreplace


目次

概要

ワークシート内のセル値の検索と置換

コマンドラインでの使用法

1. wreplace find_value:=0 replace_value:=0 cond_value:=lt;
2. wreplace rng:=col(1) type:=str find_str:="a*c" replace_str:="abc" wildcards:=1;
3. wreplace col(A)[1]:end[40] find_value:=-- replace_value:=0;

Xファンクションの実行オプション

スクリプトからXファンクションにアクセスする場合、追加のオプションスイッチについてのページを参照してください。

変数

表示
名 		変数
名 		I/O
と
データ型 		デフォルト
値 		説明
入力 rng

入力/出力

Range

<active>
 置き換えを実行する範囲を指定します。
データの種類 type

入力

int

0
 検索および置換するデータのタイプを指定します。

オプションリスト：

  • num:数値
    数値データを検索して置換します。
  • str:文字列
    文字列を検索して置換します。
検索対象(--は欠損値) find_value

入力

double

これは、データの種類（type 変数）で数値（num）が選択されている場合にのみ使用できます。条件変数で選択した演算子と組み合わせると、この変数の値は、置換する値を見つけるために使用される条件を定義します。"--"は、欠損している値を表します。
検索対象 find_str

入力

string

これは、データの種類（type 変数）で文字列（str）が選択されている場合にのみ使用できます。検索する文字列の指定に使用します。
条件 cond_value

入力

int

0
 これは、データの種類（type 変数）で数値（num）が選択されている場合にのみ使用できます。演算子を指定します。検索対象で指定された値(find_value変数)と組み合わせることで、置換するデータの検索に使用する条件を定義できます。

オプションリスト：

  • eq:データ=
    検索対象 の値と等しいデータを検索します。
  • lt:データ<
    検索対象の値より小さいデータを検索します。
  • le:データ<=
    検索対象の値以下のデータを検索します。
  • gt:データ>
    検索対象の値よりも大きいデータを検索します。
  • ge:データ>=
    検索対象の値以上のデータを検索します。
  • ne:データ<>
    検索対象の値と等しくないデータを検索します。
置き換え replace_value

入力

double

これは、データの種類（type 変数）で数値（num）が選択されている場合にのみ使用できます。見つかったすべてのセルが置換される新しい値を指定します。
置き換え replace_str

入力

string

これは、データの種類（type 変数）で文字列（str）が選択されている場合にのみ使用できます。見つかったすべての文字列が置換される新しい文字列を指定します。
許容値 tolerance

入力

double

1E-8
 これは、データの種類（type 変数）で数値（num）が選択されている場合にのみ使用できます。置換するワークシートデータの検索に使用される許容値を指定します。ワークシートのデータ値と検索対象の値の絶対差が許容範囲より小さい場合、これら2つの値は等しいと見なされます。
絶対値を使う use_abs

入力

int

0
 これは、データの種類（type 変数）で数値（num）が選択されている場合にのみ使用できます。ワークシートデータの絶対値を使用して特定の条件をテストするかどうかを指定します。条件が「>」または「<」または「<>」の場合、これは無効になります。
条件が真の場合符号を保持 keep_sign

入力

int

0
 これは、データの種類（type 変数）で数値（num）が選択されている場合にのみ使用できます。条件が真で、ワークシートデータが置換された場合に、元の値の符号を保持するかどうかを指定します。
条件が偽の場合欠落値として設定 set_missing

入力

int

0
 これは、データの種類（type 変数）で数値（num）が選択されている場合にのみ使用できます。元の値が条件を満たさないセルに欠落値を設定するかどうかを指定します。
完全一致 cond_str

入力

int

0
 これは、データの種類（type 変数）で文字列（str）が選択されている場合にのみ使用できます。検索する文字列が、入力した文字列全体と完全に一致するかどうかを指定します。
大文字小文字の区別 con_case

入力

int

0
 これは、データの種類（type 変数）で文字列（str）が選択されている場合にのみ使用できます。文字列検索で大文字と小文字を区別するかどうかを指定します。
リンクセルをスキップ skip_link

入力

int

0
 リンクを含むセルをスキップするかどうかを指定します。
ワイルドカード文字を使う wildcards

入力

int

0
 ワイルドカードを使用するかどうかを指定します。ワイルドカードを使用する場合、"*"は任意の文字列を表し、"?"は任意の文字を表すことができます。
ラベル行を含める label

入力

int

0
 列ラベル行（ロングネーム、単位、コメントなど）を検索対象に含めるかどうかを指定します。
undo

入力

int

0
 Origin 2024bで廃止されました。代わりにXFスイッチ「-u」を使用してください。
検索場所 lookin

入力

int

6
 指定した値または文字列を検索する場所を指定します。

オプションリスト：

  • active_sheet:アクティブワークシート
    アクティブなワークシートが検索されます。
  • active_book:アクティブワークブック
    アクティブなワークブックが検索されます。
  • all_in_active_folder:アクティブフォルダ中の全ワークブック
    アクティブフォルダ内のすべてのブックが検索されます。ただし、サブフォルダのワークブックは検索されません。
  • recursive_in_active_folder:アクティブフォルダ中の全ワークブック（サブフォルダ適用）
    サブフォルダ内を含む、アクティブフォルダ内の全てのワークブックが検索されます。
  • open_in_active_folder:アクティブフォルダ中の全てのワークブック（オープンのもの）
    アクティブフォルダ内の非表示でないワークブックがすべて検索されます。ただし、サブフォルダのワークブックは検索されません。
  • all_in_project:プロジェクト内の全ワークブック
    プロジェクト内の全てのワークブックが検索されます。
  • Specified:特定範囲
    rng変数で指定された範囲が検索されます。

説明

このXファンクションは、ワークシートセル内のテキストや数値を検索して置換することができます。

サンプル

/*
この例では、Xファンクションwreplaceを使用して負の値を見つけ、それらをゼロに置き換えます。
1.Originのブックにサンプルデータをインポート
2.アクティブシート内の負の値を検索してゼロに置き換えます。
*/
// 新たらしいブックを作成
newbook;
// ファイルインポート
string fname$ = system.path.program$ + "Samples\Curve Fitting\Multiple Peaks.dat";
impasc;
// 負の値を検索して置き換え
wreplace type:=num find_value:=0 cond_value:=lt replace_value:=0 lookin:=active_sheet;
/*
次の例では、Xファンクション wreplace を使用して、
欠損値を1250に置き換えます。
1.Originのブックにサンプルデータをインポート
2.欠落値を1250に置き換えます。
*/
// 新しいブックを作成
newbook;
// ファイルをインポート
string fname$ = system.path.program$ + "Samples\Graphing\Box Chart.dat";
impasc;

// 欠損値を1250に置き換え
wreplace rng:=col(a)[1]:end[31] find_value:=-- replace_value:=1250;

関連するXファンクション

mreplace