scbd_get_names

SCBD_GET_NAMES(3)

SCOREBOARD LIBRARY (C)

SCBD_GET_NAMES(3)

名前

scbd_get_names - scoreboard データベースから、指定された属性と値を持つレコード名のリストを取得

形式

#include <scboard.h>

int scbd_get_names( char *attr, char *value, char *list[], int *size );

機能説明

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

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

戻り値

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

エラー

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

環境変数

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

関連項目

scoreboard(8), scorehosts.db(5)