%( ) 置換 - 文字列置換

string-substitution

文字列式の置換String Expression Substitution

%(str$)

コマンドに文字列を渡す
LabTalkコマンドは、数値引数と文字列引数の両方を受け入れます。 数値変数または式は直接渡すことができます。例えば、worksheet -a 2*2 は4つの新しい列を追加します。リアルタイムで解決された文字列をコマンドに渡すには、文字列引数を%( )で囲む必要があります。E.g.

string name$ = "Book1";
//Originの他のウィンドウをアクティブにし、次のコマンドを実行してBook1をアクティブにする
win -a name$; //「bookname$」という名前のウィンドウをアクティブにしようとしてするため機能しない
win -a %(name$) //正しく動作

" "内の文字列を連結
複数の文字列を " " で連結する場合は、%(str$)置換を使用します。

現在のウィンドウがBook1でSheet1がアクティブだとします。

string name$ = "wks.name$ in page.name$"; 
name$=; //正確に"wks.name$ in page.name$"を印字
string name$ = "%(wks.name$) in %(page.name$)";
name$=; //Sheet1 in Book1と印字
// " "内でない場合は、%( )を追加する必要なし
string name$ =wks.name$ + " in " +page.name$; 
name$=; //Sheet1 in Book1と印字

文字列を数値に変換
数値のみを含む文字列の場合は、%(str$) を使用して数値に変換できます。これは、数値を文字列に変換する $( ) の逆の操作です。

// 文字列「456」を数値 456 に変換
string myString$ = "456";
int myNum=%(myString$);

範囲式の置換

%(rangeVariable)
範囲変数で%( ) 置換が使用されると、範囲文字列に解決されます。

range rA=[Book1]Sheet1!A;
type %(rA); //範囲文字列を出力

このため、ユーザは既存の範囲変数に基づいて新しい範囲を構築できるため、コードの一元化に役立ちます。

range rwks = sheet1!; //rwks で現在のブックのシート1を指す
range r1= %(rwks)col(a); //r1でシートの列Aを指す
r1=data(0,100); //r1に0、1、...、100を入力
rwks.addcol(); //シートに列を追加
range r2 = %(rwks)wcol( rwks.ncols ); //r2は、新しく追加された列である最後の列を指す
r2=r1/10; //r1, 0, 0.1, ..., 10に基づいてr2を計算

ワークシート列とセルの置換

データセット置換Dataset Substitution

%(workbookName, column) または %([workbookName]sheet, column)
ここで、

• workbookname はワークブックのショートネーム
• sheet はシート名、ラベル、インデックスのいずれか
• column は列ショートネーム、ロングネーム、インデックスのいずれか

Origin 8より前のバージョンでは、ワークブックごとにシートが1つしかなく、最初の引数に workbookName を指定するだけでよいため、2つの構文がサポートされています。最近のバージョンでは、複数のワークシートをサポートしているので、最初の引数でブックとシートの両方を指定する必要があります。アクティブなシートの列を参照する場合は、引き続き1番目の構文を使用できます。

