VIEW

pc

オプションの後置条件式。Caché は、後置条件式が True (0 以外の数値に評価される) の場合にこのコマンドを実行します。Caché は、後置条件式が False (0 に評価される) の場合はコマンドを実行しません。詳細は、"Caché ObjectScript の使用法" の "コマンド後置条件式" を参照してください。

block

整数として指定されるブロック位置。block が正の整数の場合、VIEW はその番号ブロックを表示バッファに読み取ります。block が負の整数の場合、VIEW は現在の表示バッファのブロックをそのブロック・アドレスに書き込みます。block と offset:mode:length:newvalue 引数は、相互排他的です。

ブロックが既にメモリ・バッファ内にある場合は、バッファ内の現在のコンテンツがコピーされます。

ブロック位置 0 は有効な位置ではありません。VIEW 0 を指定しようとすると、<BLOCKNUMBER> エラーが返されます。

offset

バイト単位で表される、mode で指定されたメモリ領域内のベース・アドレスからのオフセット。

mode

修正されるデータを計算するために使用される、ベース・アドレスを含むメモリ領域。可能な値に関する説明は、"メモリ内のデータの修正" を参照してください。

length

修正されるデータの長さ。

バイト数を整数 1 ～ 4 または 1 ～ 8 で指定します。文字 C または P を使用して、現在のプラットフォームのアドレス・フィールド (ポインタ) のサイズを指定することもできます。

newvalue が文字列を定義している場合は、1 からカウントされる負の整数でバイト数を指定します。newvalue の長さがこの数を上回る場合、Caché は超えた分の文字を無視します。newvalue の長さがこの数を下回る場合、Caché は与えられた文字を保存し、残り部分のメモリ位置は変更されません。

逆順でバイト値を保管 (最低位バイトを最低アドレスに置く) するためには、文字 O を長さを示す数字に追加し、両方を二重引用符で囲みます。

newvalue

メモリの場所に格納される置き換え値

VIEW の使用には注意が必要

VIEW コマンドの使用には注意が必要です。これは通常、デバッグや Caché データベース、Caché システム情報の修復に使用されます。VIEW の使用法を誤ると、メモリや Caché データベースは、簡単に破壊されます。

VIEW の使用の制限

VIEW コマンドは、制限付きのシステム機能です。呼び出されるコードが CACHESYS データベース内にあるので、コマンドは保護されます。詳細は、"Caché セキュリティ管理ガイド" の "アセットおよびリソース" の章にある “特別な機能” を参照してください。

表示バッファ

データベース・バッファの読み取り、および書き込みに使用された場合、VIEW コマンドは、表示バッファ (デバイス 63) で使用されます。表示バッファは、特殊なメモリ領域です。 VIEW 操作を実行する前に、開いておく必要があります。

表示バッファを (OPEN コマンドを使用して) 開くときは、その表示バッファに関連付けられる Caché データベース (CACHE.DAT) を指定します。VIEW コマンドを使用して、次に Caché データベースから個々のブロックを表示バッファに読み取ることができます。

ブロックを表示バッファに読み取った後、$VIEW 関数を使用してデータを調べることができます。または、VIEW コマンドを使用して、データを修正できます。データを修正した場合は、もう一度 VIEW コマンドを使用して、修正済みのブロックを Caché データベースに書き込むことができます。

メモリ内のデータの修正

Caché データベースからのデータの読み取りや書き込み以外に、VIEW コマンドは、表示バッファ内、または他のシステム・メモリ領域のメモリ内にあるデータを修正することができます。

データを修正するには、以下の形式を使用します。

VIEWoffset:mode:length:newvalue

4 つの引数すべてが必須です。

メモリ内の指定した場所に新しい値を格納することで、データを修正します。この場所は、mode で示されたベース・アドレスからのバイト・オフセットで指定されます。length 引数で、影響を受けるメモリの大きさを指定できます。

mode で利用可能な値は、以下のテーブルのとおりです。