vector::capacity

追加の記憶域を割り当てずにベクターに収容できる要素の数を返します。

size_type capacity( ) const;

戻り値

ベクターに割り当てられている記憶域の現在の長さ。

解説

増加分を収容できる十分なメモリが割り当てられている場合は、メンバー関数 resize のほうが効率的に動作します。 割り当てられるメモリの量を指定するには、メンバー関数 reserve を使用します。

使用例

// vector_capacity.cpp
// compile with: /EHsc
#include <vector>
#include <iostream>

int main( )
{
  using namespace std;
    vector <int> v1;
    v1.reserve(10);

    v1.push_back(1);
    cout << "The length of storage allocated is "
        << v1.capacity() << "." << endl;

    v1.push_back(2);
    cout << "The length of storage allocated is now "
        << v1.capacity() << "." << endl;
}

必要条件

ヘッダー: <vector>

名前空間: std

参照

関連項目

vector クラス

vector::size と vector::capacity

標準テンプレート ライブラリ