Manpages

名 前

recno − レ コ ー ド 番 号 デ ー タ ベ ー ス へ の ア ク セ ス メ ソ ッ ド

書 式

#include <sys/types.h>
#include <db.h>

説 明

大 事 な 注 意 : こ の ペ ー ジ は 、 バ ー ジ ョ ン 2.1 ま で の glibc が 提 供 す る イ ン タ ー フ ェ ー ス に つ い て 説 明 し て い る 。 バ ー ジ ョ ン 2.2 以 降 の glibc で は 、 も は や こ れ ら の イ ン タ ー フ ェ ー ス は 提 供 さ れ て い な い 。 お そ ら く 、 こ の ペ ー ジ で は な く 、 libdb ラ イ ブ ラ リ が 提 供 す る API を お 探 し な の だ ろ う 。 ル ー チ ン dbopen(3) は デ ー タ ベ ー ス フ ァ イ ル に 対 す る ラ イ ブ ラ リ イ ン タ ー フ ェ ー ス で あ る 。 サ ポ ー ト さ れ て い る フ ァ イ ル フ ォ ー マ ッ ト の 一 つ に 、 レ コ ー ド 番 号 フ ァ イ ル (record number file: recno file) が あ る 。 デ ー タ ベ ー ス へ の ア ク セ ス メ ソ ッ ド に 関 す る 一 般 的 な 記 述 は dbopen(3), に 書 か れ て い る 。 こ の マ ニ ュ ア ル ペ ー ジ で は recno 特 有 の 情 報 に つ い て の み 記 述 す る 。 レ コ ー ド 番 号 デ ー タ 構 造 は 、 フ ラ ッ ト な フ ァ イ ル 形 式 に 格 納 さ れ た 可 変 長 /固 定 長 レ コ ー ド か ら な り 、 論 理 レ コ ー ド 番 号 で ア ク セ ス さ れ る 。 レ コ ー ド 番 号 5 が あ れ ば 、 レ コ ー ド 番 号 1 か ら 4 も 存 在 す る 。 レ コ ー ド 番 号 1 を 削 除 す る と 、 レ コ ー ド 番 号 5 は 4 に 付 け 替 え ら れ 、 カ ー ソ ル も 移 動 す る 。 レ コ ー ド 番 号 1 以 降 の も の は 一 つ 繰 り 上 が る わ け で あ る 。

dbopen(3) で 使 う recno ア ク セ ス メ ソ ッ ド に 特 有 の デ ー タ 構 造 体 は 、 <db.h> イ ン ク ル ー ド フ ァ イ ル で 次 の よ う に 定 義 さ れ て い る 。

typedef struct {
unsigned long flags;
unsigned int cachesize;
unsigned int psize;
int lorder;
size_t reclen;
unsigned char bval;
char *bfname; }
RECNOINFO; こ の 構 造 体 の 要 素 を 以 下 に 示 す 。

R_FIXEDLEN レ コ ー ド 長 が 固 定 で あ り 、 バ イ ト 区 切 り で は な い 。 構 造 体 の 要 素 reclen は レ コ ー ド の 長 さ を 指 定 す る 。 ま た 、 要 素 bval は 埋 め 文 字 (pad character) を 指 定 す る 。 デ ー タ ベ ー ス に 入 れ ら れ た レ コ ー ド の 内 reclen バ イ ト に 満 た な い も の で は 、 残 り の 部 分 に 埋 め 文 字 が 自 動 的 に 入 る 。
R_NOKEY

dbopen(3) で 指 定 さ れ た イ ン タ ー フ ェ イ ス で は 、 シ ー ケ ン シ ャ ル な レ コ ー ド 取 得 は 呼 び 出 し キ ー と デ ー タ 構 造 体 の 両 方 を 埋 め て い く 。 R_NOKEY フ ラ グ が 指 定 さ れ て い る と 、 キ ー 構 造 体 を 埋 め る の に cursor ル ー チ ン を 必 要 と し な い 。 こ れ を 用 い れ ば 、 ア プ リ ケ ー シ ョ ン が フ ァ イ ル の 終 り の 方 を 取 得 す る 際 に 、 そ の 途 中 の レ コ ー ド を 読 ま な く て も 済 む 事 に な る 。

R_SNAPSHOT こ の フ ラ グ を 指 定 す る と 、 dbopen(3) の 呼 び 出 し の 際 、 オ リ ジ ナ ル フ ァ イ ル か ら 変 更 さ れ て い な い レ コ ー ド を 読 む 代 わ り に 、 フ ァ イ ル の snapshot を 用 い る 。

cachesize 想 定 さ れ る メ モ リ ー キ ャ ッ シ ュ の 最 大 サ イ ズ (バ イ ト 単 位 )。 こ の 値 は あ く ま で 参 考 で あ り 、 ア ク セ ス メ ソ ッ ド は こ の 値 を 越 え た メ モ リ ー の 割 り 当 て に 成 功 す る こ と も あ る 。 cachesize が 0 (あ る い は 指 定 さ れ て い な い ) の 場 合 、 デ フ ォ ル ト の キ ャ ッ シ ュ が 使 わ れ る 。