%(Book1, B) //列ショートネームを使用
%(%H,""Average Temp") //列ロングネームを使用
winName$="Book1"; %(%(winName$), 2); //列インデックスを使用

%([Book1]Sheet1, B) //シート名と列ショートネームを使用
%([%H]"test result",""Average Temp") //シートラベルと列ロングネームを使用
winName$="Book1"; %([%(str$)]3, 2); //シートおと列インデックスを使用

例: 右側の列の名前を置換し、%Aと%Bに割り当てます。2番目のケースでは、指定ブックまたはシートが存在しない場合、エラーは発生しませんが、置換は無効になります。

%A = %(%H, B); // アクティブブックのアクティブシートの列B
type %A; //列名を返す。2番目のシートがアクティブの場合Book1_B@2を返す
type $(%A) //列値を返す
%B = %([Book1]Sheet3,2); // Book1、Sheet3の列2
type %B; //列名を返す。例：Book1_B@3
type $(%B) //列値を返す

Note: 括弧を使って、文字列レジスタ自体に割り当てを実行するのではなく、文字列レジスタ変数に含まれる名前を持つデータセットで実行される割り当てを強制的に行うことができます。

%A = %(Book1,2);   // 列2のデータセット名を%Aに割り当て
(%A) = %(Book1,1); // 列1のデータを列2にコピー

列置換を使用した列計算

ブックまたはシートからデータセット名を取得する機能は、次のような異なるシートにある列間の計算を行うのにとても役立ちます。

// Sheet2とSheet3のcol(1)を合計し、アクティブシートのcol(1)に入れる 
col(1)=%([%H]sheet2, 1) + %([%H]sheet3, 1);
 
// Book2の最初のシートでcol "signal"を減算 
// そして、アクティブブックのSheet3の列"calibrated"に結果を入れる
%([%H]sheet3, "calibrated")=col(signal) - %([Book2]1,signal);

ロングネームを使う場合、column 名は引用符で囲む必要があります。引用符が無い場合、Originは最初にショートネームを探し、見つからなければ、ロングネームを使用します。上述のサンプルの場合、

%([%H]sheet3, "calibrated")

とすると、強制的にロングネームを探しますが、

%([Book2]1,signal)

とした場合、ショートネームを持つ列がない場合のみロングネームを使います。

セルの内容

%(workbookName, column,row[,format]) or %([workbookName]sheetName, column,row[,format])

• workbookname はワークブックのショートネーム
• sheet はシート名、ラベル、インデックスのいずれか
• column は列ショートネーム、ロングネーム、インデックスのいずれか
• row は行インデックス
• formatは任意でOrigin 8.1以降で利用可能
  • フィーマットなし - フル精度
  • W = セル形式または列形式に基づくWYSIWYG
  • カスタムフォーマット（Originフォーマットを参照）

Note: セル置換構文の別のバリエーション%([workbookName]sheetName, @WL, column[row][,format]) はセルから値を取得するために使用できます。セルに値を割り当てるために使用することはできません。

%(Book1, B, 4) //列ショートネームを使用
%(%H,""Average Temp", 4) //列ロングネームを使用
winName$="Book1"; %(%(winName$), 2, 4); //列インデックスを使用

//シート名列ショートネームを使用
%([Book1]Sheet1, B, 4) 
//シートラベルと列ロングネームを使用
%([%H]"test result",""Average Temp", 4) 
//シートおよび列インデックスを使用
winName$="Book1"; %([%(winName$)]3, 2, 4); 

//列ショートネームを使用、WYSIWYG
%(Book1, B, 4, W) 
//列ロングネームを使用、小数点以下2桁
%(%H,""Average Temp", 4, .2) 
//列インデックスを使用、有効数字3桁
winName$="Book1"; %(%(winName$), 2, 4, *3); 

//シート名と列ショートネームを使用、WYSIWYG
%([Book1]Sheet1, B, 4, W) 
//シートラベルと列ロングネームを使用、小数点以下2桁
%([%H]"test result",""Average Temp", .2) 
//シートおよび列インデックスを使用、有効数字3桁
winName$="Book1"; %([%(winName$)]3, 2, *3); 

例えば、Book1のアクティブワークシートの4番目の列の3行目のセルに25という値が含まれている場合、スクリプトウィンドウに次のステートメントを入力すると、Aを25にセットし、その値を2倍して同じワークブックの"Results"シートの1列目4行に入力します。

value = %(Book1, 4, 3);
%([Book1]Results, 1, 4) = 2 * value;
%([Book1]Results, 1, 4)=;

テキストセルの内容を得るには、文字列変数に代入します。

type %(Book1, 2, 5); //最後に$不要
string strVar$ = %(Book1, 2, 5); //最後に$不要
strVar$ = ;

参照しているワークブック/ワークシートの名前がワークシートのセルに保存されている場合、たとえば、参照ワークブック名​​が現在のワークシートの列Aの最初のセルにある場合、次のセル式を使用できます。

=[Book%(col(A)[i]$)]1!A1

参照ブックの1枚目シートのA1セルにB1セルの値を設定します。

ただし、%() 置換表記で「A1」を使用する場合は、文字列連結で二重等号構文を使用します。

=="[Book" + A1$ + "]1!A1"

自動入力と数式の更新はそのような表記法でも機能します。

Book1のsheet1の列B行3に 12.3456789という数値があるものとし、小数点以下2桁で表示されているとします（この設定は列プロパティダイアログで行います）。

//現在の列フォーマットで値を返す
type "Displayed value: %([Book1]Sheet1,B,3,W)";
//完全精度の値を返す
type "Full precision: %([Book1]Sheet1,B,3)";
//カスタムOriginフォーマットで返す
type "3 decimal places: %([Book1]Sheet1,B,3, .3)";
//または@WLオプションを指定して別の式を使用して表示フォーマットを維持
type "Displayed value with @WL syntax:  %([Book1]Sheet1, @WL, B[3],W)";

Origin 9.1でのフォーマット文字W は、以前のバージョンのC （つまり、%([workbookName]sheetName, column, row,C)）の代わりです。フォーマットパラメータ"C" はサポートされません。

ワークブック情報の置換

上述のワークシート列およびワークシートセルの置換表記と同様、ワークシート情報の置換には2つの構文があります。1つはブック内の古い形式の1シートのみのワークブックまたはアクティブシート用で、もう1つはブック内のシートを指定して使用します。

列ラベル行情報

%(workbookName, @option, columnNumber]) または %([workbookName]worksheetName, @option, columnNumber)

この表記により、列ラベル行情報にアクセスできます。

テキストラベルの@オプションから列ラベル行関連optionsが使用されます。

サンプル
次のスクリプトは、現在選択されている範囲の最初の列の列名を返します。(selc1数値システム変数に関する情報に関しては、システム変数 を参照してください。)

%N = %(%H, @C, selc1);  %N =;

以下のスクリプトは、Book 2、Sheet 3の4番目の列の列タイプを返します。

type %([Book2]Sheet3, @T, 4);

ワークシート情報

%(workbookName, @option [,argument]) or %([workbookName]worksheetName, @option[, argument])
この表記により、ワークシート情報とメタデータにアクセスできます。

利用可能なオプションは以下にリストされています。 テキストラベルの@オプションも含まれます。

サンプル
以下のスクリプトはワークシートの表示名を返します。

type %(%H, @SN);

Book2、Sheet3の一部の列をYErrorバーとして設定します。いくつかのYErrorバー列を含む、列を選択します。 以下のスクリプトで、選択範囲内のYError列の数を返します。

type %([Book2]Sheet3, @E#, 2);

現在のアクティブワークシートが6つの列(XYXYXY)を持っているとします。もし、列2,4,5が選択されているとすると、以下のスクリプトは、最初に選択されたY列の番号を ii 番目の列 (3番目の引数) の右側に表示します。

loop(ii,1,wks.ncols)
{
    type -l %(%H, @YS, ii),;
}

これにより以下が出力されます。

   2,2,4,4,0,0,

ワークブック情報

%(workbookName, @option) %([workbookName], @option)
この表記により、ワークブック情報とメタデータにアクセスできます。

[%H]Sheet1!Aのように最初の引数に [workbookName]Sheet!Column を指定しても問題ありません。シートと列の部分は無視されます。

利用可能なオプションは以下にリストされています。 テキストラベルの@オプションも含まれます。

サンプル
以下のスクリプトはワークブックのショートネームを返します。

type %(%H, @PS);

情報の保存とインポートしたファイルの情報

%([workbookName]Sheet!Column, @Woption, varOrNodeName,[format]) ここで

• Sheet はシートショートネーム、ロングネーム、インデックスのいずれかです。
• Column は列ショートネーム、ロングネーム、インデックスのいずれかです。
• フォーマットはオプションでOriginのフォーマットを参照してください。

Originワークブック、ワークシート、列内に保存されているメタデータや、インポートされたファイルについて保存されている情報にアクセスします。

@Woptionsの説明

この構文が機能しているか確認する方法の1つとして、ファイルをワークブックにインポート後、テキストツールを使用して、ワークシート列の右側の灰色のスペースでテキストラベルを開始することです。右クリックして情報変数の挿入を選択します。情報タブをクリックして、SYSTEM.IMPORTノードを開き、変数を選択して挿入をクリックします。ここでは、使用中の「@W」オプションと、varOrNodeNameに格納されている情報を確認できます。変数を挿入ダイアログを閉じてラベルの外側でクリックすると、表記は解決され、ワー​​クブックのメタデータを表示するテキストラベルが作成されます。

サンプル 次の例は、インポートファイル情報、インポート中に抽出された変数、ページ (ブック)、シート、列レベルに保存されているユーザツリーにアクセスする方法を示しています。

データ：ファイルからインポート：インポートウィザード...を使用します。 \Samples\Import and Export\にある3つのS*.dat ファイルを選択し、インポートモードをシートを新たに作って読み込むに設定し、Book1に3つのファイルをインポートします。これらのファイルは、いくつかのユーザ変数が抽出された状態でワークブックにインポートされます。ワークブックオーガナイザ開きます。

• page.info node: 最後にインポートされたファイル関連の情報と変数のみが含まれます。 @W
• ページ (ブック) レベルでユーザーツリーとノードを追加します。@Wによるアクセス
• インポートされたファイル: インポートされたファイルレベルの変数を追加します。@WFnによるアクセス
• データシート: シートレベルのユーザツリーとノードを追加します。@WSによるアクセス

ファイルと最後にインポートされたファイルの抽出された編集情報にアクセスします。

//最後にインポートされたファイル名を返す
type %(%H,@W,system.import.filename$);
//mm/dd/yyyyフォーマットを使って最後にインポートされたファイル日付を返す
type %(Book1, @W,system.import.filedate, D0);
//最後にインポートされたファイルで抽出された BatchNo変数を返す
type %(Book1, @W,user.variables.batchno);
//最後にインポートされたファイルで抽出されたSample変数を返す
type %(Book1, @W,user.variables.sampleID$);

ワークブックオーガナイザで、左側のユーザツリーを右クリックしツリーの追加を選択してツリー名Cateを追加します。左側でユーザツリー -> Cate を選択します。2 つのノードを追加します。Depthという名前の数値ノードと「Direction」という名前のテキストノードです。そうしないと、ワークブック オーガナイザに名前の代わりにラベルが表示され、混乱することがあります。 Depth値を127.2 に設定し、Direction値をEastに設定します。

//ユーザツリー -> Cateの下のDepth と Direction 情報を返す
type %(%H,@W,tree.cate.depth, .0); //小数点以下桁数なしに
type %(%H,@W,tree.cate.direction$); // 文字列は末尾に$を使用

ワークブックオーガナイザで、インポートされたファイル -> S21-235-07.dat（二番目のノード）を開き、ファイルのツリーとノードを確認します。

//2 番目にインポートされたファイルのファイル情報と抽出された変数を返す
//変数またはノード名の末尾に$を追加しない
type %(%H,@WF2,info.filename); //2番目にインポートされたファイル名を取得
type %(%H,@WF2,header); //文字列変数に$を追加しない
type %(%H,@WF2,Variables.header.noofpoints); //ポイント情報の抽出された変数番号を取得
type %(%H,@WF2,Variables.FileName.SampleID$); //抽出された変数SampleIDを取得

ワークブック オーガナイザで、データシート -> Trial Run2（2番目のシート）に移動します。 ユーザツリーノードを右クリックし、 Conditionという名前のツリーを追加します。Tempという名前で値98.6の数値ノードを追加します。値がFailedのResultという名前のテキストノードを追加します。

//ユーザツリー -> Cateの下のDepth および Directionの情報を返す
type %("Trial Run 2"!,@WS,tree.condition.temp); //現ブックの場合ブック情報をスキップ
type %([%H]2!,@WS,tree.condition.result$); //シートインデックスを使用、文字列末尾に$を追加

列レベルでユーザツリーを作成し、@WCでアクセス

Trial Run 1ワークシートがアクティブな状態で列Dをダブルクリックして列プロパティダイアログを開きます。 ユーザツリータブを開きます。右クリックしてMachineという名前のツリーを追加します。 Speedという名前で値42.65の数値ノードを追加します。値がMD4のTypeという名前のテキストノードを追加します。

//列ユーザツリーのType情報を返す
type %([%H]"Trial Run 1"!"Position",@WC,tree.Machine.type$); //シートおよび列のロングネームを使用
//Positionが引用符で囲まれていない場合は、最初に列のショートネームを検索し、見つからない場合はロングネームを使用を検索
type %([%H]1!Position,@WC,tree.Machine.type$);
//列ユーザツリーのSpeed情報を返す
//シートおよび列インデックスを使用、現ブックの場合ブック情報をスキップ
type %(1!4,@WC,tree.Machine.speed) 
//シートインデックスと列ショートネームを使用、小数点以下の桁数を0に設定
type %(1!D,@WC,tree.Machine.speed, .0)

凡例と軸タイトルの置換

%(PlotSpecifier[, @option, argument1, argument2, ...])
最初の引数は、他の%( ) 表記法 (ワークシート置換表記法など) と区別するために数値または?で始まる必要があります。通常、最初の引数はワークブックとワークシートの指定子です。

テキストラベルの"@"オプションからすべてのプロット関連のオプションを使用できます。例えば、

サンプル

// 1番目のプロット (デフォルトでは2DのY データ) の最初のユーザーパラメータ情報を表示
legend.text$ = \l(1) %(1, @LD1); //LHSが$で終わる場合右側の引用符をスキップしても問題ありません
//最初のプロットのYデータセットのロングネームとXデータセットのロングネームを表示
legend.text$ = "\l(1) %(1Y, @LA) vs %(1X, @LA)";
//3つのプロットが異なるシートからのものであると仮定
//各プロットのワークシート名を表示
legend.text$="\l(1) %(1,@WS)
\l(2) %(2,@WS)
\l(3) %(3,@WS)"

すべての凡例を legend.text$ に含める必要があるため、上の最後のスクリプトには欠点があります。legendupdate Xファンクション は、スクリプトから凡例を変更または再描画する簡単な方法を提供しています。例えば、 legendupdate mode:=custom custom:=@WS

%(?Y) は軸タイトルを、インデックス（1,2,...n）ではなく、事前に指定されたデータプロットインデックス（作図の詳細：凡例/タイトル：自動軸タイトルのデータプロットインデックスで設定）にデフォルトで設定する可変構文です。 Yデータのロングネームとそれに続く単位を左Y軸のタイトルとして<>内に表示するには、次のようにします。

yl.text$ = %(?Y,@(@LL<@LU>));

グラフ凡例と軸タイトルはテキストラベルで指定されます。これらについての詳細な情報は、LabTalkのリファレンスページを参照してください。

• テキストラベルの置換
• 凡例の置換表記

キーワード置換

%( ) 置換表記は、タブや改行などの非印刷文字 (制御文字とも呼ばれる) を文字列に挿入するためにも使用されます。 これらの印刷されない文字にアクセスするには、LabTalk キーワードを使用します。 例えば、

// 改行、ラインフィード(CRLF)を文字列に挿入
string ss$ = "Hello%(CRLF)Goodbye";
ss$=;     // ANS: 'Hello', 'Goodbye' が別の行に出力
// 直接入力可能
type ss$;
// リテラルと混合する場合は%()置換を使用
ty I say %(ss$)%(CRLF)to you;

凡例をTABで区切って水平方向に表示します。

legend.text$="\l(1) %(1)%(TAB)\l(2) %(2)%(TAB)\l(3) %(3)";