查看“︁cpp/coroutine/generator”︁的源代码

因为以下原因，您没有权限编辑该页面：

您请求的操作仅限属于这些用户组的用户执行：用户、管理员

您可以查看和复制此页面的源代码。

{{cpp/title|generator}}
{{cpp/coroutine/generator/navbar}}
{{dcl begin}}
{{dcl header|generator}}
{{dcl|num=1|since=c++23|1=
template<
    class Ref,
    class V = void,
    class Allocator = void >
class generator
    : public ranges::view_interface<generator<Ref, V, Allocator>>
}}
{{dcl|num=2|since=c++23|1=
namespace pmr {
    template< class Ref, class V = void >
    using generator =
        std::generator<Ref, V, std::pmr::polymorphic_allocator<>>;
}
}}
{{dcl end}}

@1@ 类模板 {{tt|std::generator}} 表示对{{lt|cpp/language/coroutines|协程}}求值返回的元素的 {{lconcept|view}}。

@2@ 为使用{{lt|cpp/memory/polymorphic allocator|多态分配器}}的 {{tt|generator}} 提供的便利别名模板。

{{tt|std::generator}} 通过反复恢复可返回值的协程以生成元素的序列。
每当 {{c/core|co_yield}} 语句被求值，协程就产生序列的一个元素。
当 {{c/core|co_yield}} 语句具有形式 {{c|co_yield ranges::elements_of(rng)}} 时，{{lconcept|range}} {{c|rng}} 中的每个元素作为序列的一个元素被依次生成。

{{tt|std::generator}} 实现 {{lconcept|view}} 及 {{lconcept|input_range}}。

为 {{tt|std::generator}} 添加特化的程序行为未定义。

===模板形参===
{{par begin}}
{{par|Ref|生成器的引用类型（{{lc|ranges::range_reference_t}}）。如果 {{tt|V}} 是 {{c/core|void}}，则值类型和引用类型均从 {{tt|Ref}} 推导}}
{{par|V|生成器的值类型（{{lc|ranges::range_value_t}}），或者为 {{c/core|void}}}}
{{par|Allocator|分配器类型或者 {{c/core|void}}}}
{{par end}}

若 {{tt|Allocator}} 不是 {{c/core|void}}，则当 {{tt|Allocator}} 不满足{{named req|Allocator}}的要求时其行为未定义。

===成员类型===
{{dsc begin}}
{{dsc hitem|成员|定义}}
{{dsc expos mem type|value|private=yes|{{c/core|std::conditional_t<std::is_void_v<V>, std::remove_cvref_t<{{void}}Ref>, V>;}}}}
{{dsc expos mem type|reference|private=yes|{{c/core|std::conditional_t<std::is_void_v<V>, Ref&&, Ref>;}}}}
{{dsc|{{anchor|yielded}}{{tt|yielded}}|{{box/core|{{c/core|std::conditional_t<std::is_reference_v<}}{{tti|reference}}{{sep}}{{c/core|>,}}{{nbspt|1}}{{tti|reference}}{{c/core|, const}}{{nbspt|1}}{{tti|reference}}{{sep}}{{c/core|&>}}}}}}
{{dsc end}}

{{par begin}}
{{par hreq}}
{{par req|{{c/core|std::allocator_traits<Allocator>::pointer}} 是指针类型。}}
{{par req|{{tti|value}} 是无 cv 限定的对象类型。}}
{{par req|{{tti|reference}} 是引用类型或者无 cv 限定的实现 {{lconcept|copy_constructible}} 的对象类型。}}
{{par req|令 {{tti|RRef}} 表示：{{box/core|{{c/core|std::remove_reference_t<}}{{tti|reference}}{{sep}}{{c/core|>&&}}}}，若 {{tti|reference}} 是引用类型，否则是 {{tti|reference}}。
* 实现 {{box/core|{{c/core|std::common_reference_with<}}{{tti|reference}}{{sep}}{{c/core|&&,}}{{nbspt|1}}{{tti|value}}{{sep}}{{c/core|&>}}}}。
* 实现 {{box/core|{{c/core|std::common_reference_with<}}{{tti|reference}}{{sep}}{{c/core|&&,}}{{nbspt|1}}{{tti|RRef}}{{sep}}{{c/core|&&>}}}}。
* 实现 {{box/core|{{c/core|std::common_reference_with<}}{{tti|RRef}}{{sep}}{{c/core|&&, const}}{{nbspt|1}}{{tti|value}}{{sep}}{{c/core|&>}}}}。
}}
{{par end}}

若这些类型规定中有任何一个未能满足，则程序非良构。

