num_put::put

Converte um número em uma seqüência de CharTypes que representa o número formatado para uma localidade determinada.

iter_type put(
    iter_type _Dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    bool _Val
) const;
iter_type put(
    iter_type _Dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    long _Val
) const;
iter_type put(
    iter_type _Dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    unsigned long _Val
) const;
iter_type put(
    iter_type _Dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    Long long _Val
) const;
iter_type put(
    iter_type _Dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    Unsigned long long _Val
) const;

iter_type put(
    iter_type _Dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    double _Val
) const;
iter_type put(
    iter_type _Dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    long double _Val
) const;
iter_type put(
    iter_type _Dest,
    ios_base& _Iosbase,
    _Elem _Fill,
    const void * _Val
) const;

Parâmetros

• _Dest
  Um iterador que trata o primeiro elemento da cadeia de caracteres inserido.

• _Iosbase
  Especificar o fluxo que contém a localidade com o aspecto de numpunct usada para interromper a saída e sinalizadores para formatar a saída.

• _Fill
  Um caractere que é usado espaçando.

• _Val
  O número ou o tipo booleano que é ser saída.

Valor de retorno

Um iterador de saída endereços que a posição uma além do último elemento gerado.

Comentários

Todas as funções de membro do_putde retorno (_Next, _Iosbase, _Fill, _Val).

Exemplo

// num_put_put.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
#include <sstream>
using namespace std;
int main( )
{
   locale loc( "german_germany" );
   basic_stringstream<char> psz2;
   ios_base::iostate st = 0;
   long double fVal;
   cout << "The thousands separator is: " 
        << use_facet < numpunct <char> >(loc).thousands_sep( ) 
        << endl;

   psz2.imbue( loc );
   use_facet < num_put < char > >
      ( loc ).put(basic_ostream<char>::_Iter(psz2.rdbuf( ) ),
                    psz2, ' ', fVal=1000.67);

   if ( st & ios_base::failbit )
      cout << "num_put( ) FAILED" << endl;
   else
      cout << "num_put( ) = " << psz2.rdbuf( )->str( ) << endl;
}

Requisitos

Cabeçalho: <locale>

namespace: STD

Consulte também

Referência

num_put Class