msgid ""
msgstr ""
"Project-Id-Version: English (Boost Beast Translation (zh_Hans))\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-06-06 17:48+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: English <https://insights.cppalliance.org/weblate/projects/"
"boost-beast-documentation-zh_Hans/doc-qbk-07-concepts-file-qbk/en/>\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
#: 8
#, read-only
msgid "File"
msgstr "File"

#. type: paragraph
#: 10
#, read-only
msgid ""
"The [*File] concept abstracts access to files in the underlying file system. "
"To support other platform interfaces, users may author their own [*File] "
"types which meet these requirements."
msgstr ""
"The [*File] concept abstracts access to files in the underlying file system. "
"To support other platform interfaces, users may author their own [*File] "
"types which meet these requirements."

#. type: heading
#: 14
#, read-only
msgid "Associated Types"
msgstr "Associated Types"

#. type: list
#: 16
#, read-only
msgid ""
"* [link beast.ref.boost__beast__file_mode `file_mode`]\n"
"* [link beast.ref.boost__beast__is_file `is_file`]"
msgstr ""
"* [link beast.ref.boost__beast__file_mode `file_mode`]\n"
"* [link beast.ref.boost__beast__is_file `is_file`]"

#. type: heading
#: 19
#, read-only
msgid "Requirements"
msgstr "Requirements"

#. type: paragraph
#: 21
#, read-only
msgid "In this table:"
msgstr "In this table:"

#. type: list
#: 23
#, read-only
msgid ""
"* `F` is a [*File] type\n"
"* `f` is an instance of `F`\n"
"* `p` is a value of type `char const*` which points to a null"
msgstr ""
"* `F` is a [*File] type\n"
"* `f` is an instance of `F`\n"
"* `p` is a value of type `char const*` which points to a null"

#. type: list
#: 27
#, read-only
msgid ""
"* `m` is an instance of [link beast.ref.boost__beast__file_mode "
"`file_mode`]\n"
"* `n` is a number of bytes, convertible to `std::size_t`\n"
"* `o` is a byte offset in the file, convertible to `std::uint64_t`\n"
"* `b` is any non-const pointer to memory\n"
"* `c` is any possibly-const pointer to memory\n"
"* `ec` is a reference of type [link beast.ref.boost__beast__error_code "
"`error_code`]"
msgstr ""
"* `m` is an instance of [link beast.ref.boost__beast__file_mode "
"`file_mode`]\n"
"* `n` is a number of bytes, convertible to `std::size_t`\n"
"* `o` is a byte offset in the file, convertible to `std::uint64_t`\n"
"* `b` is any non-const pointer to memory\n"
"* `c` is any possibly-const pointer to memory\n"
"* `ec` is a reference of type [link beast.ref.boost__beast__error_code "
"`error_code`]"

#. type: table title
#: 34
#, read-only
msgid "Valid expressions"
msgstr "Valid expressions"

#. type: table cell
#: 34
#, read-only
msgid "Expression"
msgstr "Expression"

#. type: table cell
#: 34
#, read-only
msgid "Type"
msgstr "Type"

#. type: table cell
#.
#: 34
#, read-only
msgctxt "34"
msgid "Semantics, Pre/Post-conditions"
msgstr "Semantics, Pre/Post-conditions"

#. type: table cell
#: 34
#, read-only
msgid "Operation"
msgstr "Operation"

#. type: table cell
#: 34
#, read-only
msgid "Return Type"
msgstr "Return Type"

#. type: table cell
#: 34
#, read-only
msgid "`F()`"
msgstr "`F()`"

#. type: table cell
#: 34
#, read-only
msgid "Default constructable"
msgstr "Default constructable"

#. type: table cell
#: 34
#, read-only
msgid "`f.~F()`"
msgstr "`f.~F()`"

#. type: table cell
#: 34
#, read-only
msgid ""
"Destructible. If `f` refers to an open file, it is first closed as if by a "
"call to `close` with the error ignored."
msgstr ""
"Destructible. If `f` refers to an open file, it is first closed as if by a "
"call to `close` with the error ignored."

#. type: table cell
#: 34
#, read-only
msgid "`f.is_open()`"
msgstr "`f.is_open()`"

