msgid "" msgstr "" "Project-Id-Version: English (Boost Beast Translation (zh_Hans))\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2026-06-06 18:43+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: English \n" "Language: en\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n != 1;\n" "X-Generator: Weblate 2026.5\n" #. type: section title #: 12 #, read-only msgid "Timeouts" msgstr "Timeouts" #. type: paragraph #: 14 #, read-only msgid "" "While [link beast.ref.boost__beast__basic_stream `basic_stream`] and [link " "beast.ref.boost__beast__basic_stream `tcp_stream`] support timeouts on " "general logical operations, the websocket stream has a more sophisticated " "timeout mechanism built-in which may be enabled and configured. The timeout " "features of the TCP or basic stream should not be used when working with a " "websocket stream. The interface to these timeout features is shown in this " "table." msgstr "" "While [link beast.ref.boost__beast__basic_stream `basic_stream`] and [link " "beast.ref.boost__beast__basic_stream `tcp_stream`] support timeouts on " "general logical operations, the websocket stream has a more sophisticated " "timeout mechanism built-in which may be enabled and configured. The timeout " "features of the TCP or basic stream should not be used when working with a " "websocket stream. The interface to these timeout features is shown in this " "table." #. type: table title #: 22 #, read-only msgid "WebSocket Timeout Interface" msgstr "WebSocket Timeout Interface" #. type: table cell #: 22 #, read-only msgctxt "22" msgid "Name" msgstr "Name" #. type: table cell #: 22 #, read-only msgctxt "22" msgid "Description" msgstr "Description" #. type: table cell #: 22 #, read-only msgid "" "[link beast.ref.boost__beast__websocket__stream_base__timeout " "`stream_base::timeout`]" msgstr "" "[link beast.ref.boost__beast__websocket__stream_base__timeout " "`stream_base::timeout`]" #. type: table cell #: 22 #, read-only msgid "This represents configured timeout settings for a websocket stream." msgstr "This represents configured timeout settings for a websocket stream." #. type: table cell #: 22 #, read-only msgid "" "[link beast.ref.boost__beast__websocket__stream_base__timeout.suggested " "`stream_base::timeout::suggested`]" msgstr "" "[link beast.ref.boost__beast__websocket__stream_base__timeout.suggested " "`stream_base::timeout::suggested`]" #. type: table cell #: 22 #, read-only msgid "" "This function returns the suggested timeout settings for a given role " "(client or server)." msgstr "" "This function returns the suggested timeout settings for a given role " "(client or server)." #. type: table cell #: 22 #, read-only msgid "" "[link beast.ref.boost__beast__websocket__stream.set_option " "`stream::set_option`]" msgstr "" "[link beast.ref.boost__beast__websocket__stream.set_option " "`stream::set_option`]" #. type: table cell #: 22 #, read-only msgid "This function sets timeout and other options on the stream." msgstr "This function sets timeout and other options on the stream." #. type: paragraph #: 42 #, read-only msgid "" "There are three timeout settings which may be set independently on the " "stream:" msgstr "" "There are three timeout settings which may be set independently on the " "stream:" #. type: table title #: 44 #, read-only msgid "WebSocket Timeout Interface (2)" msgstr "WebSocket Timeout Interface (2)" #. type: table cell #: 44 #, read-only msgctxt "44" msgid "Name" msgstr "Name" #. type: table cell #: 44 #, read-only msgid "Type" msgstr "Type" #. type: table cell #: 44 #, read-only msgctxt "44" msgid "Description" msgstr "Description" #. type: table cell #: 44 #, read-only msgid "" "[link " "beast.ref.boost__beast__websocket__stream_base__timeout.handshake_timeout " "`timeout::handshake_timeout`]" msgstr "" "[link " "beast.ref.boost__beast__websocket__stream_base__timeout.handshake_timeout " "`timeout::handshake_timeout`]" #. type: table cell #. #: 44 #, read-only msgctxt "44" msgid "`duration`" msgstr "`duration`" #. type: table cell #: 44 #, read-only msgid "" "This is the amount of time after which a handshake will time out. The " "handshake timeout applies to client handshakes, server handshakes, as well " "as the websocket closing handshake performed when either end of the " "connection wish to shut down. The value returned by [link " "beast.ref.boost__beast__websocket__stream_base.none `stream_base::none()`] " "may be assigned to disable this timeout." msgstr "" "This is the amount of time after which a handshake will time out. The " "handshake timeout applies to client handshakes, server handshakes, as well " "as the websocket closing handshake performed when either end of the " "connection wish to shut down. The value returned by [link " "beast.ref.boost__beast__websocket__stream_base.none `stream_base::none()`] " "may be assigned to disable this timeout." #. type: table cell #: 44 #, read-only msgid "" "[link beast.ref.boost__beast__websocket__stream_base__timeout.idle_timeout " "`timeout::idle_timeout`]" msgstr "" "[link beast.ref.boost__beast__websocket__stream_base__timeout.idle_timeout " "`timeout::idle_timeout`]" #. type: table cell #: 44 #, read-only msgid "" "If no data or control frames are received from the peer for a time equal to " "the idle timeout, then the connection will time out. The value returned by " "[link beast.ref.boost__beast__websocket__stream_base.none `stream_base::none" "()`] may be assigned to disable this timeout." msgstr "" "If no data or control frames are received from the peer for a time equal to " "the idle timeout, then the connection will time out. The value returned by " "[link beast.ref.boost__beast__websocket__stream_base.none `stream_base::none" "()`] may be assigned to disable this timeout." #. type: table cell #: 44 #, read-only msgid "" "[link " "beast.ref.boost__beast__websocket__stream_base__timeout.keep_alive_pings " "`timeout::keep_alive_pings`]" msgstr "" "[link " "beast.ref.boost__beast__websocket__stream_base__timeout.keep_alive_pings " "`timeout::keep_alive_pings`]" #. type: table cell #: 44 #, read-only msgid "`bool`" msgstr "`bool`" #. type: table cell #: 44 #, read-only msgid "" "If the idle timeout is enabled, then the value of this setting controls " "whether or not a ping frame will be sent to the peer if no data is received " "for half of the idle timeout interval." msgstr "" "If the idle timeout is enabled, then the value of this setting controls " "whether or not a ping frame will be sent to the peer if no data is received " "for half of the idle timeout interval." #. type: paragraph #: 79 #, read-only msgid "" "By default, timeouts on websocket streams are disabled. The easiest way to " "turn them on is to set the suggested timeout settings on the stream." msgstr "" "By default, timeouts on websocket streams are disabled. The easiest way to " "turn them on is to set the suggested timeout settings on the stream." #. type: paragraph #: 84 #, read-only msgid "" "For manual control over the settings, a timeout options object may be " "constructed. Here we enable only the handshake timeout." msgstr "" "For manual control over the settings, a timeout options object may be " "constructed. Here we enable only the handshake timeout." #. type: paragraph #: 89 #, read-only msgid "" "Timeout notifications are delivered to the caller by invoking the completion " "handler for an outstanding asynchronous read operation with the error code " "[link beast.ref.boost__beast__error `error::timeout`]. The implementation " "will close the socket or stream before delivering this error. It is not " "necessary to manually shut down the connection, as it will already be shut " "down. A read operation must be outstanding for the error to be delivered." msgstr "" "Timeout notifications are delivered to the caller by invoking the completion " "handler for an outstanding asynchronous read operation with the error code " "[link beast.ref.boost__beast__error `error::timeout`]. The implementation " "will close the socket or stream before delivering this error. It is not " "necessary to manually shut down the connection, as it will already be shut " "down. A read operation must be outstanding for the error to be delivered." #. type: note #: 98 #, read-only msgid "" "Websocket timeout features are available only when using asynchronous I/O." msgstr "" "Websocket timeout features are available only when using asynchronous I/O." #. type: paragraph #: 102 #, read-only msgid "" "The timeouts on the websocket stream are incompatible with the timeouts used " "in the `tcp_stream`. When constructing a websocket stream from a tcp stream " "that has timeouts enabled, the timeout should be disabled first before " "constructing the websocket stream, as shown." msgstr "" "The timeouts on the websocket stream are incompatible with the timeouts used " "in the `tcp_stream`. When constructing a websocket stream from a tcp stream " "that has timeouts enabled, the timeout should be disabled first before " "constructing the websocket stream, as shown."