C++ iomanip 庫 - put_time 函式

描述

此函式首先構造一個 basic_ostream::sentry 型別的物件來訪問輸出序列。然後（如果評估哨兵物件為真），它呼叫 time_put::put（使用流的選定區域設定）來執行格式化和插入操作，並相應地調整流的內部狀態標誌。最後，在返回之前銷燬哨兵物件。

它用於插入 tmb 指向的日期和時間資訊的表示形式，並根據引數 fmt 指定的格式進行格式化。

宣告

以下是 std::put_time 函式的宣告。

template <class charT>
/*unspecified*/ put_time (const struct tm* tmb, const charT* fmt);

引數

tmb − 指向 struct tm 型別物件的指標，其中包含要格式化的日期和時間資訊。struct tm 是在 <ctime> 標頭檔案中定義的類。

fmt − time_put::put 用作格式字串的 C 字串。它包含任意組合的常規字元和特殊格式說明符。這些格式說明符由函式替換為相應的數值，以表示 tmb 中指定的時間。

它們都以百分號 (%) 開頭，如下所示：

返回值

未指定。此函式應僅用作流運算子。

錯誤透過修改流的內部狀態標誌來發出訊號：

異常

基本保證 − 如果丟擲異常，則物件處於有效狀態。

如果結果錯誤狀態標誌不是 goodbit，並且成員異常被設定為為此狀態丟擲，則它會丟擲一個成員型別為 failure 的異常。

內部操作丟擲的任何異常都會被函式捕獲並處理，並設定 badbit。如果在上次呼叫 exceptions 時設定了 badbit，則該函式會重新丟擲捕獲的異常。

資料競爭

訪問 tmb 指向的物件和 fmt 指向的陣列。

修改插入它的流物件。

對同一流物件的併發訪問可能會導致資料競爭，除非標準流物件 (cout、cerr、clog、wcout、wcerr 和 wclog) 與 stdio 同步（在這種情況下，不會啟動資料競爭，儘管不保證來自多個執行緒的字元的插入順序）。

示例

下面的例子解釋了 put_time 函式。

#include <iostream>
#include <iomanip>
#include <ctime>
#include <chrono>

int main () {
   using std::chrono::system_clock;
   std::time_t tt = system_clock::to_time_t (system_clock::now());

   struct std::tm * ptm = std::localtime(&tt);
   std::cout << "Now (local time): " << std::put_time(ptm,"%c") << '\n';

   return 0;
}