| SCBD_GET_NAMES(3) | SCBD_GET_NAMES(3) |
#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を返し、あるいは以下のエラーを
返します:
attr または value が null ポインタです。
attr または value が null 文字列です。
scoreboard(8)
データベースプロセスのホスト名(およびポート番号)
scoreboard(8),
scorehosts.db(5)