Bibliothèque de listes C ++ - fonction list ()

La description

La fonction C ++ std::array::at() renvoie une référence à l'élément présent à l'emplacement N dans un conteneur de tableau donné.

Déclaration

Voici la déclaration de l'en-tête std :: array :: at () de la fonction std :: array.

reference at(size_type n);
cont_referece at(size_t n) const;

Paramètres

N - index d'un élément du tableau.

Valeur de retour

Renvoie un élément présent à l'index N dans un tableau donné si N est un index valide sinon lance out_of_range exception.

Si l'objet tableau est qualifié par const, la méthode renvoie la référence const, sinon elle renvoie la référence.

Exceptions

Cette fonction membre jette out_of_range expception si la valeur de N n'est pas un index de tableau valide.

Complexité temporelle

Constante ie O (1)

Exemple

Dans l'exemple ci-dessous, l'étape 1 imprime le contenu du tableau sans exception. L'étape 2 montre la gestion des exceptions à l'aide du bloc try-catch.

#include <iostream>
#include <array>
#include <stdexcept>

using namespace std;

int main(void) {
   array<int, 5> arr = {10, 20, 30, 40, 50};
   size_t i;

   /* print array contents */
   for (i = 0; i < 5; ++i)
      cout << arr.at(i) << " ";
   cout << endl;

   /* generate out_of_range exception. */
   try {
      arr.at(10);
   } catch(out_of_range e) {
      cout << "out_of_range expcepiton caught for " << e.what() << endl;
   }

   return 0;
}

Compilons et exécutons le programme ci-dessus, cela produira le résultat suivant -

10 20 30 40 50 
out_of_range expcepiton caught for array::at: __n (which is 10) >= _Nm (which is 5)