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)