#. type: table cell
#: 34
#, read-only
msgid "`bool`"
msgstr "`bool`"

#. type: table cell
#: 34
#, read-only
msgid "Returns `true` if `f` refers to an open file, `false` otherwise."
msgstr "Returns `true` if `f` refers to an open file, `false` otherwise."

#. type: table cell
#: 34
#, read-only
msgid "`f.close(ec)`"
msgstr "`f.close(ec)`"

#. type: table cell
#: 34
#, read-only
msgid ""
"If `f` refers to an open file, this function attempts to close the file. "
"Regardless of whether an error occurs or not, a subsequent call to `f.is_open"
"()` will return `false`. The function will ensure that `!ec` is `true` if "
"there was no error or set to the appropriate error code if an error occurred."
msgstr ""
"If `f` refers to an open file, this function attempts to close the file. "
"Regardless of whether an error occurs or not, a subsequent call to `f.is_open"
"()` will return `false`. The function will ensure that `!ec` is `true` if "
"there was no error or set to the appropriate error code if an error occurred."

#. type: table cell
#: 34
#, read-only
msgid "`f.open(p,m,ec)`"
msgstr "`f.open(p,m,ec)`"

#. type: table cell
#: 34
#, read-only
msgid ""
"Attempts to open the file at the path specified by `p` with the mode "
"specified by `m`. Upon success, a subsequent call to `f.is_open()` will "
"return `true`. If `f` refers to an open file, it is first closed as if by a "
"call to `close` with the error ignored. The function will ensure that `!ec` "
"is `true` if there was no error or set to the appropriate error code if an "
"error occurred."
msgstr ""
"Attempts to open the file at the path specified by `p` with the mode "
"specified by `m`. Upon success, a subsequent call to `f.is_open()` will "
"return `true`. If `f` refers to an open file, it is first closed as if by a "
"call to `close` with the error ignored. The function will ensure that `!ec` "
"is `true` if there was no error or set to the appropriate error code if an "
"error occurred."

#. type: table cell
#: 34
#, read-only
msgid "`f.size(ec)`"
msgstr "`f.size(ec)`"

#. type: table cell
#.
#: 34
#, read-only
msgctxt "34"
msgid "`std::uint64_t`"
msgstr "`std::uint64_t`"

#. type: table cell
#: 34
#, read-only
msgid ""
"If `f` refers to an open file, this function attempts to determine the file "
"size and return its value. If `f` does not refer to an open file, the "
"function will set `ec` to `errc::invalid_argument` and return 0. The "
"function will ensure that `!ec` is `true` if there was no error or set to "
"the appropriate error code if an error occurred."
msgstr ""
"If `f` refers to an open file, this function attempts to determine the file "
"size and return its value. If `f` does not refer to an open file, the "
"function will set `ec` to `errc::invalid_argument` and return 0. The "
"function will ensure that `!ec` is `true` if there was no error or set to "
"the appropriate error code if an error occurred."

#. type: table cell
#: 34
#, read-only
msgid "`f.pos(ec)`"
msgstr "`f.pos(ec)`"

#. type: table cell
#: 34
#, read-only
msgid ""
"If `f` refers to an open file, this function attempts to determine the "
"current file offset and return it. If `f` does not refer to an open file, "
"the function will set `ec` to `errc::invalid_argument` and return 0. The "
"function will ensure that `!ec` is `true` if there was no error or set to "
"the appropriate error code if an error occurred."
msgstr ""
"If `f` refers to an open file, this function attempts to determine the "
"current file offset and return it. If `f` does not refer to an open file, "
"the function will set `ec` to `errc::invalid_argument` and return 0. The "
"function will ensure that `!ec` is `true` if there was no error or set to "
"the appropriate error code if an error occurred."

#. type: table cell
#: 34
#, read-only
msgid "`f.seek(o,ec)`"
msgstr "`f.seek(o,ec)`"

