@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version : Python 3.15\n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2026-06-03 18:19 +0000\n "
14+ "POT-Creation-Date : 2026-06-05 16:27 +0000\n "
1515"PO-Revision-Date : 2025-09-16 00:01+0000\n "
1616"Last-Translator : python-doc bot, 2025\n "
1717"Language-Team : Indonesian (https://app.transifex.com/python-doc/teams/5390/ "
@@ -149,6 +149,15 @@ msgid ""
149149"The raw stream API is described in detail in the docs of :class:`RawIOBase`."
150150msgstr ""
151151
152+ msgid ""
153+ "Raw I/O is a low-level interface and methods generally must have their "
154+ "return values checked and be explicitly retried to ensure an operation "
155+ "completes. For instance :meth:`~RawIOBase.write` returns the number of bytes "
156+ "written which may be less than the number of bytes provided (a partial "
157+ "write). High-level I/O objects like :ref:`binary-io` and :ref:`text-io` "
158+ "implement retry behavior."
159+ msgstr ""
160+
152161msgid "Text Encoding"
153162msgstr ""
154163
@@ -607,9 +616,14 @@ msgstr ""
607616
608617msgid ""
609618"Read up to *size* bytes from the object and return them. As a convenience, "
610- "if *size* is unspecified or -1, all bytes until EOF are returned. Otherwise, "
611- "only one system call is ever made. Fewer than *size* bytes may be returned "
612- "if the operating system call returns fewer than *size* bytes."
619+ "if *size* is unspecified or -1, all bytes until EOF are returned."
620+ msgstr ""
621+
622+ msgid ""
623+ "Attempts to make only one system call but will retry if interrupted and the "
624+ "signal handler does not raise an exception (see :pep:`475` for the "
625+ "rationale). This means fewer than *size* bytes may be returned if the "
626+ "operating system call returns fewer than *size* bytes."
613627msgstr ""
614628
615629msgid ""
@@ -627,11 +641,22 @@ msgid ""
627641"calls to the stream if necessary."
628642msgstr ""
629643
644+ msgid ""
645+ "If ``0`` bytes are returned this indicates end of file. If the object is in "
646+ "non-blocking mode and the underlying :meth:`read` returns ``None`` "
647+ "indicating no bytes are available, ``None`` is returned."
648+ msgstr ""
649+
630650msgid ""
631651"Read bytes into a pre-allocated, writable :term:`bytes-like object` *b*, and "
632652"return the number of bytes read. For example, *b* might be a :class:"
633- "`bytearray`. If the object is in non-blocking mode and no bytes are "
634- "available, ``None`` is returned."
653+ "`bytearray`."
654+ msgstr ""
655+
656+ msgid ""
657+ "If ``0`` is returned and ``len(b)`` is not ``0``, this indicates end of "
658+ "file. If the object is in non-blocking mode and no bytes are available, "
659+ "``None`` is returned."
635660msgstr ""
636661
637662msgid ""
@@ -644,6 +669,14 @@ msgid ""
644669"the implementation should only access *b* during the method call."
645670msgstr ""
646671
672+ msgid ""
673+ "This function does not ensure all bytes are written or an exception is "
674+ "thrown. Callers may implement that behavior by checking the return value "
675+ "and, if it is less than the length of *b*, looping with additional write "
676+ "calls until all unwritten bytes are written. High-level I/O objects like :"
677+ "ref:`binary-io` and :ref:`text-io` implement retry behavior."
678+ msgstr ""
679+
647680msgid ""
648681"Base class for binary streams that support some kind of buffering. It "
649682"inherits from :class:`IOBase`."
@@ -777,7 +810,11 @@ msgstr ""
777810
778811msgid ""
779812"A raw binary stream representing an OS-level file containing bytes data. It "
780- "inherits from :class:`RawIOBase`."
813+ "inherits from :class:`RawIOBase` and implements its low-level access design. "
814+ "This means :meth:`~RawIOBase.write` does not guarantee all bytes are written "
815+ "and :meth:`~RawIOBase.read` may read less bytes than requested even when "
816+ "more bytes may be present in the underlying file. To get \" write all\" and "
817+ "\" read at least\" behavior, use :ref:`binary-io`."
781818msgstr ""
782819
783820msgid "The *name* can be one of two things:"
@@ -806,12 +843,6 @@ msgid ""
806843"``'+'`` to the mode to allow simultaneous reading and writing."
807844msgstr ""
808845
809- msgid ""
810- "The :meth:`~RawIOBase.read` (when called with a positive argument), :meth:"
811- "`~RawIOBase.readinto` and :meth:`~RawIOBase.write` methods on this class "
812- "will only make one system call."
813- msgstr ""
814-
815846msgid ""
816847"A custom opener can be used by passing a callable as *opener*. The "
817848"underlying file descriptor for the file object is then obtained by calling "
@@ -829,6 +860,14 @@ msgid ""
829860"parameter."
830861msgstr ""
831862
863+ msgid ""
864+ ":class:`FileIO` is a low-level I/O object and members, such as :meth:"
865+ "`~RawIOBase.read` and :meth:`~RawIOBase.write`, need to have their return "
866+ "values checked explicitly in a retry loop to implement \" write all\" and "
867+ "\" read at least\" behavior. High-level I/O objects :ref:`binary-io` and :ref:"
868+ "`text-io` implement retry behavior."
869+ msgstr ""
870+
832871msgid "The *opener* parameter was added. The ``'x'`` mode was added."
833872msgstr ""
834873
0 commit comments