Understanding C++ Error Messages

Hello! Today's expedition is about understanding C++'s error messages. We'll examine how these error messages work, their structure, and the most common types that we're likely to encounter. Let's get started!

C++ handles errors using exceptions and error codes. Exceptions are a way to signal that an error has occurred, allowing the program to handle the error gracefully or terminate the program if necessary. Error codes, on the other hand, are returned by functions to indicate that something went wrong. We'll focus primarily on the error messages generated by the compiler and runtime exceptions in C++.

C++ error messages typically comprise the following components generated by compilers like g++:

1. Description: This string describes what went wrong.
2. Location: Indicates where the error occurred in the code, specifying the file name and line number.

To illustrate, let's consider this code error:

The code:

#include <iostream>
int main() {
    std::cout << "Hello, World!"
}

The error:

example.cpp: In function ‘int main()’:
example.cpp:3:32: error: expected ‘;’ before ‘}’ token
    3 |     std::cout << "Hello, World!"
      |                                ^
      |                                ;
    4 | }

Although the error message might initially seem intimidating, it clearly indicates that a semicolon is missing before the closing brace.

For this error:

• Description is expected ‘;’ before ‘}’ token
• Location is example.cpp:3:32

Every error message provides these details to help you understand and locate the issue.

Syntax errors occur when the code violates C++'s language rules, preventing the compiler from parsing and, thus, compiling the code. These errors are usually caught at compile time. Examples include:

• Missing Brackets: Forgetting to close a bracket or parenthesis can lead to a syntax error.

  #include <iostream>
  int main() {
      std::cout << "Hello, C++!";

  This raises:

  example.cpp: In function ‘int main()’:
  example.cpp:4:5: error: expected ‘}’ at end of input

• Misplaced Keywords: Using keywords in the wrong context can also cause syntax errors.

  int main() {
      int class = 5; // Incorrect use of "class" as a variable name
  }

  This would typically raise:

  example.cpp: In function ‘int main()’:
  example.cpp:2:9: error: expected primary-expression before ‘int’