C / C++ / 系统课时

整理项目结构并检查边界情况

整理项目结构并检查边界情况

当学生管理程序已经能运行,下一步不是继续把功能堆进 main.c,而是把数据模型、业务操作和入口拆开,并用明确的边界检查阻止非法输入、数组越界、空指针和文件打开失败扩散到程序内部。

学习目标

  • 按职责拆分头文件、实现文件和程序入口,保持依赖方向清晰。
  • 在函数入口检查非法参数、容量上限、重复编号和成绩范围。
  • 通过编译警告和可重复的测试用例验证边界处理是否生效。

用文件职责代替超长 main.c

一个小型 C 项目不需要过度分层,但至少可以把公共类型与函数声明放进 student.h,把记录操作和保存逻辑放进 student.c,让 main.c 只负责调用与测试。这样修改存储实现时,不必同时改动所有调用代码。

C 学生管理项目的文件依赖与边界检查位置

文件 主要职责
student.h 定义 Student、StudentStore、错误码和公开函数
student.c 实现新增、查找、保存以及所有业务边界检查
main.c 组织调用、处理用户输入或执行测试,不直接操作内部数组细节

建立有防护的公开接口

下面三个文件组成一个可直接编译的小项目。每个函数先检查参数,再访问数组或文件;这样即使调用方传入空指针或错误数据,也不会直接触发未定义行为。

片段示例:student.h 是整个项目的公共契约,需要与后面的 student.c、main.c 放在同一目录。

c
#ifndef STUDENT_H
#define STUDENT_H

#include <stddef.h>

#define MAX_STUDENTS 3
#define NAME_LEN 64

typedef struct {
    int id;
    char name[NAME_LEN];
    double score;
} Student;

typedef struct {
    Student records[MAX_STUDENTS];
    size_t count;
} StudentStore;

typedef enum {
    STUDENT_OK = 0,
    STUDENT_ERR_NULL,
    STUDENT_ERR_INVALID,
    STUDENT_ERR_FULL,
    STUDENT_ERR_DUPLICATE,
    STUDENT_ERR_IO
} StudentResult;

void student_store_init(StudentStore *store);
StudentResult student_store_add(StudentStore *store, const Student *student);
const Student *student_store_find(const StudentStore *store, int id);
StudentResult student_store_save(const StudentStore *store, const char *path);
const char *student_result_text(StudentResult result);

#endif

片段示例:student.c 依赖 student.h,负责业务边界与文件访问。

c
#include "student.h"

#include <math.h>
#include <stdio.h>
#include <string.h>

void student_store_init(StudentStore *store) {
    if (store != NULL) {
        store->count = 0;
    }
}

const Student *student_store_find(const StudentStore *store, int id) {
    size_t i;

    if (store == NULL || id <= 0 || store->count > MAX_STUDENTS) {
        return NULL;
    }

    for (i = 0; i < store->count; ++i) {
        if (store->records[i].id == id) {
            return &store->records[i];
        }
    }
    return NULL;
}

StudentResult student_store_add(StudentStore *store, const Student *student) {
    if (store == NULL || student == NULL) {
        return STUDENT_ERR_NULL;
    }
    if (student->id <= 0 ||
        memchr(student->name, '\0', NAME_LEN) == NULL ||
        student->name[0] == '\0' ||
        memchr(student->name, '|', NAME_LEN) != NULL ||
        !isfinite(student->score) ||
        student->score < 0.0 || student->score > 100.0) {
        return STUDENT_ERR_INVALID;
    }
    if (store->count >= MAX_STUDENTS) {
        return STUDENT_ERR_FULL;
    }
    if (student_store_find(store, student->id) != NULL) {
        return STUDENT_ERR_DUPLICATE;
    }

    store->records[store->count++] = *student;
    return STUDENT_OK;
}

StudentResult student_store_save(const StudentStore *store, const char *path) {
    FILE *fp;
    size_t i;

    if (store == NULL || path == NULL) {
        return STUDENT_ERR_NULL;
    }
    if (store->count > MAX_STUDENTS || path[0] == '\0') {
        return STUDENT_ERR_INVALID;
    }

    fp = fopen(path, "w");
    if (fp == NULL) {
        return STUDENT_ERR_IO;
    }

    for (i = 0; i < store->count; ++i) {
        if (fprintf(fp, "%d|%s|%.1f\n",
                    store->records[i].id,
                    store->records[i].name,
                    store->records[i].score) < 0) {
            fclose(fp);
            return STUDENT_ERR_IO;
        }
    }

    if (fclose(fp) != 0) {
        return STUDENT_ERR_IO;
    }
    return STUDENT_OK;
}

