Boost Json Translation (zh_Hans)/Doc / Pages / Allocators / Storage Ptr (adoc) — Chinese (Simplified Han script) @ Boost-Weblate: Storage pointers constructed from a {ref_memory

Zen

Translation

English

Chinese (Simplified Han script)

Needs editing

Skip

	English	Chinese (Simplified Han script)	Actions
	= `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` 本库中的可变长度容器均使用动态分配的内存来存储其内容。调用方可通过在特定构造函数和函数参数列表中指定 <<ref_storage_ptr>> ，以控制所使用的内存分配策略。<<ref_storage_ptr>> 具有以下特性：</ref_storage_ptr></ref_storage_ptr>
	A storage pointer always points to a valid,	存储指针始终指向一个有效的、
	type-erased {ref_memory_resource}.	类型擦除后的 {ref_memory_resource}。
	Default-constructed storage pointers reference the	默认构造的存储指针引用
	<<default_memory_resource,default resource>>, an implementation-defined instance which always uses the equivalent of global operator new and delete.	<<default_memory_resource,default resource="">>（默认资源），这是一个由实现定义的实例，始终使用等效于全局 operator new 和 operator delete 的方式。</default_memory_resource,default>
	Storage pointers constructed from a {ref_memory_resource} or	从 {ref_memory_resource} 构造的存储指针，或
	{ref_polymorphic_allocator} do not acquire ownership; the caller is responsible for ensuring that the lifetime of the resource extends until it is no longer referenced.	从 {ref_polymorphic_allocator} 构造的存储指针，不获取所有权；调用方负责确保资源的生命周期持续到不再被引用为止。
	A storage pointer obtained from <<ref_make_shared_resource>> acquires shared	通过 <<ref_make_shared_resource>> 获取的存储指针会获得</ref_make_shared_resource>
	ownership of the memory resource; the lifetime of the resource is extended until all copies of the storage pointer are destroyed.	对内存资源的共享所有权；该资源的生命周期将延长，直至所有该存储指针的副本均被销毁。
	The storage pointer remembers the value of <<ref_is_deallocate_trivial>>	存储指针会记录 <<ref_is_deallocate_trivial>> 的值，</ref_is_deallocate_trivial>
	before type-erasing the resource, allowing the value to be queried at run-time.	（<> 值的记录是）在对资源进行类型擦除之前进行的,从而允许在运行时查询该值。
	This lists all of the allocation-related types and functions available when using the library:	此列表列出了在使用该库时可用的所有与分配相关的类型和函数：
	Name	Name
	Description	描述
	<<ref_get_null_resource>>	<>
	Returns a pointer to a memory resource instance which always throws an	返回一个指向内存资源实例的指针，该实例总是在
	exception upon allocation. This is used to to achieve the invariant that no parsing or container operation will dynamically allocate memory.	分配内存时抛出异常。此机制用于确保解析或容器操作不会进行动态内存分配，从而维持该不变性。
	<<ref_is_deallocate_trivial>>	<<ref_is_deallocate_trivial>></ref_is_deallocate_trivial>
	A customization point allowing a memory resource type to indicate that calls	一个自定义点，允许内存资源类型表明其
	to deallocate are trivial.	deallocate 的调用是平凡的。
	<<ref_make_shared_resource>>	<<ref_make_shared_resource>></ref_make_shared_resource>

	English	Chinese (Simplified Han script)	Actions
	Description	描述
	<<ref_get_null_resource>>	<>
	Resource Lifetime	资源生命周期
	It is important to note that <<ref_storage_ptr>> supports both shared-ownership and reference lifetime models. Construction from a memory resource pointer does not transfer ownership:	需要注意的是，<<ref_storage_ptr>> 同时支持共享所有权和引用生命周期模型。从内存资源指针构造时不会转移所有权：</ref_storage_ptr>
	to deallocate are trivial.	deallocate 的调用是平凡的。
	allocated memory resource.	分配的内存资源具有共享所有权。
	{ref_memory_resource}	{ref_memory_resource}
	<<ref_is_deallocate_trivial>>	<<ref_is_deallocate_trivial>></ref_is_deallocate_trivial>
	Monotonic Resource	单调资源
	{ref_polymorphic_allocator} do not acquire ownership; the caller is responsible for ensuring that the lifetime of the resource extends until it is no longer referenced.	从 {ref_polymorphic_allocator} 构造的存储指针，不获取所有权；调用方负责确保资源的生命周期持续到不再被引用为止。
	= `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` 本库中的可变长度容器均使用动态分配的内存来存储其内容。调用方可通过在特定构造函数和函数参数列表中指定 <<ref_storage_ptr>> ，以控制所使用的内存分配策略。<<ref_storage_ptr>> 具有以下特性：</ref_storage_ptr></ref_storage_ptr>
	A storage pointer always points to a valid,	存储指针始终指向一个有效的、
	type-erased {ref_memory_resource}.	类型擦除后的 {ref_memory_resource}。
	Default-constructed storage pointers reference the	默认构造的存储指针引用
	<<default_memory_resource,default resource>>, an implementation-defined instance which always uses the equivalent of global operator new and delete.	<<default_memory_resource,default resource="">>（默认资源），这是一个由实现定义的实例，始终使用等效于全局 operator new 和 operator delete 的方式。</default_memory_resource,default>
	Storage pointers constructed from a {ref_memory_resource} or	从 {ref_memory_resource} 构造的存储指针，或
	The default memory resource uses the global `operator new` and `operator delete` to allocate memory. This resource is not reference counted and has a non-trivial deallocate function. All default-constructed <<ref_storage_ptr>> objects reference the same memory resource:	默认内存资源使用全局 `operator new` 和 `operator delete` 来进行内存分配。该资源不采用引用计数，且其 deallocate 函数是非平凡的。所有默认构造的 <<ref_storage_ptr>> 对象均引用同一个内存资源：</ref_storage_ptr>
	Default-constructed library containers use the default memory resource:	默认构造的库容器使用默认内存资源：
	The default memory resource is well suited for general usage. It offers reasonable performance for parsing, and conservative memory usage for modification of the contents of containers.	默认内存资源适用于一般用途。它在解析时提供合理的性能，在修改容器内容时则具有保守的内存使用特性。
	This memory resource is not guaranteed to be the same as the result of `boost::container::pmr::get_default_resource`. It also cannot be changed with `boost::container::pmr::set_default_resource`.	该内存资源不保证与 `boost::container::pmr::get_default_resource` 的返回结果相同，也无法通过 `boost::container::pmr::set_default_resource` 进行更改。
	Consider the pattern of memory allocation during parsing: when an array, object, or string is encountered the parser accumulates elements in its temporary storage area. When all of the elements are known, a single memory allocation is requested from the resource when constructing the value. Thus, parsing only allocates and constructs containers at their final size. Memory is not reallocated; that is, a memory buffer never needs to grow by allocating a new larger buffer and deallocating the previous buffer.	考虑解析过程中的内存分配模式：当遇到数组、对象或字符串时，解析器会将其元素累积在临时存储区中。当所有元素都已知后，在构造值时会向内存资源发起一次内存分配请求。因此，解析过程仅在容器最终大小确定时进行一次分配和构造，不会发生内存重分配；也就是说，内存缓冲区无需通过分配更大的新缓冲区并释放旧缓冲区的方式来扩容。
	The <<ref_monotonic_resource>> optimizes this memory allocation pattern by allocating increasingly large blocks of global memory internally and parceling those blocks out in smaller pieces to fulfill allocation requests. It has a trivial deallocate function. The monotonic resource does not actually deallocate memory until the resource is destroyed. Thus, it is ideally suited for the use-case where JSON is parsed, and the resulting value is then inspected but not modified.	<<ref_monotonic_resource>> 通过在内部分配逐渐增大的全局内存块，并将这些块切分为更小的部分以满足分配请求，从而优化了该内存分配模式。它具有平凡的 deallocate 函数，实际上不会释放内存，直到该资源被销毁。因此，它非常适合用于解析 JSON 后仅检查结果值而不对其进行修改的场景。</ref_monotonic_resource>
	The resource to use when constructing values may be specified in calls to <<ref_parse>> as shown here:	在调用 <<ref_parse>> 时，可按如下方式指定构造值所使用的内存资源：</ref_parse>
	Or, to parse into a value with shared ownership of the memory resource:	或者，可按如下方式解析到一个对内存资源具有共享所有权的值：
	A monotonic resource may be optionally constructed with an initial buffer to use first, before going to the heap. This allows the caller to use stack space and avoid dynamic allocations for most parsed JSON, falling back to dynamic allocation from the heap if the input JSON is larger than average, as shown here:	单调资源在构造时可选择性地指定一个初始缓冲区，优先使用该缓冲区，之后才会转而使用堆内存。这使得调用方可以利用栈空间，避免对大多数 JSON 解析进行动态分配；仅当输入的 JSON 大于平均水平时，才会退回到从堆中进行动态分配，如下所示：
	Static Resource	静态资源
	A <<ref_static_resource>> constructs from a caller-provided buffer, and satisfies all memory allocation requests from the buffer. Once the buffer is exhausted, subsequent calls to allocate throw the exception `std::bad_alloc`. The resource offers a simple invariant: dynamic heap allocations are never performed.	<<ref_static_resource>> 由调用方提供的缓冲区构造而成，并从该缓冲区满足所有内存分配请求。一旦缓冲区耗尽，后续的分配调用将抛出 `std::bad_alloc` 异常。该资源提供一个简单的不变式：永不执行动态堆分配。</ref_static_resource>
	To use the resource, construct it with a local buffer:	要使用该资源，请用一个局部缓冲区对其进行构造：
	Null Resource	空资源
	The function <<ref_get_null_resource>> returns a global instance of the null resource. This resource offers a simple invariant: all calls to allocate will throw the exception `std::bad_alloc`. An instance of the null resource can be used to make parsing guarantee that allocations from the heap are never made. This is explored in more detail in a later section.	函数 <<ref_get_null_resource>> 返回一个全局的空资源实例。该资源提供一个简单的不变式：所有内存分配调用都会抛出 `std::bad_alloc` 异常。通过使用空资源实例，可确保解析过程绝不会进行堆内存分配。这一点将在后文进一步详细说明。</ref_get_null_resource>

Loading…

admin

Translation uploaded

English

Chinese (Simplified Han script) 44 characters editedCurrent translationState: Translated

06/05/2026

admin

String added in the repository

English

Chinese (Simplified Han script) 60 characters editedPrevious translationState: Needs editing (Needs rewriting)

06/05/2026

Browse all string changes

Glossary

English	Chinese (Simplified Han script)
No related strings found in the glossary.

String information

Flags

safe-html, strict-same

Unit identifier

42685

Source string location

:24

String age

06/05/2026

Last updated

06/06/2026

Source string age

06/05/2026

Translation file AsciiDoc file

doc/pages/allocators/storage_ptr_zh_Hans.adoc, string 6

Shortcut	Action
`?`	Open available keyboard shortcuts.
`Alt` + `Home`	Navigate to the first translation in the current search.
`Alt` + `End`	Navigate to the last translation in the current search.
`Alt` + `PageUp` or `Ctrl` + `↑` or `Alt` + `↑` or `Cmd` + `↑` or	Navigate to the previous translation in the current search.
`Alt` + `PageDown` or `Ctrl` + `↓` or `Alt` + `↓` or `Cmd` + `↓` or	Navigate to the next translation in the current search.
`Ctrl` + `Enter` or `Cmd` + `Enter`	Submit current form; this works the same as pressing Save and continue while editing translation.
`Ctrl` + `Shift` + `Enter` or `Cmd` + `Shift` +`Enter`	Unmark translation as Needing edit and submit it.
`Alt` + `Enter` or `Option` + `Enter`	Submit the string as a suggestion; this works the same as pressing Suggest while editing translation.
`Ctrl` + `E` or `Cmd` + `E`	Focus on translation editor.
`Ctrl` + `U` or `Cmd` + `U`	Focus on comment editor.
`Ctrl` + `M` or `Cmd` + `M`	Shows Automatic suggestions tab.
`Ctrl` + `1` to `Ctrl` + `9` or `Cmd` + `1` to `Cmd` + `9`	Copies placeable of a given number from source string.
`Ctrl` + `M` followed by `1` to `9` or `Cmd` + `M` followed by `1` to `9`	Copy the machine translation of a given number to current translation.
`Ctrl` + `I` followed by `1` to `9` or `Cmd` + `I` followed by `1` to `9`	Ignore one item in the list of failing checks.
`Ctrl` + `J` or `Cmd` + `J`	Shows the Nearby strings tab.
`Ctrl` + `S` or `Cmd` + `S`	Focus on search field.
`Ctrl` + `O` or `Cmd` + `O`	Copy the source string.
`Ctrl` + `Y` or `Cmd` + `Y`	Toggle the Needs editing checkbox.
`→`	Browse the next translation string.
`←`	Browse the previous translation string.

Translation

Glossary

String information

Flags

Details

Unit identifier

Source string location

String age

Last updated

Source string age

Translation file AsciiDoc file