C++ Mensagens de Erro

#include <iostream>

int main() {
    std::cout << "Olá" << '\n'
}

$ g++ -std=c++23 -Wall -Wextra pontovirgula2.cpp -o pontovirgula2
pontovirgula2.cpp: In function ‘int main()’:
pontovirgula2.cpp:4:31: error: expected ‘;’ before ‘}’ token
    4 |     std::cout << "Olá" << '\n'
      |                               ^
      |                               ;
    5 | }
      | ~
$ clang++ -std=c++23 -Wall -Wextra pontovirgula2.cpp -o pontovirgula2
pontovirgula2.cpp:4:32: error: expected ';' after expression
    4 |     std::cout << "Olá" << '\n'
      |                               ^
      |                               ;
1 error generated.

Quando falta o ; numa declaração (int idade = 30), o g++ escreve expected ‘,’ or ‘;’ before ‘std’ (com a palavra que veio depois) e o clang++, expected ';' at end of declaration.

Como consertar: o g++ aponta o lugar onde percebeu a falta, que muitas vezes é o começo da linha seguinte. Olhe o fim da linha anterior. Aula: Sintaxe.

#include <iostream>

int main() {
    int total = 10;
    std::cout << totl << '\n';
}

$ g++ -std=c++23 -Wall -Wextra naodeclarada.cpp -o naodeclarada
naodeclarada.cpp: In function ‘int main()’:
naodeclarada.cpp:5:18: error: ‘totl’ was not declared in this scope; did you mean ‘total’?
    5 |     std::cout << totl << '\n';
      |                  ^~~~
      |                  total
naodeclarada.cpp:4:9: warning: unused variable ‘total’ [-Wunused-variable]
    4 |     int total = 10;
      |         ^~~~~
$ clang++ -std=c++23 -Wall -Wextra naodeclarada.cpp -o naodeclarada
naodeclarada.cpp:5:18: error: use of undeclared identifier 'totl'; did you mean 'total'?
    5 |     std::cout << totl << '\n';
      |                  ^~~~
      |                  total
naodeclarada.cpp:4:9: note: 'total' declared here
    4 |     int total = 10;
      |         ^
1 error generated.

O que significa: "totl não foi declarado neste escopo". As causas: nome digitado diferente (maiúsculas contam: Total ≠ total), variável criada depois da linha, ou criada dentro de outro bloco { } (veja Escopo). Sem nenhum tipo antes (idade = 30;), a mensagem é a mesma: em C++, toda variável precisa ser declarada com um tipo.

Como consertar: aceite a sugestão did you mean se ela fizer sentido, ou declare a variável antes de usar: int idade = 30;. Aula: Variáveis.

$ g++ -std=c++23 -Wall -Wextra semstd.cpp -o semstd
semstd.cpp: In function ‘int main()’:
semstd.cpp:4:5: error: ‘cout’ was not declared in this scope; did you mean ‘std::cout’?
    4 |     cout << "Olá\n";
      |     ^~~~
      |     std::cout
In file included from semstd.cpp:1:
/usr/include/c++/15/iostream:65:18: note: ‘std::cout’ declared here
   65 |   extern ostream cout;          ///< Linked to standard output
      |                  ^~~~
$ clang++ -std=c++23 -Wall -Wextra semstd.cpp -o semstd
semstd.cpp:4:5: error: use of undeclared identifier 'cout'; did you mean 'std::cout'?
    4 |     cout << "Olá\n";
      |     ^~~~
      |     std::cout
/usr/lib/gcc/x86_64-linux-gnu/15/../../../../include/c++/15/iostream:65:18: note: 'std::cout' declared here
   65 |   extern ostream cout;          ///< Linked to standard output
      |                  ^
1 error generated.

Com string nome = "Ana"; o g++ escreve error: ‘string’ was not declared in this scope e lista note: suggested alternatives: ‘std::string’; o clang++, error: unknown type name 'string'; did you mean 'std::string'?. Com endl: ‘endl’ was not declared in this scope; did you mean ‘std::endl’?.

O que significa: tudo da biblioteca padrão mora no "sobrenome" std (um namespace).

Como consertar: escreva std::cout, std::string, std::endl. Aula: Saída com cout.

$ g++ -std=c++23 -Wall -Wextra semiomanip.cpp -o semiomanip
semiomanip.cpp: In function ‘int main()’:
semiomanip.cpp:4:23: error: ‘setw’ is not a member of ‘std’
    4 |     std::cout << std::setw(5) << 42 << '\n';
      |                       ^~~~
