名稱空間
變體
操作

std::experimental::ranges::SizedSentinel

來自 cppreference.com
< cpp‎ | experimental‎ | ranges
 
 
實驗性
技術規範
檔案系統庫 (檔案系統 TS)
庫基礎 (庫基礎 TS)
庫基礎 2 (庫基礎 TS v2)
庫基礎 3 (庫基礎 TS v3)
並行性擴充套件 (並行性 TS)
並行性擴充套件 2 (並行性 TS v2)
併發性擴充套件 (併發性 TS)
併發擴充套件 2 (併發 TS v2)
概念 (概念 TS)
範圍 (範圍 TS)
反射 (反射 TS)
數學特殊函式 (特殊函式 TR)
實驗性非 TS
模式匹配
線性代數
std::execution
契約
2D 圖形
 
 
迭代器庫
迭代器概念
間接可呼叫概念
                                                  
                                                  
                                                  
常用演算法要求
                                                  
概念工具
迭代器工具與操作
迭代器特徵
迭代器介面卡
流迭代器
 
定義於標頭檔案 <experimental/ranges/iterator>
template< class S, class I >

concept bool SizedSentinel =
    Sentinel<S, I> &&
    !ranges::disable_sized_sentinel<std::remove_cv_t<S>, std::remove_cv_t<I>> &&
    requires(const I& i, const S& s) {
        { s - i } -> Same<ranges::difference_type_t<I>>&&;
        { i - s } -> Same<ranges::difference_type_t<I>>&&;

    };
(1) (ranges TS)
template< class S, class I >
constexpr bool disable_sized_sentinel = false;
(1) (ranges TS)

SizedSentinel 概念規定,型別為 I 的迭代器物件和型別為 S 的哨兵物件可以相減,以常數時間計算它們之間的距離。

i 為型別為 I 的迭代器,s 為型別為 S 的哨兵,使得 [is) 表示一個範圍。令 N 為使 bool(i == s) 為 true 所需的 ++i 的最小應用次數。則 SizedSentinel<S, I> 僅在以下情況滿足:

  • 如果 N 可以由 ranges::difference_type_t<I> 表示,則 s - i 是定義良好的並等於 N;並且
  • 如果 -N 可以由 ranges::difference_type_t<I> 表示,則 i - s 是定義良好的並等於 -N

變數模板 disable_sized_sentinel 提供了一種機制,允許可以相減但不滿足 SizedSentinel 語義要求的迭代器和哨兵透過將變數模板特化為 true 值來選擇退出此概念。

[編輯] 相等性保留

如果一個表示式在給定相等輸入時產生相等輸出,則稱其為保持相等性

  • 表示式的輸入由其運算元組成。
  • 表示式的輸出由其結果以及被表示式修改的所有運算元(如果有的話)組成。

所有要求保持相等性的表示式還必須是穩定的:在沒有顯式介入修改輸入物件的情況下,對具有相同輸入物件的表示式的兩次求值必須產生相等的輸出。

除非另有說明,requires-expression 中使用的每個表示式都必須保持相等且穩定,並且表示式的評估只能修改其非常量運算元。常量運算元不得修改。

[編輯] 隱式表示式變體

如果一個 `requires-expression` 對某個常量左值運算元使用非修改表示式,它也會隱式地要求該表示式的其他變體,這些變體接受非常量左值或(可能是常量的)右值作為給定運算元,除非明確要求具有不同語義的此類表示式變體。這些 *隱式表示式變體* 必須滿足與宣告表示式相同的語義要求。實現驗證這些變體語法的程度是未指定的。