...
Eroare C++ · Excepții și erori la rulare

libc++abi: terminating due to uncaught exception of type std::out_of_range: basic_string

Pe scurt

Ai cerut un element cu .at(i) (la string, vector sau map) la un index sau o cheie care nu există, iar at() a oprit programul. Verifică limitele: indicii valizi sunt de la 0 la size() - 1, iar cheile din map le verifici cu count sau find înainte.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Metoda .at(i) face același lucru ca [i], dar verifică limita: dacă i >= size(), aruncă excepția std::out_of_range. Dacă nu o prinde nimeni (sau excepțiile sunt dezactivate, ca în editorul nostru), programul se oprește cu terminating due to uncaught exception of type std::out_of_range, urmat de un text scurt care spune de unde vine: basic_string (la string), vector (la vector), map::at: key not found (la map).

Cel mai des cauza este un <= în loc de < în condiția buclei: ultimul index valid este size() - 1. Alte cauze: un index calculat greșit (s.at(s.size()) pentru ultimul caracter), substr cu poziția de start după finalul textului, sau o cheie căutată într-un map în care nu există.

Vestea bună: spre deosebire de [i], care poate strica memoria în tăcere, .at(i) îți spune clar că indexul e greșit.

De ce apare: cauzele frecvente

1<= în loc de < în buclă

Greșit
C++
string cod = "RO123";
for (size_t i = 0; i <= cod.size(); i++)
    cout << cod.at(i);
Corect
C++
string cod = "RO123";
for (size_t i = 0; i < cod.size(); i++)
    cout << cod.at(i);

Un text de 5 caractere are indicii 0–4. La i = 5, at oprește programul.

2Ultimul element calculat greșit

Greșit
C++
vector<int> note = {9, 10, 8};
cout << note.at(note.size());
Corect
C++
vector<int> note = {9, 10, 8};
cout << note.at(note.size() - 1);

Ultimul element are indexul size() - 1. Mai simplu: note.back().

3Cheie inexistentă în map

Greșit
C++
map<string, int> stoc = {{"mere", 10}};
cout << stoc.at("pere");
Corect
C++
map<string, int> stoc = {{"mere", 10}};
if (stoc.count("pere")) cout << stoc.at("pere");
else cout << "Nu avem pere";

map::at cere ca cheia să existe. Verific-o întâi cu count sau find.

Repară tu

Repară eroarea, direct în pagină

Programul afișează un cod de produs literă cu literă, separate prin spațiu, dar se oprește cu terminating due to uncaught exception of type std::out_of_range: basic_string. Repară condiția buclei, ca programul să afișeze R O 1 2 3 și apoi Cod verificat.

Codul care dă eroarea
C++
#include <iostream>
#include <string>
using namespace std;

int main() {
    string cod = "RO123";
    for (size_t i = 0; i <= cod.size(); i++) {
        cout << cod.at(i);
        if (i + 1 < cod.size()) cout << " ";
    }
    cout << "\nCod verificat\n";
    return 0;
}
După reparație, programul afișează
R O 1 2 3
Cod verificat
Indiciu

Ultimul index valid este cod.size() - 1.

Alte forme ale mesajului

  • terminate called after throwing an instance of 'std::out_of_range' what(): basic_string::at: __n (which is 5) >= this->size() (which is 5)
  • terminate called after throwing an instance of 'std::out_of_range' what(): vector::_M_range_check: __n (which is 3) >= this->size() (which is 3)
  • libc++abi: terminating due to uncaught exception of type std::out_of_range: map::at: key not found
  • out_of_range was thrown in -fno-exceptions mode with message "vector"

Cum o eviți pe viitor

  • În bucle cu index folosește i < v.size(), nu <=.
  • Când nu ai nevoie de index, parcurge cu for (auto x : v): nu poți ieși din limite.
  • Pentru primul și ultimul element folosește front() și back() (după ce verifici că nu e gol).
  • La map, verifică existența cheii cu count sau find înainte de at.

Întrebări frecvente

De ce GCC afișează terminate called after throwing an instance of?

Este forma mesajului pe Linux, cu biblioteca GCC (libstdc++). Pe clang cu libc++ (Mac, editorul nostru) mesajul este libc++abi: terminating due to uncaught exception of type std::out_of_range. Cauza și reparația sunt aceleași.

Ar trebui să folosesc mereu at() în loc de []?

at() este mai sigur, pentru că verifică limita și te anunță. [] este puțin mai rapid, dar la index greșit poate produce rezultate ciudate sau segmentation fault. Pentru învățare și depanare, at() e alegerea bună.

Erori înrudite

← Toate erorile C++

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață C++ de la zero, cu exerciții la fiecare lecție

Curs C++: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.