const char *student_result_text(StudentResult result) {
    switch (result) {
        case STUDENT_OK:
            return "ok";
        case STUDENT_ERR_NULL:
            return "null argument";
        case STUDENT_ERR_INVALID:
            return "invalid data";
        case STUDENT_ERR_FULL:
            return "store full";
        case STUDENT_ERR_DUPLICATE:
            return "duplicate id";
        case STUDENT_ERR_IO:
            return "file io error";
        default:
            return "unknown error";
    }
}

片段示例:main.c 是一个边界测试入口,依赖前两个文件共同编译。这里故意提交正常、重复、非法和超容量数据,以确认保护逻辑真的执行。

c
#include "student.h"

#include <errno.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>

static int parse_int(const char *text, int *value) {
    char *end;
    long parsed;

    if (text == NULL || value == NULL || *text == '\0') {
        return 0;
    }

    errno = 0;
    parsed = strtol(text, &end, 10);
    if (errno != 0 || end == text || *end != '\0' ||
        parsed < INT_MIN || parsed > INT_MAX) {
        return 0;
    }

    *value = (int)parsed;
    return 1;
}

static void print_result(const char *label, StudentResult result) {
    printf("%s: %s\n", label, student_result_text(result));
}

int main(void) {
    StudentStore store;
    Student a = {1001, "Alice", 88.5};
    Student duplicate = {1001, "Bob", 90.0};
    Student bad_score = {1002, "Carol", 120.0};
    Student b = {1002, "Bob", 91.0};
    Student c = {1003, "Carol", 82.0};
    Student extra = {1004, "Dave", 77.0};
    int choice = 0;

    student_store_init(&store);

    printf("parse abc: %s\n", parse_int("abc", &choice) ? "ok" : "invalid");
    print_result("null student", student_store_add(&store, NULL));
    print_result("add Alice", student_store_add(&store, &a));
    print_result("duplicate id", student_store_add(&store, &duplicate));
    print_result("bad score", student_store_add(&store, &bad_score));
    print_result("add Bob", student_store_add(&store, &b));
    print_result("add Carol", student_store_add(&store, &c));
    print_result("over capacity", student_store_add(&store, &extra));
    print_result("save", student_store_save(&store, "students.txt"));

    return 0;
}

这三个代码块不是三个独立程序,而是同一个多文件项目的组成部分;只有一起编译后才形成可执行文件。

编译并跑边界测试

打开全部常用警告能够尽早发现函数声明不一致、类型转换和未使用变量等问题。下面命令把两个 .c 文件一起编译,再运行测试入口。

bash
gcc -std=c11 -Wall -Wextra -Wpedantic main.c student.c -o student_check
./student_check

预期输出:

text
parse abc: invalid
null student: null argument
add Alice: ok
duplicate id: duplicate id
bad score: invalid data
add Bob: ok
add Carol: ok
over capacity: store full
save: ok

成功保存后,students.txt 应包含三条合法记录:

text
1001|Alice|88.5
1002|Bob|91.0
1003|Carol|82.0

这里的文件内容是上一个命令运行后的验证结果,不需要单独执行。如果当前目录没有写权限,最后一行可能变为 save: file io error,这正是 fopen 或写入失败被正常捕获的表现。

把边界检查放在正确位置

非法输入应在入口层尽早转换和拒绝,例如把 abc 解析为整数失败后,不要把未初始化的编号传给业务函数。数组容量则必须由真正写数组的函数再次检查,因为只有它知道 count 与 MAX_STUDENTS 的关系。

空指针检查应放在每个公开函数解引用参数之前;文件操作则要逐步检查 fopen、fprintf 和 fclose 的返回值。不要只检查“文件是否打开成功”,因为磁盘写满、权限变化等问题也可能在写入或关闭时才暴露。

当项目结构让 main.c 只通过 student.h 暴露的接口访问数据,同时每个接口都守住自己的参数和资源边界时,后续增加查询、修改、删除功能也更容易保持一致的错误处理方式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

整理项目结构并检查边界情况

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通