mirror of
https://github.com/fumiama/fumidb.git
synced 2026-06-06 01:00:32 +08:00
98 lines
3.4 KiB
C
98 lines
3.4 KiB
C
#ifndef _TABLE_H_
|
||
#define _TABLE_H_
|
||
|
||
#include <stdint.h>
|
||
#include "types.h"
|
||
|
||
// 创建表，可变参数 list 为本表的一行的 types，详见 types.h
|
||
// list 以 type_t 为单元，遇到 uint64_t ptr 时偏移 +8
|
||
// 如果 types 为外键，需要紧跟一个 uint64_t ptr
|
||
// 指示外键链接到的表位置
|
||
// len(buf) >= 4096+8+2=4106
|
||
// 返回：
|
||
// NULL 失败，详见 errno
|
||
// table 指向表头的指针
|
||
void* create_table(int fd, char* buf, const char* name, int row_len, const void* list);
|
||
|
||
// 加载 ptr 位置的表
|
||
// len(buf) >= 4096+8+2=4106
|
||
// 返回：
|
||
// 0 失败，详见 errno
|
||
// ptr 指向表头的指针
|
||
void* load_table(int fd, char* buf, uint64_t ptr);
|
||
|
||
// 获得表名长度，包含结尾0
|
||
uint16_t get_table_name_length(void* table);
|
||
|
||
// 获得表名，写入buf，len(buf) >= len(name)
|
||
// 返回：buf
|
||
char* get_table_name(void* table, char* buf);
|
||
|
||
// 获得第 pos 项的索引 ptr
|
||
uint64_t get_index_ptr(void* table, uint16_t pos);
|
||
|
||
// 为 pos 位置的列创建索引。不可用于 0 列，即 pk 列，因为 pk 必有索引
|
||
// 返回：
|
||
// NULL 失败，详见 errno
|
||
// ptr 指向索引头的指针
|
||
uint64_t add_table_index(int fd, void* table, uint16_t pos);
|
||
|
||
// 删除 pos 位置的列的索引。不可用于 0 列，即 pk 列，因为 pk 必有索引
|
||
// 返回：
|
||
// 非 0 失败，详见 errno
|
||
// 0 成功
|
||
int remove_table_index(int fd, void* table, uint16_t pos);
|
||
|
||
// 获取 ptr 位置的行的长度
|
||
int get_row_length(int fd, void* table, uint64_t ptr);
|
||
|
||
// 插入一行，如果 pk 有值则替换
|
||
// list 以 key_t 为单元
|
||
// 如果当前项有 nullable 属性，需要在此项之前
|
||
// 加一个 key_t isavailable，标记本项是否有值
|
||
// 如果 isavailable==0，后面不再跟有本项数据
|
||
// 如果 isavailable!=0，则在后面附加数据
|
||
// 如果 val 不为 string/binary，直接装填其值
|
||
// 否则，值是指向 string/binary 的指针 (const char*)
|
||
// 且需要在指针之前提供一个 key_t 参数指示其大小
|
||
// 返回：
|
||
// 0 失败，详见 errno
|
||
// ptr 本行插入的位置
|
||
uint64_t insert_row(int fd, void* table, const key_t* list);
|
||
|
||
// 根据主键的匹配值查找行
|
||
// 如果主键不为 string，k 直接装填其值
|
||
// 否则，k 是指向 string 的指针 (const char*)
|
||
// 返回：
|
||
// 0 失败，详见 errno
|
||
// ptr 行所在位置
|
||
uint64_t find_row_by_pk(int fd, void* table, key_t k);
|
||
|
||
// 根据任意匹配值遍历查找行
|
||
// 可变参数两两成对，uint16_t pos + key_t val
|
||
// 如果 val 不为 string，直接装填其值
|
||
// 否则，值是指向 string 的指针 (const char*)
|
||
// f 为遍历函数，入参为本行 ptr，返回非 0 值中断遍历
|
||
// 返回：
|
||
// 非 0 失败，详见 errno
|
||
// 0 成功
|
||
int find_row_by(int fd, void* table, int (*f)(uint64_t), int row_len, const void* list);
|
||
|
||
// 根据主键的匹配值删除行
|
||
// 如果主键不为 string，k 直接装填其值
|
||
// 否则，k 是指向 string 的指针 (const char*)
|
||
// 返回：
|
||
// 非 0 失败，详见 errno
|
||
// 0 成功
|
||
int remove_row_by_pk(int fd, void* table, key_t k);
|
||
|
||
// 根据任意匹配值删除行
|
||
// 可变参数两两成对，uint16_t pos + key_t val
|
||
// 如果 val 不为 string，直接装填其值
|
||
// 否则，值是指向 string 的指针 (const char*)
|
||
// 返回：
|
||
// 非 0 失败，详见 errno
|
||
// 0 成功
|
||
int remove_row_by(int fd, void* table, int row_len, const void* list);
|
||
|
||
#endif |