#. type: table cell
#: 34
#, read-only
msgid ""
"Attempts to reposition the current file offset to the value `o`, which "
"represents a byte offset relative to the beginning of the file. If `f` does "
"not refer to an open file, the function will set `ec` to "
"`errc::invalid_argument` and return immediately. The function will ensure "
"that `!ec` is `true` if there was no error or set to the appropriate error "
"code if an error occurred."
msgstr ""
"Attempts to reposition the current file offset to the value `o`, which "
"represents a byte offset relative to the beginning of the file. If `f` does "
"not refer to an open file, the function will set `ec` to "
"`errc::invalid_argument` and return immediately. The function will ensure "
"that `!ec` is `true` if there was no error or set to the appropriate error "
"code if an error occurred."

#. type: table cell
#: 34
#, read-only
msgid "`f.read(b,n,ec)`"
msgstr "`f.read(b,n,ec)`"

#. type: table cell
#.
#: 34
#, read-only
msgctxt "34"
msgid "`std::size_t`"
msgstr "`std::size_t`"

#. type: table cell
#: 34
#, read-only
msgid ""
"Attempts to read `n` bytes starting at the current file offset from the open "
"file referred to by `f`. Bytes read are stored in the memory buffer at "
"address `b` which must be at least `n` bytes in size. The function advances "
"the file offset by the amount read, and returns the number of bytes actually "
"read, which may be less than `n`. If `f` does not refer to an open file, the "
"function will set `ec` to `errc::invalid_argument` and return immediately. "
"The function will ensure that `!ec` is `true` if there was no error or set "
"to the appropriate error code if an error occurred. If an end-of-file "
"condition is detected prior to reading any bytes, the function will ensure "
"that `!ec` is `true` and the return value shall be 0."
msgstr ""
"Attempts to read `n` bytes starting at the current file offset from the open "
"file referred to by `f`. Bytes read are stored in the memory buffer at "
"address `b` which must be at least `n` bytes in size. The function advances "
"the file offset by the amount read, and returns the number of bytes actually "
"read, which may be less than `n`. If `f` does not refer to an open file, the "
"function will set `ec` to `errc::invalid_argument` and return immediately. "
"The function will ensure that `!ec` is `true` if there was no error or set "
"to the appropriate error code if an error occurred. If an end-of-file "
"condition is detected prior to reading any bytes, the function will ensure "
"that `!ec` is `true` and the return value shall be 0."

#. type: table cell
#: 34
#, read-only
msgid "`f.write(c,n,ec)`"
msgstr "`f.write(c,n,ec)`"

#. type: table cell
#: 34
#, read-only
msgid ""
"Attempts to write `n` bytes from the buffer pointed to by `c` to the current "
"file offset of the open file referred to by `f`. The memory buffer at `c` "
"must point to storage of at least `n` bytes meant to be copied to the file. "
"The function advances the file offset by the amount written, and returns the "
"number of bytes actually written, which may be less than `n`. If `f` does "
"not refer to an open file, the function will set `ec` to "
"`errc::invalid_argument` and return immediately. The function will ensure "
"that `!ec` is `true` if there was no error or set to the appropriate error "
"code if an error occurred."
msgstr ""
"Attempts to write `n` bytes from the buffer pointed to by `c` to the current "
"file offset of the open file referred to by `f`. The memory buffer at `c` "
"must point to storage of at least `n` bytes meant to be copied to the file. "
"The function advances the file offset by the amount written, and returns the "
"number of bytes actually written, which may be less than `n`. If `f` does "
"not refer to an open file, the function will set `ec` to "
"`errc::invalid_argument` and return immediately. The function will ensure "
"that `!ec` is `true` if there was no error or set to the appropriate error "
"code if an error occurred."

#. type: heading
#: 170
#, read-only
msgid "Exemplar"
msgstr "Exemplar"

#. type: heading
#: 174
#, read-only
msgid "Models"
msgstr "Models"

#. type: list
#: 176
#, read-only
msgid ""
"* [link beast.ref.boost__beast__file_posix `file_posix`]\n"
"* [link beast.ref.boost__beast__file_stdio `file_stdio`]\n"
"* [link beast.ref.boost__beast__file_win32 `file_win32`]"
msgstr ""
"* [link beast.ref.boost__beast__file_posix `file_posix`]\n"
"* [link beast.ref.boost__beast__file_stdio `file_stdio`]\n"
"* [link beast.ref.boost__beast__file_win32 `file_win32`]"