Boost Beast Translation (zh_Hans)/Doc / Qbk / 04 Http / 08 Chunked Encoding (qbk) — Chinese (Simplified Han script) @ Boost-Weblate: Set a callback to be invoked on chunk body data. …

Zen

Translation

Source string description

type: table cell

English

Chinese (Simplified Han script)

Needs editing

Skip

Key	English	Chinese (Simplified Han script)
	This example demonstrates sending a complete chunked message payload manually. No chunk extensions or trailers are emitted:	本示例演示如何手动发送完整的分块消息有效载荷，过程中不发送分块扩展或尾部字段：
	The following code sends additional chunks, and sets chunk extensions using the helper container. The container automatically quotes values in the serialized output when necessary:	以下代码发送额外的分块，并使用辅助容器设置分块扩展。该容器在必要时会自动对序列化输出中的值进行引号处理：
	Callers can take over the generation and management of the extensions buffer by passing a non-owning string. Note that this requires the string contents to adhere to the correct syntax for chunk extensions, including the needed double quotes for values which contain spaces:	调用方可以通过传递一个非拥有字符串来接管扩展缓冲区的生成和管理。需要注意的是，这要求字符串内容符合分块扩展的正确语法，包括对包含空格的字段值使用必要的双引号：
	The next code sample emits a chunked response which promises two trailer fields and delivers them in the last chunk. The implementation allocates memory using the default or a passed-in allocator to hold the state information required to serialize the trailer:	以下代码示例发送一个分块响应，该响应承诺携带两个尾部字段，并在最后分块中发送这些字段。实现会使用默认分配器或传入的分配器分配内存，用于保存序列化尾部所需的状态信息：
	Using a custom allocator to serialize the last chunk:	使用自定义分配器序列化最后分块：
	Alternatively, callers can take over the generation and lifetime management of the serialized trailer fields by passing in a non-owning string:	或者，调用方也可以传入一个非拥有字符串，自行负责序列化尾部字段的生成及其生命周期管理：
	For the ultimate level of control, a caller can manually compose the chunk itself by first emitting a header with the correct chunk body size, and then by emitting the chunk body in multiple calls to the stream write function. In this case the caller is responsible for also emitting the terminating CRLF (`"\r\n"`):	若需要最高级别的控制，调用方可以手动组合分块：先发送一个带有正确分块体大小的头部，然后通过多次调用流写入函数来发送分块体。此时，调用方还需负责发送终止的 CRLF（`"\r\n"`）：
	Parsing Chunks	解析分块
	The __parser__ automatically removes the chunked transfer coding when it is the last encoding in the list. However, it also discards the chunk extensions and does not provide a way to determine the boundaries between chunks. Advanced applications which need to access the chunk extensions or read complete individual chunks may use a callback interface provided by __parser__:	当分块传输编码位于编码列表的末尾时，__parser__ 会自动将其移除。但在此过程中，解析器会丢弃分块扩展，也不提供确定分块之间边界的方法。对于需要访问分块扩展或读取完整分块的高级应用，可以使用 __parser__ 提供的回调接口：
	Chunking Parse Callbacks	分块解析回调接口
