C / C++ / 系统课时

编写命令行学生管理程序

编写命令行学生管理程序

这一节把结构体、数组、函数和文件读写组合成一个可运行的命令行程序。最终程序可以新增、查询、修改、删除学生记录,并把数据保存到文本文件;重新启动后仍能恢复已有记录。

学习目标

  • 用 struct 和定长数组组织学生记录,并控制容量与唯一编号。
  • 完成新增、查询、修改、删除和文件保存的基本流程。
  • 编译运行程序,并验证退出后数据能够再次加载。

先确定数据模型和菜单流程

为了把重点放在 C 语言基本能力上,程序使用最多 100 条记录的定长数组。每个学生包含编号、姓名和成绩,编号必须唯一,成绩限制在 0~100。文件采用一行一条的文本格式 编号|姓名|成绩,方便直接检查。

菜单循环负责接收用户选择,具体业务交给独立函数;新增、修改和删除只改变内存中的数组,保存时再统一写入文件,退出前也会自动保存。

学生管理程序的菜单、内存记录与文件持久化流程

完成可运行程序

下面的程序使用 fgets 读取整行,再通过 strtol、strtod 转换数字,避免直接使用 scanf 时残留换行符造成菜单错乱。姓名中禁止出现 |,因为它被用作文件字段分隔符。

c
#include <errno.h>
#include <limits.h>
#include <math.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#define MAX_STUDENTS 100
#define NAME_LEN 64
#define DATA_FILE "students.txt"

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

static Student students[MAX_STUDENTS];
static size_t student_count = 0;

static int read_line(const char *prompt, char *buf, size_t size) {
    int ch;

    printf("%s", prompt);
    fflush(stdout);
    if (fgets(buf, (int)size, stdin) == NULL) {
        return 0;
    }

    if (strchr(buf, '\n') == NULL) {
        while ((ch = getchar()) != '\n' && ch != EOF) {
        }
        return -1;
    }

    buf[strcspn(buf, "\n")] = '\0';
    return 1;
}

