User avatar admin

Translation uploaded
= `storage_ptr` Variable-length containers in this library all use dynamically allocated memory to store their contents. Callers can gain control over the strategy used for allocation by specifying a <<ref_storage_ptr>> in select constructors and function parameter lists. A <<ref_storage_ptr>> has these properties:
= `storage_ptr` Variable-length containers in this library all use dynamically allocated memory to store their contents. Callers can gain control over the strategy used for allocation by specifying a <<ref_storage_ptr>> in select constructors and function parameter lists. A <<ref_storage_ptr>> has these properties:本库中的可变长度容器均使用动态分配的内存来存储其内容。调用方可通过在特定构造函数和函数参数列表中指定 &lt;<ref_storage_ptr>&gt; ，以控制所使用的内存分配策略。&lt;<ref_storage_ptr>&gt; 具有以下特性：</ref_storage_ptr></ref_storage_ptr>
06/05/2026
User avatar admin

File uploaded
Processed 5 strings from the uploaded files (skipped: 0, not found: 0, updated: 5).
File upload mode: Add as translation 06/05/2026
User avatar admin

Translation uploaded
:leveloffset: -1
:leveloffset: -1
06/05/2026
User avatar admin

Translation uploaded
include::background.adoc[] include::storage_ptr.adoc[] include::uses_allocator.adoc[]
include::background.adoc[] include::storage_ptr.adoc[] include::uses_allocator.adoc[]
06/05/2026
User avatar admin

Translation uploaded
:leveloffset: +1
:leveloffset: +1
06/05/2026
User avatar admin

Translation uploaded
Here we discuss the various allocator models used in the C++ standard, followed by an explanation of the model used in this library and its benefits. Finally we discuss how the library interoperates with existing code that uses polymorphic allocators.
Here we discuss the various allocator models used in the C++ standard, followed by an explanation of the model used in this library and its benefits. Finally we discuss how the library interoperates with existing code that uses polymorphic allocators.本文将首先讨论C++标准中使用的各种分配器模型，随后介绍本库所采用的模型及其优势，最后说明该库如何与使用多态分配器的现有代码进行互操作。
06/05/2026
User avatar admin

Translation uploaded
= Allocators
= Allocators分配器
06/05/2026
User avatar admin

File uploaded
Processed 23 strings from the uploaded files (skipped: 0, not found: 0, updated: 23).
File upload mode: Add as translation 06/05/2026
User avatar admin

Translation uploaded
Boost.JSON solves this problem by introducing a new smart pointer called <<ref_storage_ptr>> which builds upon {cpp}17's memory allocation interfaces, accomplishing the goals above. As a result, libraries which use this type compose more easily and enjoy faster compilation, as member functions for containers which use the type can be defined out-of-line.
Boost.JSON solves this problem by introducing a new smart pointer called <<ref_storage_ptr>> which builds upon {cpp}17's memory allocation interfaces, accomplishing the goals above. As a result, libraries which use this type compose more easily and enjoy faster compilation, as member functions for containers which use the type can be defined out-of-line.通过引入一个名为&lt;<ref_storage_ptr>&gt; 的新型智能指针解决此问题，该指针基于{cpp}17的内存分配接口构建，实现了上述目标。因此，使用该类型的库更易于组合，并能获得更快的编译速度，因为使用该类型的容器的成员函数可以定义在类外（out-of-line）。</ref_storage_ptr>
06/05/2026
User avatar admin

Translation uploaded
`T` interoperates with code already using `std::pmr`
`T` interoperates with code already using 能与已使用`std::pmr`的代码互操作
06/05/2026
User avatar admin

Translation uploaded
`T` supports both reference semantics or shared ownership
`T` supports both reference semantics or shared ownership同时支持引用语义和共享所有权
06/05/2026
User avatar admin

Translation uploaded
`T` references a {ref_memory_resource}
`T` references a引用一个 {ref_memory_resource}
06/05/2026
User avatar admin