semiomanip.cpp:2:1: note: ‘std::setw’ is defined in header ‘<iomanip>’; this is probably fixable by adding ‘#include <iomanip>’
    1 | #include <iostream>
  +++ |+#include <iomanip>
    2 |
$ clang++ -std=c++23 -Wall -Wextra semiomanip.cpp -o semiomanip
semiomanip.cpp:4:18: error: no member named 'setw' in namespace 'std'; did you mean 'getw'?
    4 |     std::cout << std::setw(5) << 42 << '\n';
      |                  ^~~~~~~~~
      |                  getw
/usr/include/stdio.h:647:12: note: 'getw' declared here
  647 | extern int getw (FILE *__stream) __nonnull ((1));
      |            ^
semiomanip.cpp:4:28: error: cannot initialize a parameter of type 'FILE *' (aka '_IO_FILE *') with an rvalue of type 'int'
    4 |     std::cout << std::setw(5) << 42 << '\n';
      |                            ^
/usr/include/stdio.h:647:24: note: passing argument to parameter '__stream' here
  647 | extern int getw (FILE *__stream) __nonnull ((1));
      |                        ^
2 errors generated.

O que significa: "setw não é membro de std": o cabeçalho que o traz não foi incluído. O g++ ainda diz qual incluir (+++ |+#include <iomanip> mostra a linha a acrescentar). O clang++ tenta adivinhar um nome parecido (getw), que não tem nada a ver: ignore a sugestão.

Outras formas do mesmo problema: sem <map>, ‘map’ is not a member of ‘std’ (clang++: no template named 'map' in namespace 'std'; did you mean 'max'?); sem <cmath>, ‘sqrt’ was not declared in this scope; sem <vector>, uma mensagem estranha: error: wrong number of template arguments (1, should be 2) (clang++: too few template arguments for class template 'vector').

Como consertar: acrescente o #include certo no topo. Cuidado: às vezes um cabeçalho traz outro "de carona" e o programa compila sem o #include (no g++ 15, std::string funcionou só com <iostream>). Não conte com isso: inclua sempre o que usa. Aula: O Pré-processador.

$ g++ -std=c++23 -Wall -Wextra arquivo.cpp -o arquivo
arquivo.cpp:1:10: fatal error: iostrem: Arquivo ou diretório inexistente
    1 | #include <iostrem>
      |          ^~~~~~~~~
compilation terminated.
$ clang++ -std=c++23 -Wall -Wextra arquivo.cpp -o arquivo
arquivo.cpp:1:10: fatal error: 'iostrem' file not found
    1 | #include <iostrem>
      |          ^~~~~~~~~
1 error generated.

O que significa: o arquivo pedido no #include não existe. fatal error para a compilação na hora (compilation terminated). O pedaço "Arquivo ou diretório inexistente" vem do sistema, por isso está em português; em inglês: No such file or directory.

Como consertar: confira a grafia (iostream). Para um arquivo seu, use aspas e confira a pasta: #include "soma.h". Aula: Arquivos .h e .cpp.

$ cat tipo.cpp
int main() {
    int idade = "30";
    return idade;
}
$ g++ -std=c++23 -Wall -Wextra tipo.cpp -o tipo
tipo.cpp: In function ‘int main()’:
tipo.cpp:2:17: error: invalid conversion from ‘const char*’ to ‘int’ [-fpermissive]
    2 |     int idade = "30";
      |                 ^~~~
      |                 |
      |                 const char*
$ clang++ -std=c++23 -Wall -Wextra tipo.cpp -o tipo
tipo.cpp:2:9: error: cannot initialize a variable of type 'int' with an lvalue of type 'const char[3]'
    2 |     int idade = "30";
      |         ^       ~~~~
1 error generated.

O que significa: "30", entre aspas, é texto (para o compilador, const char* ou const char[3]: dois caracteres mais o final invisível), e a variável é int. O C++ não converte texto em número sozinho.

Parentes: char letra = "A"; dá invalid conversion from ‘const char*’ to ‘char’ (use aspas simples: 'A'); std::string s = 5; dá conversion from ‘int’ to non-scalar type ‘std::string’ … requested (clang++: no viable conversion from 'int' to 'std::string').

Como consertar: tire as aspas (int idade = 30;) ou, se o texto vem de fora, converta com std::stoi. Aulas: Tipos de Dados, Texto ↔ Número, char.

#include <iostream>
#include <vector>

int main() {
    std::vector<int> v{1, 2, 3};
    std::cout << v << '\n';
}

$ g++ -std=c++23 -Wall -Wextra coutvector.cpp -o coutvector
coutvector.cpp: In function ‘int main()’:
coutvector.cpp:6:15: error: no match for ‘operator<<’ (operand types are ‘std::ostream’ {aka ‘std::basic_ostream<char>’} and ‘std::vector<int>’)
    6 |     std::cout << v << '\n';
      |     ~~~~~~~~~ ^~ ~
      |          |       |
      |          |       std::vector<int>
      |          std::ostream {aka std::basic_ostream<char>}
coutvector.cpp:6:15: note: there are 52 candidates
«  … mais 360 linhas de "candidate N: …", uma para cada tipo que o cout sabe mostrar …
$ clang++ -std=c++23 -Wall -Wextra coutvector.cpp -o coutvector
coutvector.cpp:6:15: error: invalid operands to binary expression ('ostream' (aka 'basic_ostream<char>') and 'std::vector<int>')
    6 |     std::cout << v << '\n';
      |     ~~~~~~~~~ ^  ~
«  … mais 145 linhas de "candidate … not viable" …

O que significa: "não existe << que receba um ostream e um std::vector<int>". O cout sabe mostrar números, texto e caracteres, mas não um vetor inteiro (nem uma struct sua). As 52 "candidatas" são as versões de << que existem; nenhuma serve.

Como consertar: mostre item por item com um for de intervalo, ou use std::println("{}", v); do C++23, que sabe mostrar vetores (std::format e std::print). Para uma classe sua, ensine o << a ela (Sobrecarga de Operadores).

$ g++ -std=c++23 -Wall -Wextra argumentos.cpp -o argumentos
argumentos.cpp: In function ‘int main()’:
argumentos.cpp:6:16: error: too few arguments to function ‘int soma(int, int)’
    6 |     return soma(2);
      |            ~~~~^~~
argumentos.cpp:1:5: note: declared here
    1 | int soma(int a, int b) {
      |     ^~~~
$ clang++ -std=c++23 -Wall -Wextra argumentos.cpp -o argumentos
argumentos.cpp:6:12: error: no matching function for call to 'soma'
    6 |     return soma(2);
      |            ^~~~
argumentos.cpp:1:5: note: candidate function not viable: requires 2 arguments, but 1 was provided
    1 | int soma(int a, int b) {
      |     ^    ~~~~~~~~~~~~
1 error generated.

O que significa: "argumentos de menos para a função soma(int, int)": ela pede dois, você deu um. Com argumentos demais, too many arguments. Quando há várias versões da função (sobrecarga) e nenhuma serve, o g++ também diz no matching function for call to ‘…’ e lista as candidatas.

Como consertar: confira a assinatura que a nota declared here mostra e passe os argumentos na quantidade e nos tipos certos. Aulas: Parâmetros e Argumentos, Valores Padrão.

$ g++ -std=c++23 -Wall -Wextra const.cpp -o const
const.cpp: In function ‘int main()’:
const.cpp:3:12: error: assignment of read-only variable ‘maximo’
    3 |     maximo = 20;
      |     ~~~~~~~^~~~
$ clang++ -std=c++23 -Wall -Wextra const.cpp -o const
const.cpp:3:12: error: cannot assign to variable 'maximo' with const-qualified type 'const int'
    3 |     maximo = 20;
      |     ~~~~~~ ^
const.cpp:2:15: note: variable 'maximo' declared const here
    2 |     const int maximo = 10;
      |     ~~~~~~~~~~^~~~~~~~~~~
1 error generated.

O que significa: "atribuição a variável somente leitura": maximo foi declarada const. O compilador está fazendo o trabalho dele: proteger um valor que você mesmo disse que não muda.

Como consertar: se o valor precisa mudar, tire o const; se não, não mude. Aula: Constantes.

$ cat chave.cpp
#include <iostream>

int main() {
    if (true) {
        std::cout << "oi\n";
}
$ g++ -std=c++23 -Wall -Wextra chave.cpp -o chave
chave.cpp: In function ‘int main()’:
chave.cpp:6:2: error: expected ‘}’ at end of input
    6 | }
      |  ^
chave.cpp:3:12: note: to match this ‘{’
    3 | int main() {
      |            ^
$ clang++ -std=c++23 -Wall -Wextra chave.cpp -o chave
chave.cpp:6:2: error: expected '}'
    6 | }
      |  ^
chave.cpp:3:12: note: to match this '{'
    3 | int main() {
      |            ^
1 error generated.

O que significa: o arquivo acabou ("end of input") com uma { ainda aberta. A nota aponta a chave que ficou sem par, mas atenção: o compilador casa cada } com a { aberta mais recente, então a chave que de fato ficou sem fechar (aqui, a do if) pode ser outra.

O contrário, uma } sobrando, dá expected declaration before ‘}’ token (clang++: extraneous closing brace ('}')).

Como consertar: mantenha a indentação certinha (o editor ajuda) e confira bloco por bloco. Aula: Sintaxe.

O main.cpp inclui soma.h (que só declara int soma(int a, int b);), mas a Ana compilou só o main.cpp, esquecendo o soma.cpp, onde a função é definida:

$ g++ -std=c++23 -Wall -Wextra main.cpp -o main
/usr/bin/x86_64-linux-gnu-ld.bfd: /tmp/ccsEstGP.o: na função "main":
main.cpp:(.text+0x13): referência não definida para "soma(int, int)"
collect2: error: ld returned 1 exit status
$ LANG=C g++ -std=c++23 -Wall -Wextra main.cpp -o main
/usr/bin/x86_64-linux-gnu-ld.bfd: /tmp/ccTr6gcB.o: in function `main':
main.cpp:(.text+0x13): undefined reference to `soma(int, int)'
collect2: error: ld returned 1 exit status
$ clang++ -std=c++23 -Wall -Wextra main.cpp -o main
/usr/bin/x86_64-linux-gnu-ld.bfd: /tmp/main-e08580.o: na função "main":
main.cpp:(.text+0xf): referência não definida para "soma(int, int)"
clang++: error: linker command failed with exit code 1 (use -v to see invocation)
$ g++ -std=c++23 -Wall -Wextra main.cpp soma.cpp -o main
$ ./main
5

No editor do guia, o ligador é outro (wasm-ld) e a mesma falha aparece como wasm-ld: error: /tmp/main-62bf3f.o: undefined symbol: soma(int, int) ("símbolo não definido").

O que significa: "dentro da função main, há uma chamada a soma(int, int), mas ninguém a definiu". O compilador aceitou a chamada porque viu a declaração no .h; o ligador não achou o corpo da função.

Causas e consertos:

• esqueceu um .cpp no comando: g++ … main.cpp soma.cpp -o main;
• o nome ou os parâmetros da definição não batem com a declaração (int Soma(int a, int b) no .cpp, int soma(int, int) no .h: maiúscula conta);
• a função foi declarada e nunca escrita;
• uma biblioteca externa não foi ligada (falta um -lnome; veja Usar Bibliotecas Externas).

Um arquivo sem main dá a mesma família de erro: (.text+0x1b): referência não definida para "main" (em inglês, undefined reference to `main'), vinda de Scrt1.o: na função "_start", o código que o sistema roda antes do seu main.

O cabeçalho config.h define uma variável (int total = 0;) e é incluído em a.cpp e em b.cpp. Cada arquivo ganha a sua cópia, e o ligador não sabe com qual ficar:

$ g++ -std=c++23 -Wall -Wextra a.cpp b.cpp -o prog
/usr/bin/x86_64-linux-gnu-ld.bfd: /tmp/ccfu3U3T.o:(.bss+0x0): múltiplas definições de "total"; /tmp/cciF57P8.o:(.bss+0x0): definido primeiro aqui
collect2: error: ld returned 1 exit status
$ LANG=C g++ -std=c++23 -Wall -Wextra a.cpp b.cpp -o prog
/usr/bin/x86_64-linux-gnu-ld.bfd: /tmp/ccV3ztVv.o:(.bss+0x0): multiple definition of `total'; /tmp/ccw6qlvg.o:(.bss+0x0): first defined here
collect2: error: ld returned 1 exit status

O #pragma once não resolve: ele evita incluir o mesmo .h duas vezes no mesmo .cpp, não em dois .cpp diferentes.

Como consertar: no .h, use inline int total = 0; C++17 (uma variável compartilhada, permitida em vários arquivos), ou declare com extern int total; no .h e defina int total = 0; num .cpp só. Para funções escritas no .h, a mesma regra: marque-as inline.

#include <iostream>

int main() {
    int* p = nullptr;
    std::cout << "antes\n";
    std::cout << *p << '\n';
}

$ g++ -std=c++23 -Wall -Wextra nulo.cpp -o nulo
$ ./nulo
antes
Falha de segmentação     (imagem do núcleo gravada) ./nulo
$ echo $?
139

Em inglês: Segmentation fault (core dumped) ./nulo.

O que significa: o programa tentou ler ou escrever numa parte da memória que não é dele, e o sistema o matou com o sinal SIGSEGV. Causas típicas: usar um ponteiro nulo (*p com p = nullptr), um ponteiro para algo que já foi apagado, um índice muito fora do array, ou uma recursão sem fim, que estoura a pilha (a conta(n + 1) sem caso de parada deu a mesma mensagem e o mesmo 139).

Como consertar: confira ponteiros antes de usar (if (p != nullptr)), prefira std::vector e ponteiros inteligentes, e use o gdb ou os sanitizers para achar a linha. Aulas: Ponteiros, nullptr.

#include <iostream>

int main() {
    int total = 10, pessoas = 0;
    std::cin >> pessoas;
    std::cout << total / pessoas << '\n';
}

$ echo 0 | ./divisao
Exceção de ponto flutuante (imagem do núcleo gravada) echo 0 | ./divisao
$ echo $?
136

Em inglês: Floating point exception (core dumped) echo 0 | ./divisao.

O que significa: apesar do nome, é uma divisão inteira por zero (ou o resto % por zero). O processador recusa a conta e o sistema mata o programa com o sinal SIGFPE. Com double, dividir por zero não mata o programa: dá inf ou nan.

Como consertar: confira o divisor antes: if (pessoas == 0) { … }. Aulas: Aritméticos, Validar a Entrada.

#include <iostream>
#include <vector>

int main() {
    std::vector<int> notas{7, 9, 8};
    std::cout << notas.at(10) << '\n';
}

$ ./at
terminate called after throwing an instance of 'std::out_of_range'
  what():  vector::_M_range_check: __n (which is 10) >= this->size() (which is 3)
Abortado                   (imagem do núcleo gravada) ./at
$ echo $?
134

Em inglês, a última linha fica Aborted (core dumped) ./at.

O que significa: uma exceção foi lançada e ninguém a capturou com try/catch. O C++ então chama std::terminate, que mostra o tipo da exceção (std::out_of_range) e a mensagem dela (what():), e aborta o programa com o sinal SIGABRT. Aqui: "índice 10 ≥ tamanho 3".

As que mais aparecem (todas reais, todas com código 134):

Como consertar: evite a causa (confira o índice, valide o texto) ou capture a exceção onde você sabe o que fazer: try { … } catch (const std::exception& e) { std::cout << e.what(); }.

$ cat colchete.cpp
#include <iostream>
#include <vector>

int main() {
    std::vector<int> notas{7, 9, 8};
    std::cout << notas[10] << '\n';
}
$ g++ -std=c++23 -Wall -Wextra colchete.cpp -o colchete
$ ./colchete
/usr/include/c++/15/bits/stl_vector.h:1263: constexpr std::vector< <template-parameter-1-1>, <template-parameter-1-2> >::reference std::vector< <template-parameter-1-1>, <template-parameter-1-2> >::operator[](size_type) [with _Tp = int; _Alloc = std::allocator<int>; reference = int&; size_type = long unsigned int]: Assertion '__n < this->size()' failed.
Abortado                   (imagem do núcleo gravada) ./colchete
$ g++ -std=c++23 -Wall -Wextra -O2 colchete.cpp -o colchete 2>/dev/null
$ ./colchete
0

O que significa: o [ ] do vetor não confere o índice, ao contrário do .at(). Mas a biblioteca do g++ 15, quando você compila sem otimização (sem -O2), liga umas conferências extras ("asserções") que pegam o erro e abortam (código 134). Com -O2, as conferências somem e o programa simplesmente lê lixo da memória e mostra 0 (ou qualquer outra coisa): é comportamento indefinido.

Como consertar: confira o índice (i < notas.size()), use for de intervalo, ou .at() quando o índice vem de fora.

$ cat doublefree.cpp
int main() {
    int* p = new int(5);
    delete p;
    delete p;
}
$ ./doublefree
free(): double free detected in tcache 2
Abortado                   (imagem do núcleo gravada) ./doublefree
$ echo $?
134

O que significa: o mesmo bloco de memória foi devolvido duas vezes. A biblioteca C percebeu e abortou. (tcache é o nome de uma "gaveta" interna do gerenciador de memória.) Nem sempre o erro é pego: às vezes o programa continua e falha bem depois, num lugar sem relação.

Como consertar: não use new/delete à mão: std::unique_ptr, std::vector e std::string liberam a memória sozinhos, uma vez só. Aulas: new e delete, Ponteiros Inteligentes, RAII.