static int read_int(const char *prompt, int *value) {
    char buf[64];
    char *end;
    long parsed;

    if (read_line(prompt, buf, sizeof(buf)) != 1) {
        return 0;
    }

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

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

static int read_double(const char *prompt, double *value) {
    char buf[64];
    char *end;
    double parsed;

    if (read_line(prompt, buf, sizeof(buf)) != 1) {
        return 0;
    }

    errno = 0;
    parsed = strtod(buf, &end);
    if (errno != 0 || end == buf || *end != '\0' || !isfinite(parsed)) {
        return 0;
    }

    *value = parsed;
    return 1;
}

static int find_index_by_id(int id) {
    size_t i;

    for (i = 0; i < student_count; ++i) {
        if (students[i].id == id) {
            return (int)i;
        }
    }
    return -1;
}

static void add_student(void) {
    Student s;
    char name[NAME_LEN];

    if (student_count >= MAX_STUDENTS) {
        puts("记录已满,无法继续新增。");
        return;
    }

    if (!read_int("编号: ", &s.id) || s.id <= 0) {
        puts("编号必须是正整数。");
        return;
    }
    if (find_index_by_id(s.id) >= 0) {
        puts("该编号已经存在。");
        return;
    }

    if (read_line("姓名: ", name, sizeof(name)) != 1 ||
        name[0] == '\0' || strchr(name, '|') != NULL) {
        puts("姓名不能为空,也不能包含 |。");
        return;
    }
    snprintf(s.name, sizeof(s.name), "%s", name);

    if (!read_double("成绩: ", &s.score) || s.score < 0.0 || s.score > 100.0) {
        puts("成绩必须是 0 到 100 之间的数字。");
        return;
    }

    students[student_count++] = s;
    puts("新增成功。");
}

static void query_student(void) {
    int id;
    int index;

    if (!read_int("要查询的编号: ", &id)) {
        puts("编号格式错误。");
        return;
    }

    index = find_index_by_id(id);
    if (index < 0) {
        puts("未找到该学生。");
        return;
    }

    printf("编号=%d, 姓名=%s, 成绩=%.1f\n",
           students[index].id,
           students[index].name,
           students[index].score);
}

static void modify_student(void) {
    int id;
    int index;
    char name[NAME_LEN];
    double score;

    if (!read_int("要修改的编号: ", &id)) {
        puts("编号格式错误。");
        return;
    }

    index = find_index_by_id(id);
    if (index < 0) {
        puts("未找到该学生。");
        return;
    }

    if (read_line("新姓名: ", name, sizeof(name)) != 1 ||
        name[0] == '\0' || strchr(name, '|') != NULL) {
        puts("姓名不能为空,也不能包含 |。");
        return;
    }
    if (!read_double("新成绩: ", &score) || score < 0.0 || score > 100.0) {
        puts("成绩必须是 0 到 100 之间的数字。");
        return;
    }

    snprintf(students[index].name, sizeof(students[index].name), "%s", name);
    students[index].score = score;
    puts("修改成功。");
}

static void delete_student(void) {
    int id;
    int index;
    size_t i;

    if (!read_int("要删除的编号: ", &id)) {
        puts("编号格式错误。");
        return;
    }

    index = find_index_by_id(id);
    if (index < 0) {
        puts("未找到该学生。");
        return;
    }

    for (i = (size_t)index; i + 1 < student_count; ++i) {
        students[i] = students[i + 1];
    }
    --student_count;
    puts("删除成功。");
}

static int save_students(void) {
    FILE *fp;
    size_t i;

    fp = fopen(DATA_FILE, "w");
    if (fp == NULL) {
        perror("保存失败");
        return 0;
    }

    for (i = 0; i < student_count; ++i) {
        if (fprintf(fp, "%d|%s|%.1f\n",
                    students[i].id,
                    students[i].name,
                    students[i].score) < 0) {
            fclose(fp);
            puts("写入文件失败。");
            return 0;
        }
    }

    if (fclose(fp) != 0) {
        perror("关闭文件失败");
        return 0;
    }

    puts("保存成功。");
    return 1;
}

static void load_students(void) {
    FILE *fp;
    char line[256];

    fp = fopen(DATA_FILE, "r");
    if (fp == NULL) {
        puts("未找到数据文件,将从空数据开始。");
        return;
    }

    while (student_count < MAX_STUDENTS && fgets(line, sizeof(line), fp) != NULL) {
        Student s;

        if (sscanf(line, "%d|%63[^|]|%lf", &s.id, s.name, &s.score) == 3 &&
            s.id > 0 && isfinite(s.score) && s.score >= 0.0 && s.score <= 100.0 &&
            find_index_by_id(s.id) < 0) {
            students[student_count++] = s;
        }
    }

    fclose(fp);
}

static void print_menu(void) {
    puts("\n1. 新增");
    puts("2. 查询");
    puts("3. 修改");
    puts("4. 删除");
    puts("5. 保存");
    puts("0. 保存并退出");
}

int main(void) {
    int choice;

    load_students();

    for (;;) {
        print_menu();
        if (!read_int("请选择: ", &choice)) {
            if (feof(stdin)) {
                puts("\n输入结束,保存并退出。");
                save_students();
                return 0;
            }
            puts("请输入有效的整数选项。");
            continue;
        }

        switch (choice) {
            case 1:
                add_student();
                break;
            case 2:
                query_student();
                break;
            case 3:
                modify_student();
                break;
            case 4:
                delete_student();
                break;
            case 5:
                save_students();
                break;
            case 0:
                save_students();
                return 0;
            default:
                puts("没有这个菜单项。");
        }
    }
}

预期结果(首次运行,依次新增编号 1001、姓名 Alice、成绩 88.5,再查询并退出):

text
未找到数据文件,将从空数据开始。

1. 新增
2. 查询
3. 修改
4. 删除
5. 保存
0. 保存并退出
请选择: 1
编号: 1001
姓名: Alice
成绩: 88.5
新增成功。

1. 新增
2. 查询
3. 修改
4. 删除
5. 保存
0. 保存并退出
请选择: 2
要查询的编号: 1001
编号=1001, 姓名=Alice, 成绩=88.5

1. 新增
2. 查询
3. 修改
4. 删除
5. 保存
0. 保存并退出
请选择: 0
保存成功。

编译并验证持久化

使用支持 C11 的 GCC 编译。命令成功时不会额外输出编译信息,随后启动程序。

bash
gcc -std=c11 -Wall -Wextra -pedantic student_manager.c -o student_manager
./student_manager

预期输出(已经完成上面的保存后再次启动):

text
1. 新增
2. 查询
3. 修改
4. 删除
5. 保存
0. 保存并退出
请选择:

此时再次选择查询并输入 1001,应仍能看到 Alice 和 88.5,说明程序已从 students.txt 恢复数据。实际可执行文件名会随平台不同而变化,例如 Windows 通常生成 student_manager.exe。

验收关键行为

至少检查四件事:重复编号不能新增;成绩超出 0~100 会被拒绝;删除后再次查询应提示未找到;保存退出并重新运行后,未删除记录仍存在。这样才算同时验证了内存中的 CRUD 和文件持久化,而不是只验证菜单能打印出来。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写命令行学生管理程序

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

登录哪都通