CKTIS / C++
std::vector::front — prístup k prvému prvku
`front()` sprístupňuje prvý prvok vektora v konštantnom čase. Ak môže byť vektor prázdny, najprv to over pomocou `empty()`.
Verzia: ISO C++23; implementation support may vary
Syntax
// Member declarations in std::vector<T, Allocator>, declared in <vector>
constexpr reference front();
constexpr const_reference front() const;std::vector::front je členská funkcia deklarovaná v <vector>, ktorá sprístupňuje prvý prvok bez toho, aby ho odstránila. Pre neprázdny vektor v je v.front() ekvivalentné výrazu *v.begin() a sprístupňuje rovnaký prvok ako v[0]. Prístup trvá O(1). Obe preťaženia sú od C++20 constexpr.
V C++23 má volanie front() na prázdnom vektore nedefinované správanie. Nespoliehaj sa na výnimku ani na diagnostickú správu. Ak môže byť vektor prázdny, volaj front() len vtedy, keď platí !v.empty(). Ak má prístup k chýbajúcemu prvku vyvolať výnimku, použi v.at(0), ktoré pri prázdnom vektore vyvolá std::out_of_range.
Pre std::vector<T>, kde T nie je bool, vracia preťaženie bez const typ T&, takže priradením do v.front() zmeníš prvok. Preťaženie const vracia const T& a cez túto referenciu prvok nezmeníš. Pri std::vector<bool> vracia preťaženie bez const hodnotou zástupný objekt, cez ktorý sa dá zmeniť bit, zatiaľ čo preťaženie const vracia hodnotu typu bool.
Uchovaním referencie nepredĺžiš životnosť prvku. Nepoužívaj ju po odstránení prvku, zániku vektora ani realokácii jeho pamäte, napríklad keď push_back() musí zväčšiť kapacitu. Referenciu vrátenú funkciou front() na dočasnom vektore neuchovávaj po skončení úplného výrazu, v ktorom tento vektor vznikol.
Príklady
#include <iostream>
#include <vector>
void print_first(const std::vector<int>& values)
{
if (values.empty()) {
std::cout << "empty\n";
return;
}
std::cout << values.front() << '\n';
}
int main()
{
std::vector<int> values{7, 9};
int& first = values.front();
first = 42;
print_first(values);
print_first(std::vector<int>{});
}
Výsledok
42 empty
Priradenie cez `first` zmení prvý prvok na `42`. Funkcia `print_first` ho prečíta cez preťaženie `const` a pri prázdnom vektore vypíše `empty` bez volania `front()`.
Súvisiace lekcie
- C++ · Lekcia 28 · Pokročilá · Verzia: 3