Formula from string

履歴

リリース	内容
20 R3	context パラメーターをサポート
17 R6	名称変更 (New formula from string -> Formula from string)
17 R3	追加

Formula from string( formulaString : Text ) : 4D.Function
Formula from string( formulaString : Text ; context : Longint ) : 4D.Function

引数	型		説明
formulaString	テキスト	→	オブジェクトとして返されるフォーミュラ文字列
context	Number	→	sk execute in current database (デフォルト) または sk execute in host database
戻り値	4D.Function	←	フォーミュラを格納しているネイティブなオブジェクト

説明

Formula from string コマンドは、formulaString と任意の context 引数に基づいた 4D.Function オブジェクトを作成します。 formulaString には単一の値のようにシンプルなものから、引数を持つプロジェクトメソッドのように複雑なものまで指定することができます。

This command is similar to Formula, except that it handles a text-based formula and allows to define an execution context. 元となるフォーミュラがテキストとして表現されている場合 (例: 外部の JSON ファイルに保存されていた場合など)、または、コンポーネントから Formula from string を呼び出してホストデータベースにフォーミュラを作成したい場合を除いて、通常は Formula コマンドの使用が推奨されます。 なお、このコマンドでは、トークンを使ったシンタックスの使用が強く推奨されます。

ローカル変数の中身はコンパイル済みモードでは名前によるアクセスが不可能なため、formulaString 引数内で使用することはできません。 Formula from string コマンドを使用してローカル変数にアクセスを試みた場合、エラー(-10737) が生成されます。

フォーミュラがコンポーネント内で作成されている場合、 context 引数を使うことができます。 デフォルトでは、フォーミュラは作成されたコンテキストにおいて実行されるため、ホストデータベースの変数や関数、共有されていないメソッドを呼び出すことはできません。 この場合、sk execute in host database 定数を context パラメーターに渡すことで、ホストデータベースのコンテキストで 4D.Function オブジェクトを実行することができます。 以下の定数を使用することができます:

定数	型	説明
sk execute in current database	倍長整数	(デフォルト) フォーミュラは作成されたコンテキストにおいて実行されます。
sk execute in host database	倍長整数	フォーミュラは、ホストデータベースのコンテキストで実行されます。

例題

以下のコードは、テキストフォーマットのフォーミュラを受け入れるダイアログを作成し、:

 var $textFormula : Text
 var $f : 4D.Function
 $textFormula:=Request("Please type a formula")
 If(ok=1)
    $f:=Formula from string($textFormula)
    ALERT("Result = "+String($f.call()))
 End if

そのフォーミュラを実行します:

参照

Formula
Parse formula