C / C++ / 系统课时
整理项目结构并检查边界情况
整理项目结构并检查边界情况
当学生管理程序已经能运行,下一步不是继续把功能堆进 main.c,而是把数据模型、业务操作和入口拆开,并用明确的边界检查阻止非法输入、数组越界、空指针和文件打开失败扩散到程序内部。
学习目标
- 按职责拆分头文件、实现文件和程序入口,保持依赖方向清晰。
- 在函数入口检查非法参数、容量上限、重复编号和成绩范围。
- 通过编译警告和可重复的测试用例验证边界处理是否生效。
用文件职责代替超长 main.c
一个小型 C 项目不需要过度分层,但至少可以把公共类型与函数声明放进 student.h,把记录操作和保存逻辑放进 student.c,让 main.c 只负责调用与测试。这样修改存储实现时,不必同时改动所有调用代码。

| 文件 | 主要职责 |
|---|---|
student.h |
定义 Student、StudentStore、错误码和公开函数 |
student.c |
实现新增、查找、保存以及所有业务边界检查 |
main.c |
组织调用、处理用户输入或执行测试,不直接操作内部数组细节 |
建立有防护的公开接口
下面三个文件组成一个可直接编译的小项目。每个函数先检查参数,再访问数组或文件;这样即使调用方传入空指针或错误数据,也不会直接触发未定义行为。
片段示例:student.h 是整个项目的公共契约,需要与后面的 student.c、main.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,负责业务边界与文件访问。
#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 是一个边界测试入口,依赖前两个文件共同编译。这里故意提交正常、重复、非法和超容量数据,以确认保护逻辑真的执行。
#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 文件一起编译,再运行测试入口。
gcc -std=c11 -Wall -Wextra -Wpedantic main.c student.c -o student_check
./student_check预期输出:
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 应包含三条合法记录:
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 暴露的接口访问数据,同时每个接口都守住自己的参数和资源边界时,后续增加查询、修改、删除功能也更容易保持一致的错误处理方式。