バージョン: 19

変数

4D のデータは、根本的に異なっている 2つの方法で保持されます。 フィールド はディスクに永続的にデータを保存するのに対し、変数はメモリ上に一時的にデータを格納します。

データベースを作成する際には、フィールドに名前とデータタイプを指定します。同様に、変数にも名前とデータタイプを指定します。

いったん作成された変数は、アプリケーションで必要とされる場所に使用できます。たとえば、テキスト変数を同じタイプのフィールドに格納するには次のように書きます:

 [MyTable]MyField:=MyText

変数はランゲージの要素です。画面上に表示されることのない、裏方に徹した変数を作成・利用することができます。もちろん、フォーム上に変数の値を表示することもできます (ポインターやBLOBを除く)。また、変数に値を入力したり、変数の値をレポートに印刷したりすることも可能です。このとき、入力可や入力不可の変数オブジェクトはフィールドオブジェクトと同様に振舞い、提供されるコントロールも類似しています。フォーム上のボタン、リストボックス、スクロールエリア、ピクチャーボタンなどのオブジェクトも変数を使って制御することができるほか、保存不要な計算結果を表示させることもできます。

変数の宣言

変数の作成は通常、宣言によっておこないます。 4D ランゲージでは、変数の宣言方法は2つあります:

var キーワードを使った宣言 (推奨、とくにオブジェクトやクラスをコードで使用する場合)
"コンパイラー" や "配列" テーマの 4D ランゲージコマンドを使った宣言 (旧シンタックス)。

変数は宣言されると、その型に対応するデフォルト値 に初期化されます。別の値が代入されない限り、セッション中はこの値が保持されます。

注

この方法は推奨されませんが、ただ "使用する" ことによって変数を宣言することもできます。正式にそれらを宣言することは必須ではありません。たとえば、今日の日付に30日足した値を格納した変数を作成するには、次のように書くことができます:

 MyDate:=Current date+30 //  MyDateを作成します
 // これは日付型の変数であると 4D は推測します 
 // 30日後の日付が代入されます

宣言前に変数が作成された場合、宣言による初期化はおこなわれません。

`var` キーワードによる宣言

オブジェクト変数をクラスに紐づけることができるため、var キーワードを使った変数宣言が推奨されます。このシンタックスはコードエディターの自動補完機能を強化します。

var キーワードを使って変数を宣言するには、次のシンタックスを用います:

var <varName>{; <varName2>;...}{ : <varType>}

例:

var $myText : Text  // テキスト変数
var myDate1; myDate2 : Date  // 複数の日付変数
var $myFile : 4D.File  // File クラスオブジェクト変数
var $myVar // バリアント型変数

varName に指定する変数名は 4Dの識別子の命名規則に従う必要があります。
このシンタックスはローカル変数とプロセス変数の宣言のみサポートしています。インタープロセス変数および配列には使用できません。

varType には次が指定できます:

基本のデータ型: 変数には、宣言された型の値が格納されます
クラス参照 (4Dクラスまたはユーザークラス): 変数には、定義されたクラスのオブジェクトへの参照が格納されます

varType を省略すると、variant 型の変数が作成されます。

サポートされている varType 値の一覧です:

varType	内容
`Text`	テキスト値
`Date`	日付値
`Time`	時間値
`Boolean`	ブール値
`Integer`	倍長整数値
`Real`	実数値
`Pointer`	ポインター値
`Picture`	ピクチャー値
`BLOB`	BLOB値
`Collection`	コレクション値
`Variant`	バリアント値
`Object`	デフォルトクラス (`4D.Object`) のオブジェクト
`4D.<className>`	4Dクラス名のオブジェクト
`cs.<className>`	ユーザークラス名のオブジェクト

例題

基本のデータ型の、ローカル変数およびプロセス変数の宣言:

var $myText; myText; $vt : Text
var myVar //variant

var $o : Object    
// 次と同義です:
var $o : 4D.Object
// C_OBJECT($o) とも同義です

4Dクラス型のオブジェクト変数の宣言:

var $myFolder : 4D.Folder
var $myFile : 4D.File

ユーザークラス型のオブジェクト変数の宣言:

var $myClass : cs.MyClass
var $dataclass : cs.Employee
var $entity : cs.EmployeeEntity

C_ 指示子による宣言

互換性に関する注記: メソッド内で変数を宣言するにあたって、この方法は推奨されません。 var キーワードの使用が推奨されます。

"コンパイラー" テーマコマンドの指示子を使って、基本のデータ型の変数を宣言することができます。

たとえば、テキスト変数を宣言するには次のように書きます:

 C_TEXT(myText)

