num_get::get

發行項
02/28/2013

擷取字元序列的數值或布林值。

iter_type get(
    iter_type _First,
    iter_type _Last,
    ios_base& _Iosbase,
    ios_base::iostate& _State,
    bool& _Val
) const;
iter_type get(
    iter_type _First,
    iter_type _Last,
    ios_base& _Iosbase,
    ios_base::iostate& _State,
    unsigned short& _Val
) const;
iter_type get(
    iter_type _First,
    iter_type _Last,
    ios_base& _Iosbase,
    ios_base::iostate& _State,
    unsigned int& _Val
) const;
iter_type get(
    iter_type _First,
    iter_type _Last,
    ios_base& _Iosbase,
    ios_base::iostate& _State,
    long& _Val
) const;
iter_type get(
    iter_type _First,
    iter_type _Last,
    ios_base& _Iosbase,
    ios_base::iostate& _State,
    unsigned long& _Val
) const;
iter_type get(
    iter_type _First, 
    iter_type _Last,
    ios_base& _Iosbase, 
    ios_base::iostate& _State,
    long long& _Val
) const;
iter_type get(
    iter_type _First, 
    iter_type _Last,
    ios_base& _Iosbase, 
    ios_base::iostate& _State,
    unsigned long long& _Val
) const;
iter_type get(
    iter_type _First,
    iter_type _Last,
    ios_base& _Iosbase,
    ios_base::iostate& _State,
    float& _Val
) const;
iter_type get(
    iter_type _First,
    iter_type _Last,
    ios_base& _Iosbase,
    ios_base::iostate& _State,
    double& _Val
) const;
iter_type get(
    iter_type _First,
    iter_type _Last,
    ios_base& _Iosbase,
    ios_base::iostate& _State,
    long double& _Val
) const;
iter_type get(
    iter_type _First,
    iter_type _Last,
    ios_base& _Iosbase,
    ios_base::iostate& _State,
    void *& _Val
) const;

參數

_First
字元範圍開頭的讀取數目。
_Last
字元範圍的結尾讀取數目。
_Iosbase
轉換使用旗標的 ios_base 。
_State
failbit 的狀態 (請參閱 ios_base::iostate) 將會失敗。
_Val
已讀取的值。

傳回值

Iterator，在讀取的值之後。

備註

所有成員函式傳回 do_get(_First、 _Last、 _Iosbase、 _State， _Val)。

第一個受保護的虛擬成員函式會嘗試比對開始先序列 [_First， _Last) 的順序元件時，才會辨識的完整，非空白的整數輸入欄位。如果成功，則在 _Val將這個欄位轉換成其對等的值做為型別 long 並儲存結果。它會傳回指定以數字輸入欄位之外的 Iterator 第一個項目。如果不是，函式則在 _Val 不儲存並在 _State 的 ios_base::failbit 。它會傳回指定以有效的整數輸入欄位的所有前置字元以外的 Iterator 第一個項目。在任何情況下，則為，如果傳回值等於 last，函式將在 _State的 ios_base::eofbit 。

整數輸入欄位掃描函式使用相同的規則將為了符合和轉換一系列的 char 項目從檔案。每一個這類 char 項目由簡單，一對一對應假設對應至型別 CharType 的對等項目。判斷對等掃描轉換規格如下所示:

如果 iosbase。旗標 _&;RYAN ios_base::basefield == ios_base::10 月，轉換規格是 lo。
如果 iosbase.flags _&;RYAN ios_base::basefield == ios_base::hex，轉換規格是 lx。
如果 iosbase.flags _&;RYAN ios_base::basefield == 0，轉換規格是 li。
否則，轉換規格是 ld。

地區設定 Facet進一步取決於整數輸入資料行的格式呼叫中傳回的facuse_facet <numpunct<Elem> (iosbase。getloc)。尤其是：

fac。群組判斷數字如何在任何小數點的左側進行分組。
fac。thousands_sep 判斷在任何小數點左邊分隔數字群組的序列。

如果 fac沒有執行個體。thousands_sep 在數值欄位中輸入時，就不會群組的條件約束會影響。否則，所有群組的條件約束。 fac施加了。grouping 強制，並移除分隔符號，在掃描轉換發生之前。

第二個受保護的虛擬成員函式:

virtual iter_type do_get(iter_type _First, iter_type _Last,
    ios_base& _Iosbase, ios_base::iostate& _State,
        unsigned long& _Val) const;

正常運作方式和第一個增益集的相同，不過，前者會 lu取代 ld 之轉換規格。如果成功，則會 _Val值的會將數字輸入欄位轉換為型別 unsigned long 的值和存放區。

第三個受保護的虛擬成員函式:

virtual iter_type do_get(iter_type _First, iter_type _Last,
    ios_base& _Iosbase, ios_base::iostate& _State,
        double& _Val) const;

正常運作方式和第一個增益集的相同，不同的是，它會嘗試比對完整，非空白的浮點輸入欄位。 fac。decimal_point 判斷小數位數分隔整數數字的序列。對等掃描轉換規範是 lf。

第四個受保護的虛擬成員函式:

virtual iter_type do_get(iter_type _First, iter_type _Last,
    ios_base& _Iosbase, ios_base::iostate& _State,
        long double& _Val) const;

相同的行為，但是有一點例外，就是三個對等掃描轉換規範是 Lf。

第五個受保護的虛擬成員函式:

virtual iter_type do_get(iter_type _First, iter_type _Last,
    ios_base& _Iosbase, ios_base::iostate& _State,
        void *& _Val) const;

相同的行為，不同的是，第一個對等掃描轉換規範為 p。

第六個受保護的虛擬成員函式:

virtual iter_type do_get(iter_type _First, iter_type _Last,
    ios_base& _Iosbase, ios_base::iostate& _State,
        bool& _Val) const;

正常運作方式和第一個增益集的相同，不同的是，它會嘗試比對完整，非空白的布林值輸入欄位。如果成功。 _Val值會轉換成布林值輸入欄位轉換為型別 bool 的值和存放區。

布林值輸入欄位是下列兩種形式中的一個。如果 iosbase。flags _&;RYAN ios_base::boolalpha 是 false，它會做為整數輸入欄位，但不同的是，已轉換的值必須是 0 ( false) 或 1 ( true)。否則，這個序列必須符合任何 fac。falsename ( false)，或 fac。truename ( true)。

範例

// num_get_get.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
#include <sstream>
using namespace std;
int main( )
{
   locale loc( "german_germany" );

   basic_stringstream<char> psz, psz2;
   psz << "-1000,56";

   ios_base::iostate st = 0;
   long double fVal;
   cout << use_facet <numpunct <char> >(loc).thousands_sep( ) << endl;


   psz.imbue( loc );
   use_facet <num_get <char> >
   (loc).get( basic_istream<char>::_Iter( psz.rdbuf( ) ),
           basic_istream<char>::_Iter(0), psz, st, fVal );

   if ( st & ios_base::failbit )
      cout << "money_get( ) FAILED" << endl;
   else
      cout << "money_get( ) = " << fVal << endl;
}

Output

.
money_get( ) = -1000.56

需求

標題: <locale>

命名空間: std

請參閱

參考

num_get Class

共用方式為

num_get::get

參數

傳回值

備註

範例

Output

需求

請參閱

參考

其他資源