C++循环迭代输出异常及TextMenuApp::run()未定义引用问题

问题概述 #

• 开发环境：Visual Studio Code，大型C++程序，仅当前.cpp文件存在问题，其余文件运行正常
• 两个核心问题：
  1. 文件加载循环的输出不符合预期
  2. 编译链接阶段出现错误：undefined reference to 'TextMenuApp::run()'

期望输出 #

Input the file name to load initial data from: not-exist.txt
File cannot be opened! Input again!
Input the file name to load initial data from: patients.txt
File loaded!

当前输出 #

Input the file name to load initial data from: non-exist.txt
File cannot be opened!
File cannot be opened! Input again!

过往输出 #

Input the file name to load initial data from: no-exist.txt
File cannot be opened!
File cannot be opened! Input again!
Input the file name to load initial data from: patients.txt
File loaded!
File loaded!

相关代码 #

#include "text-menu-app.hpp"
#include <iostream>
#include <string>
#include <limits>

using namespace std;

TextMenuApp::TextMenuApp() {}

void TextMenuApp::run() {
    bool fileLoaded = false;
    string filename;
    bool errorMessageDisplayed = false; // Flag to track whether the error message has been displayed

    do {
        if (!errorMessageDisplayed) {
            cout << "Input the file name to load initial data from: ";
        }
        cin >> filename;
        if (patients.load(filename)) {
            fileLoaded = true;
            if (!errorMessageDisplayed) {
                cout << "File loaded!" << endl;
            }
            errorMessageDisplayed = false; // Reset error flag
        } else {
            cout << "File cannot be opened! Input again!" << endl;
            errorMessageDisplayed = true;
        }
    } while (!fileLoaded);

    int choice;
    do {
        cout << "1. Print all patients" << endl;
        cout << "2. Update patient information" << endl;
        cout << "3. Save to file" << endl;
        cout << "4. Exit" << endl;
        cout << "Please choose an option (1-4): ";
        cin >> choice;

        switch (choice) {
            case 1:
                patients.print();
                break;
            case 2: {
                int index;
                string name, gender;
                int age;
                cout << "Enter the index of the patient to update: ";
                cin >> index;
                if (index >= 0 && index < patients.getCount()) {
                    cout << "Enter patient name: ";
                    cin.ignore(numeric_limits<streamsize>::max(), '\n');
                    getline(cin, name);
                    cout << "Enter patient age: ";
                    cin >> age;
                    cout << "Enter patient gender (Male/Female): ";
                    cin >> gender;
                    patients.updatePatient(index, name, age, gender);
                } else {
                    cout << "Invalid index!" << endl;
                }
                break;
            }
            case 3: {
                string filename;
                cout << "Input the file name to save the data to: ";
                cin >> filename;
                patients.save(filename);
                break;
            }
            case 4:
                cout << "Thank you for using the app!" << endl;
                break;
            default:
                cout << "Invalid option!" << endl;
        }
    } while (choice != 4);
}

解决方案 #

1. 文件加载循环输出异常修复 #

问题根源是errorMessageDisplayed标志的逻辑错误，导致错误信息重复输出、成功加载时重复打印提示。直接简化逻辑，去掉多余的标志判断，确保每次输入前都显示提示文本：

修改后的文件加载循环代码：

do {
    cout << "Input the file name to load initial data from: ";
    cin >> filename;
    if (patients.load(filename)) {
        cout << "File loaded!" << endl;
        fileLoaded = true;
    } else {
        cout << "File cannot be opened! Input again!" << endl;
    }
} while (!fileLoaded);

该逻辑完全匹配期望输出：输入失败时提示重新输入，下一次循环自动显示文件名输入提示；输入成功时直接打印加载成功信息并退出循环。

2. 未定义引用错误修复 #

undefined reference to 'TextMenuApp::run()'属于链接错误，按以下步骤排查：

• 确认text-menu-app.hpp中run()函数的声明与当前.cpp中的定义签名完全一致（返回值、参数列表必须完全匹配）
• 检查VSCode的编译配置文件（tasks.json），确保当前.cpp文件被包含在编译源文件列表中
• 若使用Makefile或CMake构建项目，需将该.cpp文件添加到编译目标的源文件集合中
• 清理项目的编译缓存后重新编译，避免旧的编译产物干扰

内容的提问来源于stack exchange，提问作者Amanda Taylor