第24章 多文件编译和模块边界

db_init(&db);
db_insert(&db, student);
db_find(&db, id, &out);
db_delete(&db, id);
db_free(&db);

// student_db.h
#ifndef STUDENT_DB_H
#define STUDENT_DB_H

#define MAX_NAME 32
#define MAX_ROWS 100

struct Student {
    int id;
    char name[MAX_NAME];
    int score;
};

struct DB {
    struct Student rows[MAX_ROWS];
    int count;
};

void db_init(struct DB *db);
int db_insert(struct DB *db, struct Student s);
int db_find(struct DB *db, int id, struct Student *out);
int db_delete(struct DB *db, int id);
void db_free(struct DB *db);
void db_list(const struct DB *db);

#endif

// student_db.c
#include "student_db.h"
#include <stdio.h>

void db_init(struct DB *db)
{
    // 把记录数清零，相当于清空数据库
    db->count = 0;
}

int db_insert(struct DB *db, struct Student s)
{
    // 检查容量，满了就返回 0 表示失败
    if (db->count >= MAX_ROWS) {
        return 0;
    }

    // 把学生写入数组末尾，记录数加一
    db->rows[db->count] = s;
    db->count++;
    return 1;
}

int db_find(struct DB *db, int id, struct Student *out)
{
    // 从头到尾扫描，按 id 匹配
    for (int i = 0; i < db->count; i++) {
        if (db->rows[i].id == id) {
            // 找到后拷贝到 out 指向的位置，返回 1
            *out = db->rows[i];
            return 1;
        }
    }
    return 0;
}

int db_delete(struct DB *db, int id)
{
    // 从头到尾扫描，找到要删除的记录
    for (int i = 0; i < db->count; i++) {
        if (db->rows[i].id == id) {
            // 用最后一条记录覆盖当前位置，记录数减一
            db->rows[i] = db->rows[db->count - 1];
            db->count--;
            return 1;
        }
    }
    return 0;
}

void db_free(struct DB *db)
{
    // 固定数组没有动态内存，直接重置计数
    db->count = 0;
}

void db_list(const struct DB *db)
{
    // 遍历每条记录，打印 id、姓名和分数
    for (int i = 0; i < db->count; i++) {
        printf("%d %s %d\n",
               db->rows[i].id,
               db->rows[i].name,
               db->rows[i].score);
    }
}

// main.c
#include "student_db.h"
#include <stdio.h>

int main(void)
{
    // 局部变量：数据库和查询结果
    struct DB db;
    struct Student out;

    // 初始化数据库（内部计数清零）
    db_init(&db);

    // 插入三条记录，使用复合字面量直接构造 Student
    db_insert(&db, (struct Student){1, "Alice", 86});
    db_insert(&db, (struct Student){2, "Bob", 91});
    db_insert(&db, (struct Student){3, "Carol", 78});

    // 打印全部记录，观察插入结果
    puts("All records:");
    db_list(&db);

    // 按 id=2 查找，找到就打印
    if (db_find(&db, 2, &out)) {
        printf("Found: %d %s %d\n", out.id, out.name, out.score);
    }

    // 删除 id=2 的记录，再次打印确认
    db_delete(&db, 2);
    puts("After deleting id=2:");
    db_list(&db);

    // 释放数据库（固定数组版本仅重置计数）
    db_free(&db);
    return 0;
}