158	Name	名称
158	Description	描述
	[link beast.ref.boost__beast__http__parser.on_chunk_header `on_chunk_header`]	[link beast.ref.boost__beast__http__parser.on_chunk_header `on_chunk_header`]
	Set a callback to be invoked on each chunk header. The callback will be invoked once for every chunk in the message payload, as well as once for the last chunk. The invocation happens after the chunk header is available but before any body octets have been parsed. The extensions are provided in raw, validated form, use [link beast.ref.boost__beast__http__basic_chunk_extensions.parse `chunk_extensions::parse`] to parse the extensions into a structured container for easier access. The implementation type-erases the callback without requiring a dynamic allocation. For this reason, the callback object is passed by a non-constant reference. The function object will be called with this equivalent signature:	设置一个回调函数，在每次解析分块头部时调用。该回调函数会对消息体中的每个分块调用一次，同时对最后一个分块也调用一次。调用时机在分块头部可用之后、分块体数据开始解析之前。分块扩展以原始格式提供，且已经过验证。可以使用 [link beast.ref.boost__beast__http__basic_chunk_extensions.parse `chunk_extensions::parse`] 将扩展解析为结构化容器，便于访问。该实现通过类型擦除处理回调，且无需动态分配内存，因此回调对象通过非常量引用传递。回调函数对象的调用签名等效于：
	[link beast.ref.boost__beast__http__parser.on_chunk_body `on_chunk_body`]	[link beast.ref.boost__beast__http__parser.on_chunk_body `on_chunk_body`]
	Set a callback to be invoked on chunk body data. The callback will be invoked one or more times to provide buffers corresponding to the chunk body for the current chunk. The callback receives the number of octets remaining in this chunk body including the octets in the buffer provided. The callback must return the number of octets actually consumed. Any octets not consumed will be presented again in a subsequent invocation of the callback. The implementation type-erases the callback without requiring a dynamic allocation. For this reason, the callback object is passed by a non-constant reference. The function object will be called with this equivalent signature:	设置一个回调函数，在分块体数据到达时调用。该回调函数会被调用一次或多次，用于提供当前分块体对应的缓冲区数据。回调函数会收到当前分块体中剩余的字节数（包含当前缓冲区中的字节）。回调函数必须返回实际消耗的字节数。未被消耗的字节会在后续回调调用中再次提供。该实现通过类型擦除处理回调，且无需动态分配内存，因此回调对象通过非常量引用传递。回调函数对象的调用签名等效于：
	This example will read a message header from the stream, and then manually read each chunk. It recognizes the chunk boundaries and outputs the contents of each chunk as it comes in. Any chunk extensions are printed, each extension on its own line. Finally, any trailers promised in the header are printed.	本示例将从流中读取消息头部，然后手动读取每个分块。示例能够识别分块边界，并在分块到达时输出其内容。所有分块扩展都会被打印，每个扩展单独占一行。最后，还会打印头部中承诺的尾部字段。
	Given the HTTP response as input on the left, the output of the function shown above is shown on the right:	给定左侧的 HTTP 响应作为输入，上述函数的输出结果如右侧所示：
	Chunk Parsing Example Output	分块解析示例输出
	Input	输入
	Output	输出
	HTTP/1.1 200 OK\r\n Server: test\r\n Trailer: Expires, Content-MD5\r\n Transfer-Encoding: chunked\r\n \r\n 5\r\n First\r\n d;quality=1.0\r\n Hello, world!\r\n e;file=abc.txt;quality=0.7\r\n The Next Chunk\r\n 8;last\r\n Last one\r\n 0\r\n Expires: never\r\n Content-MD5: f4a5c16584f03d90\r\n \r\n	HTTP/1.1 200 OK\r\n Server: test\r\n Trailer: Expires, Content-MD5\r\n Transfer-Encoding: chunked\r\n \r\n 5\r\n First\r\n d;quality=1.0\r\n Hello, world!\r\n e;file=abc.txt;quality=0.7\r\n The Next Chunk\r\n 8;last\r\n Last one\r\n 0\r\n Expires: never\r\n Content-MD5: f4a5c16584f03d90\r\n \r\n
	Chunk Body: First Extension: quality = 1.0 Chunk Body: Hello, world! Extension: file = abc.txt Extension: quality = 0.7 Chunk Body: The Next Chunk Extension: last Chunk Body: Last one Expires: never Content-MD5: f4a5c16584f03d90	分块体：First 扩展：quality = 1.0 分块体：Hello, world! 扩展：file = abc.txt 扩展：quality = 0.7 分块体：The Next Chunk 扩展：last 分块体：Last one Expires: never Content-MD5: f4a5c16584f03d90

