std::assignable_from

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

概念庫

核心語言概念 same_as (C++20) derived_from (C++20) convertible_to (C++20) common_reference_with (C++20) common_with (C++20) integral (C++20) signed_integral (C++20) unsigned_integral (C++20) floating_point (C++20) swappableswappable_with (C++20)(C++20) destructible (C++20) constructible_from (C++20) default_initializable (C++20)   move_constructible (C++20) copy_constructible (C++20) assignable_from (C++20)

比較概念 equality_comparableequality_comparable_with (C++20)(C++20) totally_orderedtotally_ordered_with (C++20)(C++20) 物件概念 movable (C++20) copyable (C++20) semiregular (C++20) regular (C++20) 可呼叫概念 invocableregular_invocable (C++20)(C++20) predicate (C++20) relation (C++20) equivalence_relation (C++20) strict_weak_order (C++20)

僅用於闡釋的概念 boolean-testable  (C++20)

 

定義於標頭檔案 <concepts>
template< class LHS, class RHS > concept assignable_from =     std::is_lvalue_reference_v<LHS> &&     std::common_reference_with<         const std::remove_reference_t<LHS>&,         const std::remove_reference_t<RHS>&> &&     requires(LHS lhs, RHS&& rhs) {         { lhs = std::forward<RHS>(rhs) } -> std::same_as<LHS>;     };		(C++20 起)

概念 assignable_from<LHS, RHS> 指定了型別和值類別由 RHS 指定的表示式可以賦值給型別由 LHS 指定的左值表示式。

語義要求

給定

• lhs，一個左值，引用物件 lcopy，使得 decltype((lhs)) 是 LHS，
• rhs，一個表示式，使得 decltype((rhs)) 是 RHS，
• rcopy，一個與 rhs 相等的不同物件，

assignable_from<LHS, RHS> 僅當滿足以下條件時才成立：

• std::addressof(lhs = rhs) == std::addressof(lcopy) (即，賦值表示式產生一個引用左運算元的左值)；
• 在評估 lhs = rhs 後
  • lhs 等於 rcopy，除非 rhs 是引用 lcopy 的非 const xvalue（即，賦值是自移動賦值），
  • 如果 rhs 是一個 glvalue
    • 如果它是一個非 const xvalue，它引用的物件處於有效但未指定的狀態；
    • 否則，它引用的物件未被修改；

相等性保持

標準庫概念的 requires 表示式中宣告的表示式必須是保持相等性的（除非另有說明）。

註記

賦值不必是一個全函式。特別是，如果將某個物件 x 賦值給另一個物件 y 可能導致 y 被修改，那麼 x = y 很可能不在 = 的定義域內。這通常發生在右運算元直接或間接由左運算元擁有時（例如，帶有基於節點的資料結構中節點的智慧指標，或類似 std::vector<std::any> 的情況）。

示例

執行此程式碼

#include <atomic>
#include <concepts>
#include <string>
 
int main()
{
    // Normal basic usage, checks lvalue reference assignment
    static_assert(std::is_assignable_v<int&, int>);
    static_assert(std::assignable_from<int&, int>);
 
    static_assert(std::is_assignable_v<std::string&, std::string>);
    static_assert(std::assignable_from<std::string&, std::string>);
 
    // Fundamental types don't support assignment to an rvalue
    static_assert(!std::is_assignable_v<int, int>);
    static_assert(!std::assignable_from<int, int>);
 
    // std::assignable_from doesn't accept all valid assignment expressions:
 
    // rvalue reference assignment
    static_assert(std::is_assignable_v<std::string&&, std::string>);
    static_assert(!std::assignable_from<std::string&&, std::string>);
 
    // rvalue assignment
    static_assert(std::is_assignable_v<std::string, std::string>);
    static_assert(!std::assignable_from<std::string, std::string>);
 
    // std::atomic::operator= returns by value
    static_assert(std::is_assignable_v<std::atomic<int>&, int>);
    static_assert(!std::assignable_from<std::atomic<int>&, int>);
}

參考文獻

• C++23 標準 (ISO/IEC 14882:2024)

• 18.4.8 概念 assignable_from [concept.assignable]

• C++20 標準 (ISO/IEC 14882:2020)

• 18.4.8 概念 assignable_from [concept.assignable]

參閱

is_assignableis_trivially_assignableis_nothrow_assignable (C++11)(C++11)(C++11)

檢查型別是否具有針對特定引數的賦值運算子 (類模板)