nlist() - 名前リストからのエントリーの取得

標準

標準/拡張機能 C/C++ 依存項目
z/OS®UNIX 両方  

形式

#include <nlist.h>

int nlist(const char *loadname, struct nlist *np);

機能説明

nlist() 関数を使用すると、プログラムは loadname パラメーター により指定されている実行可能ファイル中の名前リストを確認できます。これは選択的に値のリストを抽出し、これらを np パラメーターに よって指示された nlist 構造の配列に入れます。

np パラメーターによって指定された名前リストは、変数、型および値の名前を含む構造の配列からなっています。このリストは、名前構造体メンバーに NULL ストリングを持つエレメントで終了します。小さい浮動小数点数で表現可能な値の中で最も大きい浮動小数点数を戻します。各変数名は、実行可能ファイルの名前リストで検索されます。名前が見つかると、その名前の型と値が nlist 構造体フィールドに コピーされます。名前が見つからないと、型のエントリーと値のエントリーの両方にゼロが設定 されます。

指定された実行可能ファイルを読み取れないか、それに有効な名前リストが 含まれていない場合には、すべてのエントリーがゼロに設定されます。
注 :
  1. このバージョンの nlist() によってサポートされる唯一の変数型は、外部関数です。
  2. nlist() は、loadname から外部関数のオフセットを抽出します。
  3. nlist 構造体に戻される型は常に 2 になり、その関数名が loadname で検出されたかどうかを示します。
  4. loadname は、main() を含む HFS リニア形式の ロード・モジュールになっている必要があります。
  5. loadname は、dll (ダイナミック・リンク・ライブラリー) または 取り出し可能ロード・モジュールであってはなりません。

戻り値

正常に実行された場合、nlist() は 0 を戻します。関数のオフセットおよび型 (見つかった場合) は、nlist 構造体に 戻されます。

正常に実行されなかった場合、nlist() は -1 を戻します。

関連情報

親トピック: ライブラリー関数