Key	English	Chinese (Simplified Han script)
	Chunk Parsing Example Output	分块解析示例输出
	Chunking Parse Callbacks	分块解析回调接口
	[link beast.ref.boost__beast__http__parser.on_chunk_header `on_chunk_header`]	[link beast.ref.boost__beast__http__parser.on_chunk_header `on_chunk_header`]
	[link beast.ref.boost__beast__http__parser.on_chunk_body `on_chunk_body`]	[link beast.ref.boost__beast__http__parser.on_chunk_body `on_chunk_body`]
	Set a callback to be invoked on chunk body data. The callback will be invoked one or more times to provide buffers corresponding to the chunk body for the current chunk. The callback receives the number of octets remaining in this chunk body including the octets in the buffer provided. The callback must return the number of octets actually consumed. Any octets not consumed will be presented again in a subsequent invocation of the callback. The implementation type-erases the callback without requiring a dynamic allocation. For this reason, the callback object is passed by a non-constant reference. The function object will be called with this equivalent signature:	设置一个回调函数，在分块体数据到达时调用。该回调函数会被调用一次或多次，用于提供当前分块体对应的缓冲区数据。回调函数会收到当前分块体中剩余的字节数（包含当前缓冲区中的字节）。回调函数必须返回实际消耗的字节数。未被消耗的字节会在后续回调调用中再次提供。该实现通过类型擦除处理回调，且无需动态分配内存，因此回调对象通过非常量引用传递。回调函数对象的调用签名等效于：
	This is a simple, allocating container which lets callers easily build up a set of chunk extensions.	这是一个简单的、可分配内存的容器，能够让调用方轻松构建一组分块扩展。
	[link beast.ref.boost__beast__http__chunk_header `chunk_header`]	[link beast.ref.boost__beast__http__chunk_header `chunk_header`]
	A buffer sequence representing a hex-encoded chunk size, followed by an optional set of chunk extensions, including the terminating CRLF (`"\r\n"`) delimiter which precedes the chunk body. This class is used when the caller desires to emit the chunk body in two or more individual stream operations.	一个表示十六进制编码的分块大小的缓冲区序列，并附带一组可选的分块扩展（含分块体前的终止 CRLF（`"\r\n"`）分隔符）。该辅助类用于调用方希望将分块体分成两次或多次独立流操作发送的场景。
	[link beast.ref.boost__beast__http__chunk_last `chunk_last`]	[link beast.ref.boost__beast__http__chunk_last `chunk_last`]
	These helper functions are used to construct a chunk or last chunk directly at call sites.	这些辅助函数用于在调用点直接构造分块或最后分块。
	We demonstrate the use of these objects first by declaring a function which returns the next buffer sequence to use as a chunk body:	首先声明一个函数，用于返回下一个作为分块体的缓冲区序列，以此演示这些对象的用法：
	This example demonstrates sending a complete chunked message payload manually. No chunk extensions or trailers are emitted:	本示例演示如何手动发送完整的分块消息有效载荷，过程中不发送分块扩展或尾部字段：
	The following code sends additional chunks, and sets chunk extensions using the helper container. The container automatically quotes values in the serialized output when necessary:	以下代码发送额外的分块，并使用辅助容器设置分块扩展。该容器在必要时会自动对序列化输出中的值进行引号处理：
	Using a custom allocator to serialize the last chunk:	使用自定义分配器序列化最后分块：
	For the ultimate level of control, a caller can manually compose the chunk itself by first emitting a header with the correct chunk body size, and then by emitting the chunk body in multiple calls to the stream write function. In this case the caller is responsible for also emitting the terminating CRLF (`"\r\n"`):	若需要最高级别的控制，调用方可以手动组合分块：先发送一个带有正确分块体大小的头部，然后通过多次调用流写入函数来发送分块体。此时，调用方还需负责发送终止的 CRLF（`"\r\n"`）：
	Parsing Chunks	解析分块
	The __parser__ automatically removes the chunked transfer coding when it is the last encoding in the list. However, it also discards the chunk extensions and does not provide a way to determine the boundaries between chunks. Advanced applications which need to access the chunk extensions or read complete individual chunks may use a callback interface provided by __parser__:	当分块传输编码位于编码列表的末尾时，__parser__ 会自动将其移除。但在此过程中，解析器会丢弃分块扩展，也不提供确定分块之间边界的方法。对于需要访问分块扩展或读取完整分块的高级应用，可以使用 __parser__ 提供的回调接口：
158	Name	名称
158	Description	描述
47	Description	描述
47	Name	名称

Loading…

Bstran

Translation changed

English

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

Set a callback to be invoked on chunk body data.

The callback will be invoked one or more times to provide buffers corresponding to the chunk body for the current chunk. The callback receives the number of octets remaining in this chunk body including the octets in the buffer provided.

The callback must return the number of octets actually consumed. Any octets not consumed will be presented again in a subsequent invocation of the callback. The implementation type-erases the callback without requiring a dynamic allocation. For this reason, the callback object is passed by a non-constant reference.

The function object will be called with this equivalent signature:设置一个回调函数，在分块体数据到达时调用。

该回调函数会被调用一次或多次，用于提供当前分块体对应的缓冲区数据。回调函数会收到当前分块体中剩余的字节数（包含当前缓冲区中的字节）。

回调函数必须返回实际消耗的字节数。未被消耗的字节会在后续回调调用中再次提供。该实现通过类型擦除处理回调，且无需动态分配内存，因此回调对象通过非常量引用传递。

回调函数对象的调用签名等效于：

06/18/2026

admin

String added in the repository

English

Chinese (Simplified Han script) 673 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

Source string description

type: table cell

Unit identifier

57778

Source string location

string ID 158

String age

06/05/2026

Last updated

06/26/2026

Source string age

06/05/2026

Translation file QuickBook file

doc/qbk/04_http/08_chunked_encoding_zh_Hans.qbk, string 37

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

Source string description

Details

Unit identifier

Source string location

String age

Last updated

Source string age

Translation file QuickBook file