C++ Builder 參考手冊 ? System::Sysutils ? TryStrToCurr

字符串轉(zhuǎn)貨幣類型數(shù)值

頭文件：#include <System.SysUtils.hpp>
命名空間：System::Sysutils
函數(shù)原型：

bool __fastcall TryStrToCurr(
    const System::UnicodeString S,
    System::Currency &Value);

bool __fastcall TryStrToCurr(
    const System::UnicodeString S,
    System::Currency &Value,
    const TFormatSettings &AFormatSettings);

參數(shù)：

• S：字符串；
• Value：輸出貨幣類型數(shù)值轉(zhuǎn)換結果径荔；
• AFormatSettings：地區(qū)格式冲呢；

返回值：

• true：通過參數(shù) Value 返回貨幣型數(shù)值犁苏，貨幣類型范圍為：-922337203685477.5808 ~ 922337203685477.5807姐叁；
• false：轉(zhuǎn)換失敗，數(shù)值超范圍或者含有不可識別的字符等继谚；
• 函數(shù) StrToCurr奏路、StrToCurrDef 和 TryStrToCurr 的區(qū)別：
  ? StrToCurr 轉(zhuǎn)換失敗拋出 EConvertError 異常；
  ? StrToCurrDef 轉(zhuǎn)換失敗返回默認值弃舒；
  ? TryStrToCurr 轉(zhuǎn)換結果通過參數(shù) Value 返回癞埠，函數(shù)返回值返回是否轉(zhuǎn)換成功；
• 地區(qū)格式：這個函數(shù)使用了地區(qū)格式的 DecimalSeparator 成員作為小數(shù)點聋呢，中國和大多數(shù)國家一樣使用小圓點作為小數(shù)點苗踪，但是有的國家 - 例如法國：使用逗號當做小數(shù)點，如果程序在法國和越南等國家的電腦上運行削锰，默認情況所有的小數(shù)點都會使用逗號通铲，包括浮點數(shù)，不僅僅是貨幣型器贩，程序國際化時要特別注意颅夺；
• 如果沒有 AFormatSettings 參數(shù)，使用全局變量 FormatSettings 作為地區(qū)格式蛹稍，可以通過修改這個全局變量來修改默認的格式吧黄，使用函數(shù) GetFormatSettings 讓這個全局變量恢復默認格式為當前地區(qū)格式；
• 如果有 AFormatSettings 參數(shù)稳摄，使用這個參數(shù)的格式稚字，并且使用這個參數(shù)可以隨意設定一個字符當做小數(shù)點，請參考 StrToCurr 和 StrToCurrDef 的例子厦酬；
• 沒有 AFormatSettings 參數(shù)的函數(shù)不是線程安全的胆描，因為使用了全局變量 FormatSettings 作為默認的地區(qū)格式；帶有 AFormatSettings 參數(shù)的函數(shù)是線程安全的仗阅。

例子：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    System::Currency cy;

    if(TryStrToCurr(L"10", cy))
        Memo1->Lines->Add(cy);
    else
        Memo1->Lines->Add(L"轉(zhuǎn)換失敗");

    if(TryStrToCurr(L"-1.5", cy))
        Memo1->Lines->Add(cy);
    else
        Memo1->Lines->Add(L"轉(zhuǎn)換失敗");

    if(TryStrToCurr(L"12.345", cy))
        Memo1->Lines->Add(cy);
    else
        Memo1->Lines->Add(L"轉(zhuǎn)換失敗");

    TFormatSettings fs = TFormatSettings::Create(L"fr_FR"); // 法國

    if(TryStrToCurr(L"3.14", cy, fs)) // 法國不能用小圓點 . 作小數(shù)點
        Memo1->Lines->Add(cy);
    else
        Memo1->Lines->Add(L"轉(zhuǎn)換失敗");

    if(TryStrToCurr(L"3,14", cy, fs)) // 法國必須用逗號 , 作小數(shù)點
        Memo1->Lines->Add(cy);
    else
        Memo1->Lines->Add(L"轉(zhuǎn)換失敗");
}

運行結果：

運行結果

相關：

• System::Sysutils::CurrToStr
• System::Sysutils::CurrToStrF
• System::Sysutils::FormatSettings
• System::Sysutils::GetFormatSettings
• System::Sysutils::TFormatSettings
• System::Sysutils::StrToBool
• System::Sysutils::StrToBoolDef
• System::Sysutils::StrToCurr
• System::Sysutils::StrToCurrDef
• System::Sysutils::StrToDate
• System::Sysutils::StrToDateDef
• System::Sysutils::StrToDateTime
• System::Sysutils::StrToDateTimeDef
• System::Sysutils::StrToFloat
• System::Sysutils::StrToFloatDef
• System::Sysutils::StrToInt
• System::Sysutils::StrToIntDef
• System::Sysutils::StrToInt64
• System::Sysutils::StrToInt64Def
• System::Sysutils::StrToTime
• System::Sysutils::StrToTimeDef
• System::Sysutils::StrToUInt
• System::Sysutils::StrToUIntDef
• System::Sysutils::StrToUInt64
• System::Sysutils::StrToUInt64Def
• System::Sysutils::TryStrToBool
• System::Sysutils::TryStrToCurr
• System::Sysutils::TryStrToDate
• System::Sysutils::TryStrToDateTime
• System::Sysutils::TryStrToFloat
• System::Sysutils::TryStrToInt
• System::Sysutils::TryStrToInt64
• System::Sysutils::TryStrToTime
• System::Sysutils::TryStrToUInt
• System::Sysutils::TryStrToUInt64
• System::Sysutils
• System::Currency
• System
• std::atof, std::_ttof, std::_wtof
• std::_atold, std::_ttold, std::_wtold
• std::atoi, std::_ttoi, std::_wtoi
• std::atol, std::_ttol, std::_wtol
• std::atoll, std::_ttoll, std::_wtoll
• std::_atoi64, std::_ttoi64, std::_wtoi64
• std::strtof, std::_tcstof, std::wcstof
• std::strtod, std::_tcstod, std::wcstod
• std::strtold, std::wcstold, std::_strtold, std::_tcstold, std::_wcstold
• std::strtol, std::_tcstol, std::wcstol
• std::strtoll, std::_tcstoll, std::wcstoll
• std::strtoul, std::_tcstoul, std::wcstoul
• std::strtoull, std::_tcstoull, std::wcstoull
• <cstdlib>

C++ Builder 參考手冊 ? System::Sysutils ? TryStrToCurr