| SCBD_GET_VALUES(3) | SCBD_GET_VALUES(3) |
#include <scboard.h>
int scbd_get_values( char *name, char *attr, char *list[], int *size );
scbd_get_values() は名前 name と属性
attr を持つレコードの値のリストを取得しようと試みます。
値のリストは list 引数で指定された場所に保存されます。
そして list は size 引数で指定されたサイズの
文字配列へのポインタでなければなりません。
この関数の呼び出しから成功して戻った場合、size には見つかった
値の数がセットされます。
list 内にセットされた文字列全ての記憶領域は malloc
関数を用いてアロケートされます。
そしてそれらのメモリ領域を解放するのはユーザの責任です。
scbd_get_values() は成功した場合は0を返し、あるいは以下のエラーを
返します:
attr または value が null ポインタです。
attr または value が null 文字列です。
scoreboard(8)
データベースプロセスのホスト名(およびポート番号)
scoreboard(8),
scorehosts.db(5)