Translation uploaded
`T` is not a class template
`T` is not a class template不是类模板
06/05/2026
User avatar admin

Translation uploaded
We would like an allocator model using a single type `T` with the following properties:
We would like an allocator model using a single type `T` with the following properties:我们希望采用一种使用单一类型`T`的分配器模型，该模型具有以下特性：
06/05/2026
User avatar admin

Translation uploaded
Problem Statement
Problem Statement问题陈述
06/05/2026
User avatar admin

Translation uploaded
Workarounds for this problem are worse than the problem itself. The library could return a pair with the vector and `std::unique_ptr<std::pmr::memory_resource>` which the caller must manage. Or the library could change its function signatures to accept a {ref_memory_resource}``*`` provided by the caller, where the library also makes public the desired memory resources (`my_resource` above).
Workarounds for this problem are worse than the problem itself. The library could return a pair with the针对此问题的变通方案往往比问题本身更糟糕。该库可以返回一个包含 vector and 和`std::unique_ptr<std::pmr::memory_resource>` which the caller must manage. Or the library could change its function signatures to accept a {ref_memory_resource}``*`` provided by the caller, where the library also makes public the desired memory resources (`my_resource` above).的pair，必须由调用方自行管理。或者，该库也可以修改其函数签名，接受调用方提供的{ref_memory_resource}``*``，同时将所需的内存资源（如上文的`my_resource`）公开。</std::pmr::memory_resource>
06/05/2026
User avatar admin

Translation uploaded
This can be worked around by declaring the container to use a custom allocator (perhaps using a `std::shared_ptr< std::pmr::memory_resource >` as a data member). This hinders library composition; every library now exports unique, incompatible container types. A raw memory resource pointer is also easy to misuse:
This can be worked around by declaring the container to use a custom allocator (perhaps using a 可通过声明容器使用自定义分配器（可能使用`std::shared_ptr<&lt; std::pmr::memory_resource >` as a data member). This hinders library composition; every library now exports unique, incompatible container types. A raw memory resource pointer is also easy to misuse:&gt;`作为数据成员）来解决此问题。这会阻碍库的组合；每个库都会导出各自独特且互不兼容的容器类型。原始内存资源指针也容易被误用：
06/05/2026
User avatar admin

Translation uploaded
However, sometimes shared ownership is needed. Specifically, that the lifetime extension of the memory resource should be automatic. For example, if a library wants to return a container which owns an instance of the library's custom memory resource as shown below:
However, sometimes shared ownership is needed. Specifically, that the lifetime extension of the memory resource should be automatic. For example, if a library wants to return a container which owns an instance of the library's custom memory resource as shown below:然而，有时需要共享所有权，即内存资源的生命周期应自动延长。例如，若某个库希望返回一个容器，该容器拥有该库自定义内存资源的实例，如下所示：
06/05/2026
User avatar admin

Translation uploaded
The memory resource is passed by pointer; ownership is not transferred. The caller is responsible for extending the lifetime of the memory resource until the last container which is using it goes out of scope, otherwise the behavior is undefined. Sometimes this is the correct model, such as in this example which uses a monotonic resource constructed from a local stack buffer:
The memory resource is passed by pointer; ownership is not transferred. The caller is responsible for extending the lifetime of the memory resource until the last container which is using it goes out of scope, otherwise the behavior is undefined. Sometimes this is the correct model, such as in this example which uses a monotonic resource constructed from a local stack buffer:内存资源通过指针传递；所有权不发生转移。调用方需负责确保该内存资源的生命周期持续到所有使用它的容器都离开作用域为止，否则行为未定义。在某些场景下，这种模型是合适的，例如以下示例中使用了一个基于局部栈缓冲区构造的单调内存资源：
06/05/2026
User avatar admin

Translation uploaded
A polymorphic allocator constructs with a pointer to a memory resource:
A polymorphic allocator constructs with a pointer to a memory resource:多态分配器通过一个指向内存资源的指针进行构造：
06/05/2026

Search