DBProヘルプ：一時項目挿入ステートメント

一時項目挿入ステートメント

現在のウィンドウに一時項目を作成し，計算式を設定します。

形式

	一時項目挿入	[ <カーソル名> , ]
		<項目名> , <データ型> , <計算式>
		, ナル値の扱い = 表属性 \| ナル \| ゼロ
		, 挿入位置 = <項目名>
		, 挿入方向 = 前 \| 後
		, 表示幅 = <算術式>
		, 単位 = 文字 \| mm \| inch \| pt
		, 配置 = 左寄せ \| 右寄せ \| 中央揃え \| 両端揃え \| 均等割付
		, 表示書式 = <書式> \| 標準

パラメータ

<カーソル名>

一時項目を挿入するウィンドウを指定します。省略するとカレントカーソルが指すウィンドウが対象になります。

<項目名>

挿入する一時項目の名前を指定します。すでに存在する項目の名前と同じ名前は指定できません。

<データ型>

一時項目のデータ型を指定します。次のいずれかが指定できます。

文字列　数値　整数　実数　日付　時刻　年月間隔　日時間隔　ファイル

<計算式>

一時項目に設定する計算式を文字列式で指定します。ここで指定する文字列式の値が，一時項目の値を計算する式の形にならなければなりません。

ナル値の扱い

一時項目の値が参照されたとき，ナルをゼロとして扱うか，未定義として扱うかを指定します。

表属性	表属性で指定してあるナル値の扱いに従います。（既定値）
ナル	ナルを未定義として扱います。
ゼロ	ナルをゼロまたは空文字列として扱います。

挿入位置

一時項目を挿入する基準となる項目を指定します。<カーソル名> で示されるウィンドウに存在する項目でなければなりません。

挿入方向

一時項目を挿入する方向を指定します。挿入位置が指定されているときはその項目に対して左側か右側かを，そうでないときは左端か右端かを示します。

前	指定項目の前，または左端に挿入します。
後	指定項目の後，または右端に挿入します。（既定値）

表示幅

一時項目の表示幅を指定します。既定値は40mmです。

単位

表示幅パラメータの単位を指定します。省略すると，mm とみなされます。

配置

一時項目のセル内での配置を指定します。省略すると，データ型ごとに決められている配置になります。

中央揃え	中央に配置します。
左寄せ	左端に配置します。
右寄せ	右端に配置します。
両端揃え	両端を揃えて配置します。
均等割付	両端の空きを他の文字間隔の1/2にして均等に配置します。

表示書式

一時項目の値を表示するときの書式を指定します。

<書式>	書式を文字列式で指定します。
標準	データ型ごとに決められた標準書式を用います。（既定値）

結果

<カーソル名>		変化しません。
カレントカーソル		<カーソル名> と同じ内容になります。
$$CMDSTATE	= 0	正常終了
	= 116	指定された項目はすでに存在します
	= 201	カーソルが正しくありません
	= 221	数値，時刻などのデータ表現が正しくない，または実行時指定で入力した式の形式が正しくありません

例

構造	コマンド	パラメータ
	一時項目挿入	@書籍, [文字数], 数値, `#文字数([抄録])`, ナル値の扱い=ゼロ

解説

<計算式> は，式を直接指定するのではないことに注意してください。たとえば，

一時項目挿入 @A,[金額],数値,'[単価]*[数量]'

のように式を文字列にして指定します。この文字列は，一般の文字列式で構わないので，次のようにすることもできます。

$exp := '[単価]*[数量]'

一時項目挿入 @A,[金額],数値,$exp

この文字列で指定できる式は，対話操作で指定できるものしか書けません。つまり，対話操作で指定する式にはカーソルは使用できないので，

$exp := '@A.[単価]*@A.[数量]'

などとはできません。
一時項目が文字列型のときに

一時項目挿入 @A,[宛て先],文字列,'[名前]+'様''

のように書くと，構文エラーとなってしまいます。これを正しい式にするには次のようにしなければなりません。

一時項目挿入 @A,[宛て先],文字列,'[名前]+!'様!''
複雑な式になればなるほど !' が多くなって非常に読みにくくなってしまいます。そこで，逆引用符（アクサングラーブ）` を使って次のように書くことができます。

一時項目挿入 @A,[宛て先],文字列,`[名前]+'様'`

このように `…` の形をした文字列定数は，一時項目挿入ステートメントに限らず文字列定数が使える場面ならどこででも使用することができます。この場合，` 自身を文字列に含めたいときは !` とします。また，! 自身を含めたいときも !! とします。
この計算式中に，DPL中で用いている変数を含めても，それは DPL での設定を引き継ぎません。この計算式は，対話操作の一時項目挿入における式とまったく同じ制約を受けます。たとえば，

$v := 100

一時項目挿入 @A,[金額],数値,'[単価]*$v'

としても式中の $v は 100 には評価されません。これを正しく 100 に評価させるためには次のようにします。

$v := 100

一時項目挿入 @A,[金額],数値,'[単価]*'+#STR($v)

文字列型のときは次のようにします。

$n := '山田太郎'

一時項目挿入 @A,[宛て先],文字列,`'`+$n+`'+' 様'`
計算式中で参照している項目の値が変更されると，一時項目の値にも反映されます。
一時項目にデータを直接入力することはできません。

$exp := '[単価]*[数量]'
一時項目挿入	@A,[金額],数値,$exp

$v := 100
一時項目挿入	@A,[金額],数値,'[単価]*'+#STR($v)

$n := '山田太郎'
一時項目挿入	@A,[宛て先],文字列,`'`+$n+`'+' 様'`

一時項目挿入ステートメント

形式

パラメータ

結果

例

解説

関連項目