いくつかの基本的な変数宣言の例です:

 C_BLOB(vxMyBlob) // プロセス変数 vxMyBlob を BLOB型として宣言します
 C_DATE($vdCurDate) // ローカル変数 $vdCurDate を日付型として宣言します
 C_LONGINT(vg1;vg2;vg3) // 3つのプロセス変数 vg1, vg2, vg3 を倍長整数型として宣言します
 C_OBJECT($vObj) // ローカル変数 $vObj をオブジェクト型として宣言します
 C_COLLECTION($vCol) // ローカル変数 $vCol をコレクション型として宣言します

注: 配列とは変数の一種で、同じタイプの変数を番号付きで並べたものです。配列は、配列宣言コマンド (例: ARRAY LONGINT(alAnArray;10)) を使用して作成します。詳細については配列を参照ください。

変数への代入

変数を対象に、データを格納したり、格納したデータを別の対象にコピーしたりすることができます。変数にデータを格納することを、変数にデータを代入すると言い、代入演算子 (:=) を使っておこないます。代入演算子はフィールドに対してデータを代入する場合にも使います。

代入演算子は、変数を作成し、変数にデータを代入するために使用します。作成する変数名を代入演算子の左側に書きます。例:

MyNumber:=3

は変数 MyNumber を作成し、数値 3を代入します。 MyNumber が既に存在していれば、そこに数値 3が代入されます。

データ型の宣言をせずに変数を作成することは通常推奨されません。

もちろん、変数からデータを取り出すことができなければ、便利とはいえません。再度代入演算子を使用します。 [Products]Size というフィールドに MyNumber 変数の値を代入するには、代入演算子の右側に MyNumber を書きます:

[Products]Size:=MyNumber

これで、[Products]Size の値は3になります。この例はとても単純ですが、ある場所から別の場所へランゲージによってデータを転送させる基本的な手順を表しています。

配列要素にデータを代入するには中カッコ ({...}) を使用します:

atNames{1}:="Richard"

ローカル、プロセス、およびインタープロセス変数

ローカル、プロセス、および インタープロセス という、3種類の変数の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。

ローカル変数

ローカル変数はその名のとおりメソッド内でローカルであり、変数が作成されたメソッドの範囲内でのみ使用可能で、その他のメソッドからはアクセスできません。メソッド内でローカルであるというのは、正式には「スコープがローカルである」といいます。ローカル変数は、その使用範囲をメソッド内に限定するために用います。

ローカル変数は、以下のような目的のために使用されます:

他の変数名との重複を避ける。
データを一時的に使用する。
プロセス変数の数を減らす。

ローカル変数の名前は必ずドル記号 ($) で始め、この記号を除く31文字までの文字を指定できます。これより長い名前を指定すると、4D は余分の32文字以降を切り捨てます。

多くのメソッドや変数を持つアプリケーションプロジェクトで作業する場合、現在作業しているメソッドの範囲内で一時的に変数が必要となる場合がよくあります。この場合、同じ変数名が他で使用されていないかどうかを気にすることなくローカル変数を作成することができます。

アプリケーションではしばしば、ユーザーによる少量のデータ入力を必要とする場合があります。 Request コマンドを使って、この情報を取得することができます。このコマンドはデータ入力を求めるダイアログボックスを表示し、ユーザーがデータを入力すると、その情報を戻り値として返します。このようなデータは通常、メソッド内で長時間維持する必要はありません。これは、ローカル変数を使用する典型的な例といえます。次に例を示します:

 $vsID:=Request("ID を入力してください:")
 If(OK=1)
    QUERY([People];[People]ID =$vsID)
 End if

このメソッドは、ユーザーに ID を入力するように要求します。ローカル変数 $vsID にレスポンスが代入され、ユーザーが入力した ID に基づいた検索がおこなわれます。このメソッドが終了した時点で、$vsID ローカル変数はメモリから消去されます。この変数は 1回のみ、このメソッド内でしか使われないため、これ以上維持する必要はありません。

注: メソッドに渡される $1, $2...等の引数はローカル変数です。詳細についてはパラメーターを参照ください。

プロセス変数

プロセス変数は、同じプロセスの範囲内に限り使用可能です。この変数はプロセスメソッドと、そのプロセス内で呼び出された他のメソッドで使用することができます。

プロセス変数には名前に付ける接頭辞がありません。プロセス変数の名前は、最大31文字までの長さで指定できます。

インタープリターモードでは、変数は動的にメモリ上に作成・消去されます。これに対してコンパイルモードでは、作成したすべてのプロセス (ユーザープロセス) で同じプロセス変数定義が共有されますが、変数のインスタンスはプロセス毎に異なるものとなります。たとえば、プロセスP_1 とプロセスP_2 の両方においてプロセス変数 myVar が存在していても、それらはそれぞれ別のインスタンスです。

