Biblioteca de vetores C ++ - função capacity ()

Descrição

A função C ++ std::vector::capacity() retorna o tamanho do armazenamento alocado, expresso em termos de elementos.

Essa capacidade não é necessariamente igual ao tamanho do vetor. Ele pode ser igual ou maior que o tamanho do vetor.

O limite teórico do tamanho do vetor é fornecido pelo membro max_size .

Declaração

A seguir está a declaração para o formulário de função std :: vector :: capacity () std :: vector header.

C ++ 98

size_type capacity() const;

C ++ 11

size_type capacity() const noexcept;

Parâmetros

Nenhum

Valor de retorno

Retorna o tamanho do armazenamento alocado, expresso em termos de número de elementos que podem ser mantidos por vetor.

Exceções

Esta função de membro nunca lança exceção.

Complexidade de tempo

Constante, ou seja, O (1)

Exemplo

O exemplo a seguir mostra o uso da função std :: vector :: capacity ().

#include <iostream>
#include <vector>

using namespace std;

int main(void) {
   vector<int> v;

   for (int i = 0; i < 5; ++i)
      v.push_back(i + 1);

   cout << "Number of elements in vector = " << v.size() << endl;
   cout << "Capacity of vector           = " << v.capacity() << endl;

   return 0;
}

Vamos compilar e executar o programa acima, isso produzirá o seguinte resultado -

Number of elements in vector = 5
Capacity of vector           = 8