get_temporary_buffer

Artigo
06/09/2015

Atribui o armazenamento temporário para uma sequência de elementos que não excede um número especificado de elementos.

template<class Type> 
   pair<Type *, ptrdiff_t> 
      get_temporary_buffer( 
         ptrdiff_t _Count 
      );

Parâmetros

_Count
O número máximo de elementos aplicativos para memória que deve ser atribuído.

Valor de retorno

pair cujo primeiro componente é um ponteiro para a memória que foram atribuídos, cujo segundo componente do tamanho do buffer, indicando o maior número de elementos que poderiam armazenar.

Comentários

A função faz uma solicitação da memória e não pode ser bem-sucedida. Se nenhum buffer é atribuído, a função retorna um par, o segundo componente igual a zero e o primeiro componente igual ao ponteiro nulo.

Essa função só deve ser usada para a memória que é temporária.

Exemplo

// memory_get_temp_buf.cpp
// compile with: /EHsc
#include <memory>
#include <iostream>

using namespace std;

int main( )
{
   // Create an array of ints
   int intArray [ ] = { 10, 20, 30, 40, 100, 200, 300, 1000, 2000 };
   int count = sizeof ( intArray ) / sizeof ( int );
   cout << "The number of integers in the array is: " 
      << count << "." << endl;

   pair<int *, ptrdiff_t> resultPair;
   resultPair = get_temporary_buffer<int>( count );

   cout << "The number of elements that the allocated memory\n"
        << "could store is given by: resultPair.second = " 
        << resultPair.second << "." << endl;
}

Requisitos

Cabeçalho: <memória>

Namespace: std

Partilhar via