バージョン6より、GET PROCESS VARIABLE や SET PROCESS VARIABLE を使用して、あるプロセスから他のプロセスのプロセス変数の値を取得したり、設定したりできるようになりました。これらのコマンドの利用は、以下のような状況に限定することが、良いプログラミングの作法です:

コード内の特定の箇所におけるプロセス間通信
プロセス間のドラッグ＆ドロップ処理
クライアント/サーバーにおいて、クライアントマシン上のプロセスとサーバーマシン上のストアドプロシージャー間の通信

詳細については プロセス の章と、各コマンドの説明を参照ください。

インタープロセス変数

非推奨

プリエンプティブプロセスにおいては使用できないことと、コードの保守管理を煩雑にすることから、インタープロセス変数の使用は推奨されません。

インタープロセス変数はプロジェクト全体で使用することができ、すべてのコオペラティブプロセスで共有されます。これらは主としてプロセス間で情報を共有するために使われます。

インタープロセス変数の名前は、必ずインタープロセス記号 (<>) で始めます。記号の後に31バイトまでの名前を指定できます。

クライアント/サーバーでは、各マシン (クライアントマシンとサーバーマシン) で同じインタープロセス変数定義を共有しますが、マシンごとに各変数のインスタンスが存在します。

システム変数

4Dランゲージが管理する複数の システム変数 を使うことで、さまざまな動作の実行をコントロールできます。その他の変数と同様に、システム変数は値を確認したり使用したりすることができます。システム変数はすべてプロセス変数です。

システム変数は 4Dコマンドによって使用されます。コマンドがシステム変数に影響を与えるかどうかを確認するには、コマンドの説明の "システム変数およびセット" の項目を参照ください。

システム変数名	型	説明
`OK`	Integer	通常、コマンドがダイアログボックスを表示して、ユーザーが OK ボタンをクリックすると 1 に、キャンセルボタンをクリックした場合は 0 に設定されます。一部のコマンドは、処理が成功すると `OK` システム変数の値を変更します。
`Document`	Text	Open document や SELECT LOG FILE などのコマンドを使用して最後に開いたファイルまたは作成したファイルのパス名 (フルパス + 名前) が含まれます。
`FldDelimit`, `RecDelimit`	Text	テキストを読み込んだり書き出したりする際に、フィールドの区切りとして (デフォルトはタブ (9))、あるいはレコードの区切り文字として (デフォルトはキャリッジリターン (13)) 使用する文字コードが格納されています。区切り文字を変更する場合は、システム変数の値を変更します。
`Error`, `Error method`, `Error line`, `Error formula`	Text, Longint	`ON ERR CALL` コマンドでインストールされたエラー処理メソッド内で使用されます。メソッド内でのエラー処理参照。
`MouseDown`	Integer	`ON EVENT CALL` コマンドでインストールされたメソッド内で使用されます。マウスボタンが押されたときに 1 が、それ以外の場合は 0 に設定されます。
`MouseX`, `MouseY`	Integer	`ON EVENT CALL` コマンドでインストールされたメソッド内で使用されます。 `MouseDown=1` イベントの時、`MouseX` と `MouseY` にはクリックされた場所の水平 / 垂直座標がそれぞれ代入されます。両方の値ともピクセル単位で表わされ、ウィンドウのローカルな座標システムを使用します。ピクチャーフィールドや変数の場合は、`On Clicked` や `On Double Clicked`、および `On Mouse Up` フォームイベント内で、クリックのローカル座標が `MouseX` と `MouseY` に返されます。また、`On Mouse Enter` および `On Mouse Move` フォームイベントでもマウスカーソルのローカル座標が返されます。詳細については、ピクチャー上のマウス座標を参照ください。
`KeyCode`	Integer	`ON EVENT CALL` コマンドでインストールされたメソッド内で使用されます。押されたキーの文字コードが代入されます。押されたキーがファンクションキーの場合、`KeyCode` には特殊コードがセットされます。
`Modifiers`	Integer	`ON EVENT CALL` コマンドでインストールされたメソッド内で使用されます。キーボードのモディファイアキーの値を格納します (Ctrl/Command、Alt/Option、Shift、Caps Lock)。
`MouseProc`	Integer	`ON EVENT CALL` コマンドでインストールされたメソッド内で使用されます。最後のイベントが発生したプロセス番号を格納します。

注

これらのシステム変数と同じ名前の変数、メソッド、関数を作成することはできません。

変数の宣言​

var キーワードによる宣言​

例題​

C_ 指示子による宣言​

変数への代入​

ローカル、プロセス、およびインタープロセス変数​

ローカル変数​

プロセス変数​

インタープロセス変数​

システム変数​