scbd_get_attributes

SCBD_GET_ATTRIBUTES(3)

SCOREBOARD LIBRARY (C)

SCBD_GET_ATTRIBUTES(3)

名前

scbd_get_attributes - scoreboard データベースから指定されたレコードの属性名のリストを取得

形式

#include <scboard.h>

int scbd_get_attributes( char *name, char *list[], int *size );

機能説明

scbd_get_attributes() は name 引数によって指定されたレコードの属性名のリストを取得しようと試みます。属性名のリストは list 引数に保存されます。そして list は size 引数によって指定されたサイズの文字へのポインタの配列でなければなりません。この関数の呼び出しが成功して戻ってきた場合、size には見つかった属性の数がセットされます。

list 内にセットされた文字列全ての記憶領域は malloc 関数を用いてアロケートされます。そしてそれらのメモリ領域を解放するのはユーザの責任です。

戻り値

scbd_get_attributes() は成功した場合は0を返し、あるいは以下のエラーを返します:

エラー

EFAULT: attr または value は null ポインタです。
EINVAL: attr または value は null 文字列です。

環境変数

SCBDSERV: scoreboard(8) データベースプロセスのホスト名(およびポート番号)

関連項目

scoreboard(8), scorehosts.db(5)