===数据成员===
{{dsc begin}}
{{dsc hitem|成员|定义}}
{{dsc expos mem obj|active_|id=active|private=yes|
每个 {{tt|std::generator}} 的活动实例内部都关联一个栈（如同以类型 {{c/core|std::unique_ptr<std::stack<std::coroutine_handle<>>> 的对象持有}}）。
* 当调用 {{rlt|begin}} 时，建立新栈且将该生成器加入到这个栈中。
* 当 {{c|co_yield ranges::elements_of(rng)}} 语句在生成器体中求值时，将 {{c|rng}} 转换为生成器且加入到包含外围生成器的栈中。
* 当生成器的迭代器{{rl|iterator#自增|自增}}时，恢复关联栈栈顶的协程。
* 当生成器完成时 (也就是 {{l2tt|cpp/coroutine/generator/promise_type/final_suspend}} 被调用时)，从此栈中移除它。}}
{{dsc expos mem obj|coroutine_|id=coroutine|private=yes|{{c/core|std::coroutine_handle<promise_type>}} 类型的句柄}}
{{dsc end}}

===成员函数===
{{dsc begin}}
{{dsc inc|cpp/coroutine/generator/dsc constructor}}
{{dsc inc|cpp/coroutine/generator/dsc destructor}}
{{dsc inc|cpp/coroutine/generator/dsc operator{{=}}}}
{{dsc inc|cpp/coroutine/generator/dsc begin}}
{{dsc inc|cpp/coroutine/generator/dsc end}}
{{cpp/ranges/view_interface/inherit|embedded=yes|front=invalid|back=invalid|data=invalid|size=invalid|operator[]=invalid}}
{{dsc end}}

===嵌套类===
{{dsc begin}}
{{dsc mem class|cpp/coroutine/generator/promise_type|承诺类型}}
{{dsc expos mem class|cpp/coroutine/generator/iterator|迭代器类型}}
{{dsc end}}

===注解===
{{feature test macro|value=202207L|std=C++23|__cpp_lib_generator|{{ttt|std::generator}} &ndash; 适用于{{lt|cpp/ranges|范围}}的同步{{rlp|/|协程}}生成器}}

===示例===
{{example
|code=
#include <generator>
#include <iostream>

template<typename T>
struct Tree
{
    T value;
    Tree *left{}, *right{};

    std::generator<const T&> traverse_inorder() const
    {
        if (left)
            co_yield std::ranges::elements_of(left->traverse_inorder());

        co_yield value;

        if (right)
            co_yield std::ranges::elements_of(right->traverse_inorder());
    }
};

int main()
{
    Tree<char> tree[]
    {
                                    {'D', tree + 1, tree + 2},
        //                            │
        //            ┌───────────────┴────────────────┐
        //            │                                │
                    {'B', tree + 3, tree + 4},       {'F', tree + 5, tree + 6},
        //            │                                │
        //  ┌─────────┴─────────────┐      ┌───────────┴─────────────┐
        //  │                       │      │                         │
          {'A'},                  {'C'}, {'E'},                    {'G'}
    };

    for (char x : tree->traverse_inorder())
        std::cout << x << ' ';
    std::cout << '\n';
}
|output=
A B C D E F G
}}

===引用===
{{ref std c++23}}
{{ref std|title=Range generators|id=coro.generator|section=26.8}}
{{ref std end}}

===参阅===
{{dsc begin}}
{{dsc inc|cpp/coroutine/dsc noop_coroutine}}
{{dsc end}}

{{langlinks|en|es|ja|ru}}

该页面使用的模板：

Template:!（查看源代码）
Template:=（查看源代码）
Template:anchor（查看源代码）
Template:box/core（查看源代码）
Template:c（查看源代码）
Template:c/core（查看源代码）
Template:cpp/coroutine/dsc noop coroutine（查看源代码）
Template:cpp/coroutine/generator/dsc begin（查看源代码）
Template:cpp/coroutine/generator/dsc constructor（查看源代码）
Template:cpp/coroutine/generator/dsc destructor（查看源代码）
Template:cpp/coroutine/generator/dsc end（查看源代码）
Template:cpp/coroutine/generator/dsc operator=（查看源代码）
Template:cpp/coroutine/generator/navbar（查看源代码）
Template:cpp/coroutine/generator/navbar content（查看源代码）
Template:cpp/coroutine/generator/navbar heading（查看源代码）
Template:cpp/coroutine/navbar content（查看源代码）
Template:cpp/coroutine/navbar heading（查看源代码）
Template:cpp/navbar content（查看源代码）
Template:cpp/navbar heading（查看源代码）
Template:cpp/ranges/navbar content（查看源代码）
Template:cpp/ranges/navbar heading（查看源代码）
Template:cpp/ranges/title（查看源代码）
Template:cpp/ranges/view interface/dsc cbegin（查看源代码）
Template:cpp/ranges/view interface/dsc cend（查看源代码）
Template:cpp/ranges/view interface/dsc empty（查看源代码）
Template:cpp/ranges/view interface/dsc operator bool（查看源代码）
Template:cpp/ranges/view interface/inherit（查看源代码）
Template:cpp/ranges/view interface/mem fun list（查看源代码）
Template:cpp/ranges/view interface/title（查看源代码）
Template:cpp/title（查看源代码）
Template:cpp/utility/navbar content（查看源代码）
Template:cpp/utility/navbar heading（查看源代码）
Template:ctitle（查看源代码）
Template:dcl（查看源代码）
Template:dcl/std（查看源代码）
Template:dcl begin（查看源代码）
Template:dcl end（查看源代码）
Template:dcl header（查看源代码）
Template:dcl sep（查看源代码）
Template:dsc（查看源代码）
Template:dsc begin（查看源代码）
Template:dsc editlink（查看源代码）
Template:dsc end（查看源代码）
Template:dsc expos mem class（查看源代码）
Template:dsc expos mem obj（查看源代码）
Template:dsc expos mem type（查看源代码）
Template:dsc expos member（查看源代码）
Template:dsc fun（查看源代码）
Template:dsc guard（查看源代码）
Template:dsc h2（查看源代码）
Template:dsc header/link（查看源代码）
Template:dsc hitem（查看源代码）
Template:dsc inc（查看源代码）
Template:dsc mark mem（查看源代码）
Template:dsc mem class（查看源代码）
Template:dsc mem ctor（查看源代码）
Template:dsc mem dtor（查看源代码）
Template:dsc mem fun（查看源代码）
Template:dsc member（查看源代码）
Template:dsc small（查看源代码）
Template:example（查看源代码）
Template:feature test macro（查看源代码）
Template:ftm link（查看源代码）
Template:get lang（查看源代码）
Template:l2tt（查看源代码）
Template:l2tt/core（查看源代码）
Template:langlinks（查看源代码）
Template:langlinks/one（查看源代码）
Template:lc（查看源代码）
Template:lconcept（查看源代码）
Template:lconcept/cat（查看源代码）
Template:lconcept/pg（查看源代码）
Template:lconcept/title（查看源代码）
Template:lines（查看源代码）
Template:ls（查看源代码）
Template:lt（查看源代码）
Template:ltt/core（查看源代码）
Template:ltt std（查看源代码）
Template:mark（查看源代码）
Template:mark c++11（查看源代码）
Template:mark c++14（查看源代码）
Template:mark c++17（查看源代码）
Template:mark c++20（查看源代码）
Template:mark c++23（查看源代码）
Template:mark c++26（查看源代码）
Template:mark deprecated c++20（查看源代码）
Template:mark expos/core（查看源代码）
Template:mark expos mem class（查看源代码）
Template:mark expos mem obj（查看源代码）
Template:mark expos mem type（查看源代码）
Template:mark fun（查看源代码）
Template:mark mem class（查看源代码）
Template:mark mem fun（查看源代码）
Template:mark rev（查看源代码）
Template:mark since c++23（查看源代码）
Template:mark tooltip（查看源代码）
Template:mark until c++23（查看源代码）
Template:named req（查看源代码）
Template:named req/core（查看源代码）
Template:named req/legacy map（查看源代码）
Template:named req/translate（查看源代码）
Template:navbar（查看源代码）
Template:navbar editlink（查看源代码）
Template:nbsp（查看源代码）
Template:nbspt（查看源代码）
Template:nv（查看源代码）
Template:nv begin（查看源代码）
Template:nv col begin（查看源代码）
Template:nv col end（查看源代码）
Template:nv col next（查看源代码）
Template:nv end（查看源代码）
Template:nv h1（查看源代码）
Template:nv h2（查看源代码）
Template:nv ln（查看源代码）
Template:nv mem ln（查看源代码）
Template:nv ph（查看源代码）
Template:par（查看源代码）
Template:par begin（查看源代码）
Template:par end（查看源代码）
Template:par hreq（查看源代码）
Template:par req（查看源代码）
Template:ref std（查看源代码）
Template:ref std c++23（查看源代码）
Template:ref std end（查看源代码）
Template:rl（查看源代码）
Template:rlp（查看源代码）
Template:rlt（查看源代码）
Template:sep（查看源代码）
Template:small（查看源代码）
Template:source（查看源代码）
Template:title（查看源代码）（受保护）
Template:tooltip（查看源代码）
Template:trim（查看源代码）
Template:tt（查看源代码）
Template:tti（查看源代码）
Template:ttt（查看源代码）
Template:void（查看源代码）

返回cpp/coroutine/generator。

cppreference.com

搜索

命名空间

语言变体

查看

操作

查看“︁cpp/coroutine/generator”︁的源代码

导航

工具