python-docs-ja/c-api/bytes.po at 3.14 · python/python-docs-ja

706 lines (587 loc) · 23 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# python-doc bot, 2026
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-06-02 00:16+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: python-doc bot, 2026\n"
"Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ja\n"
"Plural-Forms: nplurals=1; plural=0;\n"
#: ../../c-api/bytes.rst:6
msgid "Bytes Objects"
msgstr "バイトオブジェクト"
#: ../../c-api/bytes.rst:8
"These functions raise :exc:`TypeError` when expecting a bytes parameter and "
"called with a non-bytes parameter."
"下記の関数は、バイトオブジェクトを期待している引数にバイトオブジェクトでない"
"パラメタを指定して呼び出されると、 :exc:`TypeError` を送出します。"
#: ../../c-api/bytes.rst:16
msgid "This subtype of :c:type:`PyObject` represents a Python bytes object."
"この :c:type:`PyObject` のサブタイプは、Python バイトオブジェクトを表します。"
#: ../../c-api/bytes.rst:21
"This instance of :c:type:`PyTypeObject` represents the Python bytes type; it "
"is the same object as :class:`bytes` in the Python layer."
"この :c:type:`PyTypeObject` のインスタンスは、Python バイト型を表します; "
"Pythonレイヤの :class:`bytes` と同じオブジェクトです。"
#: ../../c-api/bytes.rst:27
"Return true if the object *o* is a bytes object or an instance of a subtype "
"of the bytes type.  This function always succeeds."
"オブジェクト *o* が bytes オブジェクトか bytes 型のサブタイプのインスタンスで"
"ある場合に真を返します。この関数は常に成功します。"
#: ../../c-api/bytes.rst:33
"Return true if the object *o* is a bytes object, but not an instance of a "
"subtype of the bytes type.  This function always succeeds."
"オブジェクト *o* が bytes オブジェクトだが bytes 型のサブタイプのインスタンス"
"でない場合に真を返します。この関数は常に成功します。"
#: ../../c-api/bytes.rst:39
"Return a new bytes object with a copy of the string *v* as value on success, "
"and ``NULL`` on failure.  The parameter *v* must not be ``NULL``; it will "
"not be checked."
"成功時に、文字列 *v* のコピーを値とする新しいバイトオブジェクトを返し、失敗時"
"に ``NULL`` を返します。\n"
"引数 *v* は ``NULL`` であってはなりません; そのチェックは行われません。"
#: ../../c-api/bytes.rst:46
"Return a new bytes object with a copy of the string *v* as value and length "
"*len* on success, and ``NULL`` on failure.  If *v* is ``NULL``, the contents "
"of the bytes object are uninitialized."
"成功時に、文字列 *v* のコピーを値とする長さ *len* の新しいバイトオブジェクト"
"を返し、失敗時に ``NULL`` を返します。\n"
"引数 *v* が ``NULL`` の場合、バイトオブジェクトの中身は初期化されていません。"
#: ../../c-api/bytes.rst:50
"Use the :c:type:`PyBytesWriter` API instead of "
"``PyBytes_FromStringAndSize(NULL, len)``."
#: ../../c-api/bytes.rst:57
"Take a C :c:func:`printf`\\ -style *format* string and a variable number of "
"arguments, calculate the size of the resulting Python bytes object and "
"return a bytes object with the values formatted into it.  The variable "
"arguments must be C types and must correspond exactly to the format "
"characters in the *format* string.  The following format characters are "
"C 関数の :c:func:`printf` スタイルの *format* 文字列と可変長の引数を取り、結"
"果のPython バイトオブジェクトのサイズを計算し、値を指定した書式にしたがって変"
"換したバイトオブジェクトを返します。可変長の引数は C のデータ型でなければなら"
"ず、 *format* 文字列中のフォーマット文字と厳密に関連付けられていなければなり"
"ません。下記のフォーマット文字が使用できます:"
#: ../../c-api/bytes.rst:69
msgid "Format Characters"
msgstr "書式指定文字"
#: ../../c-api/bytes.rst:69
msgid "Type"
#: ../../c-api/bytes.rst:69
msgid "Comment"
msgstr "備考"
#: ../../c-api/bytes.rst:71
msgid "``%%``"
msgstr "``%%``"
#: ../../c-api/bytes.rst:71
msgid "*n/a*"
msgstr "*n/a*"
#: ../../c-api/bytes.rst:71
msgid "The literal % character."
msgstr "リテラルの % 文字"
#: ../../c-api/bytes.rst:73
msgid "``%c``"
msgstr "``%c``"
#: ../../c-api/bytes.rst:73 ../../c-api/bytes.rst:76 ../../c-api/bytes.rst:94
#: ../../c-api/bytes.rst:97
msgid "int"
msgstr "int"
#: ../../c-api/bytes.rst:73
msgid "A single byte, represented as a C int."
msgstr "C の整数型で表現される単一のバイト。"
#: ../../c-api/bytes.rst:76
msgid "``%d``"
msgstr "``%d``"
#: ../../c-api/bytes.rst:76
msgid "Equivalent to ``printf(\"%d\")``. [1]_"
msgstr "``printf(\"%d\")`` と同等。 [1]_"
#: ../../c-api/bytes.rst:79
msgid "``%u``"
msgstr "``%u``"
#: ../../c-api/bytes.rst:79
msgid "unsigned int"
msgstr "unsigned int"
#: ../../c-api/bytes.rst:79
msgid "Equivalent to ``printf(\"%u\")``. [1]_"
msgstr "``printf(\"%u\")`` と同等。 [1]_"
#: ../../c-api/bytes.rst:82
msgid "``%ld``"
msgstr "``%ld``"
#: ../../c-api/bytes.rst:82
msgid "long"
msgstr "long"
#: ../../c-api/bytes.rst:82
msgid "Equivalent to ``printf(\"%ld\")``. [1]_"
msgstr "``printf(\"%ld\")`` と同等。 [1]_"
#: ../../c-api/bytes.rst:85
msgid "``%lu``"
msgstr "``%lu``"
#: ../../c-api/bytes.rst:85
msgid "unsigned long"
msgstr "unsigned long"
#: ../../c-api/bytes.rst:85
msgid "Equivalent to ``printf(\"%lu\")``. [1]_"
msgstr "``printf(\"%lu\")`` と同等。 [1]_"
#: ../../c-api/bytes.rst:88
msgid "``%zd``"
msgstr "``%zd``"
#: ../../c-api/bytes.rst:88
msgid ":c:type:`\\ Py_ssize_t`"
msgstr ":c:type:`\\ Py_ssize_t`"
#: ../../c-api/bytes.rst:88
msgid "Equivalent to ``printf(\"%zd\")``. [1]_"
msgstr "``printf(\"%zd\")`` と同等。 [1]_"
#: ../../c-api/bytes.rst:91
msgid "``%zu``"
msgstr "``%zu``"
#: ../../c-api/bytes.rst:91
msgid "size_t"
msgstr "size_t"
#: ../../c-api/bytes.rst:91
msgid "Equivalent to ``printf(\"%zu\")``. [1]_"
msgstr "``printf(\"%zu\")`` と同等。 [1]_"
#: ../../c-api/bytes.rst:94
msgid "``%i``"
msgstr "``%i``"
#: ../../c-api/bytes.rst:94
msgid "Equivalent to ``printf(\"%i\")``. [1]_"
msgstr "``printf(\"%i\")`` と同等。 [1]_"
#: ../../c-api/bytes.rst:97
msgid "``%x``"
msgstr "``%x``"
#: ../../c-api/bytes.rst:97
msgid "Equivalent to ``printf(\"%x\")``. [1]_"
msgstr "``printf(\"%x\")`` と同等。 [1]_"
#: ../../c-api/bytes.rst:100
msgid "``%s``"
msgstr "``%s``"
#: ../../c-api/bytes.rst:100
msgid "const char\\*"
msgstr "const char\\*"
#: ../../c-api/bytes.rst:100
msgid "A null-terminated C character array."
msgstr "null で終端された C の文字列。"
#: ../../c-api/bytes.rst:103
msgid "``%p``"
msgstr "``%p``"
#: ../../c-api/bytes.rst:103
msgid "const void\\*"
msgstr "const void\\*"
#: ../../c-api/bytes.rst:103
"The hex representation of a C pointer. Mostly equivalent to "
"``printf(\"%p\")`` except that it is guaranteed to start with the literal "
"``0x`` regardless of what the platform's ``printf`` yields."
"C ポインタの 16 進表記。``printf(\"%p\")`` とほとんど同じですが、プラット"
"フォームにおける ``printf`` の定義に関わりなく先頭にリテラル ``0x`` が付きま"
#: ../../c-api/bytes.rst:112
"An unrecognized format character causes all the rest of the format string to "
"be copied as-is to the result object, and any extra arguments discarded."
"識別できない書式指定文字があった場合、残りの書式文字列はそのまま結果のオブ"
"ジェクトにコピーされ、残りの引数は無視されます。"
#: ../../c-api/bytes.rst:115
"For integer specifiers (d, u, ld, lu, zd, zu, i, x): the 0-conversion flag "
"has effect even when a precision is given."
"整数指定子 (d, u, ld, lu, zd, zu, i, x): 精度が与えられていても、0指定子は有"
#: ../../c-api/bytes.rst:121
"Identical to :c:func:`PyBytes_FromFormat` except that it takes exactly two "
"arguments."
"ちょうど２つの引数を取ることを除いて、 :c:func:`PyBytes_FromFormat` と同じで"
#: ../../c-api/bytes.rst:127
"Return the bytes representation of object *o* that implements the buffer "
"protocol."
msgstr "バッファプロトコルを実装するオブジェクト *o* のバイト表現を返します。"
#: ../../c-api/bytes.rst:131
"If the object implements the buffer protocol, then the buffer must not be "
"mutated while the bytes object is being created."
#: ../../c-api/bytes.rst:137
msgid "Return the length of the bytes in bytes object *o*."
msgstr "バイトオブジェクト *o* のバイト単位の長さを返します。"
#: ../../c-api/bytes.rst:142
msgid "Similar to :c:func:`PyBytes_Size`, but without error checking."
msgstr ":c:func:`PyBytes_Size` に似ていますが、エラーチェックを行いません。"
#: ../../c-api/bytes.rst:147
"Return a pointer to the contents of *o*.  The pointer refers to the internal "
"buffer of *o*, which consists of ``len(o) + 1`` bytes.  The last byte in the "
"buffer is always null, regardless of whether there are any other null "
"bytes.  The data must not be modified in any way, unless the object was just "
"created using ``PyBytes_FromStringAndSize(NULL, size)``. It must not be "
"deallocated.  If *o* is not a bytes object at all, :c:func:"
"`PyBytes_AsString` returns ``NULL`` and raises :exc:`TypeError`."
"*o* の中身へのポインタを返します。\n"
"ポインタは、 ``len(o) + 1`` バイトからなる *o* の内部バッファを参照します。\n"
"他に null のバイトがあるかどうかにかかわらず、バッファの最後のバイトは必ず "
"null になります。\n"
"``PyBytes_FromStringAndSize(NULL, size)`` で生成された場合を除いて、データを"
"修正してはなりません。\n"
"またポインタを解放（deallocated）してはなりません。\n"
"もし、 *o* が bytes オブジェクトでなければ、 :c:func:`PyBytes_AsString` は "
"``NULL`` を返し :exc:`TypeError` を送出します。"
#: ../../c-api/bytes.rst:159
msgid "Similar to :c:func:`PyBytes_AsString`, but without error checking."
":c:func:`PyBytes_AsString` に似ていますが、エラーチェックを行いません。"
#: ../../c-api/bytes.rst:164
"Return the null-terminated contents of the object *obj* through the output "
"variables *buffer* and *length*. Returns ``0`` on success."
#: ../../c-api/bytes.rst:168
"If *length* is ``NULL``, the bytes object may not contain embedded null "
"bytes; if it does, the function returns ``-1`` and a :exc:`ValueError` is "
"*length* の値が ``NULL`` の場合、バイトオブジェクトが  null バイトを含まない"
"可能性があります。その場合、関数は ``-1`` を返し、 :exc:`ValueError` を送出し"
#: ../../c-api/bytes.rst:172
"The buffer refers to an internal buffer of *obj*, which includes an "
"additional null byte at the end (not counted in *length*).  The data must "
"not be modified in any way, unless the object was just created using "
"``PyBytes_FromStringAndSize(NULL, size)``.  It must not be deallocated.  If "
"*obj* is not a bytes object at all, :c:func:`PyBytes_AsStringAndSize` "
"returns ``-1`` and raises :exc:`TypeError`."
"buffer は *obj* の内部バッファを参照していて、これには末尾の null バイトも含"
"んでいます (これは *length* には数えられません)。\n"
"オブジェクトが ``PyBytes_FromStringAndSize(NULL, size)`` で生成された場合を除"
"いて、何があってもデータを改変してはいけません。\n"
"オブジェクトを解放 (deallocate) してもいけません。\n"
"*obj* が bytes オブジェクトでなかった場合は、 :c:func:"
"`PyBytes_AsStringAndSize` は ``-1`` を返し :exc:`TypeError` を送出します。"
#: ../../c-api/bytes.rst:179
"Previously, :exc:`TypeError` was raised when embedded null bytes were "
"encountered in the bytes object."
"以前は bytes オブジェクトにヌルバイトが埋め込まれていたときに :exc:"
"`TypeError` を送出していました。"
#: ../../c-api/bytes.rst:186
"Create a new bytes object in *\\*bytes* containing the contents of *newpart* "
"appended to *bytes*; the caller will own the new reference.  The reference "
"to the old value of *bytes* will be stolen.  If the new object cannot be "
"created, the old reference to *bytes* will still be discarded and the value "
"of *\\*bytes* will be set to ``NULL``; the appropriate exception will be set."
"*newpart* の内容を *bytes* の後ろに連結した新しいバイトオブジェクトを "
"*\\*bytes* に生成します。呼び出し側は新しい参照を所有します。\n"
"*bytes* の古い値の参照は盗まれます。\n"
"もし新しいオブジェクトが生成できない場合、古い *bytes* の参照は放棄され、 "
"*\\*bytes* の値は ``NULL`` に設定されます; 適切な例外が設定されます。"
#: ../../c-api/bytes.rst:193 ../../c-api/bytes.rst:203
"If *newpart* implements the buffer protocol, then the buffer must not be "
"mutated while the new bytes object is being created."
#: ../../c-api/bytes.rst:198
"Create a new bytes object in *\\*bytes* containing the contents of *newpart* "
"appended to *bytes*.  This version releases the :term:`strong reference` to "
"*newpart* (i.e. decrements its reference count)."
#: ../../c-api/bytes.rst:209
msgid "Similar to ``sep.join(iterable)`` in Python."
#: ../../c-api/bytes.rst:211
"*sep* must be Python :class:`bytes` object. (Note that :c:func:"
"`PyUnicode_Join` accepts ``NULL`` separator and treats it as a space, "
"whereas :c:func:`PyBytes_Join` doesn't accept ``NULL`` separator.)"
#: ../../c-api/bytes.rst:216
"*iterable* must be an iterable object yielding objects that implement the :"
"ref:`buffer protocol <bufferobjects>`."
#: ../../c-api/bytes.rst:219
"On success, return a new :class:`bytes` object. On error, set an exception "
"and return ``NULL``."
#: ../../c-api/bytes.rst:225
"If *iterable* objects implement the buffer protocol, then the buffers must "
"not be mutated while the new bytes object is being created."
#: ../../c-api/bytes.rst:230
"Resize a bytes object. *newsize* will be the new length of the bytes object. "
"You can think of it as creating a new bytes object and destroying the old "
"one, only more efficiently. Pass the address of an existing bytes object as "
"an lvalue (it may be written into), and the new size desired.  On success, "
"*\\*bytes* holds the resized bytes object and ``0`` is returned; the address "
"in *\\*bytes* may differ from its input value.  If the reallocation fails, "
"the original bytes object at *\\*bytes* is deallocated, *\\*bytes* is set to "
"``NULL``, :exc:`MemoryError` is set, and ``-1`` is returned."
#: ../../c-api/bytes.rst:241
msgid "Use the :c:type:`PyBytesWriter` API instead."
#: ../../c-api/bytes.rst:247
"Get the string representation of *bytes*. This function is currently used to "
"implement :meth:`!bytes.__repr__` in Python."
#: ../../c-api/bytes.rst:250
"This function does not do type checking; it is undefined behavior to pass "
"*bytes* as a non-bytes object or ``NULL``."
#: ../../c-api/bytes.rst:253
"If *smartquotes* is true, the representation will use a double-quoted string "
"instead of single-quoted string when single-quotes are present in *bytes*. "
"For example, the byte string ``'Python'`` would be represented as "
"``b\"'Python'\"`` when *smartquotes* is true, or ``b'\\'Python\\''`` when it "
"is false."
#: ../../c-api/bytes.rst:259
"On success, this function returns a :term:`strong reference` to a :class:"
"`str` object containing the representation. On failure, this returns "
"``NULL`` with an exception set."
#: ../../c-api/bytes.rst:266
"Unescape a backslash-escaped string *s*. *s* must not be ``NULL``. *len* "
"must be the size of *s*."
#: ../../c-api/bytes.rst:269
"*errors* must be one of ``\"strict\"``, ``\"replace\"``, or ``\"ignore\"``. "
"If *errors* is ``NULL``, then ``\"strict\"`` is used by default."
#: ../../c-api/bytes.rst:272
"On success, this function returns a :term:`strong reference` to a Python :"
"class:`bytes` object containing the unescaped string. On failure, this "
"function returns ``NULL`` with an exception set."
#: ../../c-api/bytes.rst:276
msgid "*unicode* and *recode_encoding* are now unused."
#: ../../c-api/bytes.rst:283
msgid "PyBytesWriter"
#: ../../c-api/bytes.rst:285
"The :c:type:`PyBytesWriter` API can be used to create a Python :class:"
"`bytes` object."
#: ../../c-api/bytes.rst:292
msgid "A bytes writer instance."
#: ../../c-api/bytes.rst:294
"The API is **not thread safe**: a writer should only be used by a single "
"thread at the same time."
#: ../../c-api/bytes.rst:297
"The instance must be destroyed by :c:func:`PyBytesWriter_Finish` on success, "
"or :c:func:`PyBytesWriter_Discard` on error."
#: ../../c-api/bytes.rst:302
msgid "Create, Finish, Discard"
#: ../../c-api/bytes.rst:306
msgid "Create a :c:type:`PyBytesWriter` to write *size* bytes."
#: ../../c-api/bytes.rst:308
"If *size* is greater than zero, allocate *size* bytes, and set the writer "
"size to *size*. The caller is responsible to write *size* bytes using :c:"
"func:`PyBytesWriter_GetData`. This function does not overallocate."
#: ../../c-api/bytes.rst:313 ../../c-api/bytes.rst:438
msgid "On error, set an exception and return ``NULL``."
#: ../../c-api/bytes.rst:315 ../../c-api/bytes.rst:414
msgid "*size* must be positive or zero."
#: ../../c-api/bytes.rst:319
"Finish a :c:type:`PyBytesWriter` created by :c:func:`PyBytesWriter_Create`."
#: ../../c-api/bytes.rst:322
"On success, return a Python :class:`bytes` object. On error, set an "
"exception and return ``NULL``."
#: ../../c-api/bytes.rst:325
"The writer instance is invalid after the call in any case. No API can be "
"called on the writer after :c:func:`PyBytesWriter_Finish`."
#: ../../c-api/bytes.rst:330
"Similar to :c:func:`PyBytesWriter_Finish`, but resize the writer to *size* "
"bytes before creating the :class:`bytes` object."
#: ../../c-api/bytes.rst:335
"Similar to :c:func:`PyBytesWriter_Finish`, but resize the writer using *buf* "
"pointer before creating the :class:`bytes` object."
#: ../../c-api/bytes.rst:338
"Set an exception and return ``NULL`` if *buf* pointer is outside the "
"internal buffer bounds."
#: ../../c-api/bytes.rst:341 ../../c-api/bytes.rst:442
msgid "Function pseudo-code::"
#: ../../c-api/bytes.rst:343
"Py_ssize_t size = (char*)buf - (char*)PyBytesWriter_GetData(writer);\n"
"return PyBytesWriter_FinishWithSize(writer, size);"
#: ../../c-api/bytes.rst:348
"Discard a :c:type:`PyBytesWriter` created by :c:func:`PyBytesWriter_Create`."
#: ../../c-api/bytes.rst:350
msgid "Do nothing if *writer* is ``NULL``."
#: ../../c-api/bytes.rst:352
"The writer instance is invalid after the call. No API can be called on the "
"writer after :c:func:`PyBytesWriter_Discard`."
#: ../../c-api/bytes.rst:356
msgid "High-level API"
msgstr "高レベルAPI"
#: ../../c-api/bytes.rst:360
"Grow the *writer* internal buffer by *size* bytes, write *size* bytes of "
"*bytes* at the *writer* end, and add *size* to the *writer* size."
#: ../../c-api/bytes.rst:364
"If *size* is equal to ``-1``, call ``strlen(bytes)`` to get the string "
#: ../../c-api/bytes.rst:367 ../../c-api/bytes.rst:376
#: ../../c-api/bytes.rst:411 ../../c-api/bytes.rst:424
msgid "On success, return ``0``. On error, set an exception and return ``-1``."
#: ../../c-api/bytes.rst:372
"Similar to :c:func:`PyBytes_FromFormat`, but write the output directly at "
"the writer end. Grow the writer internal buffer on demand. Then add the "
"written size to the writer size."
#: ../../c-api/bytes.rst:381
msgid "Getters"
#: ../../c-api/bytes.rst:385
msgid "Get the writer size."
#: ../../c-api/bytes.rst:387 ../../c-api/bytes.rst:396
msgid "The function cannot fail."
#: ../../c-api/bytes.rst:391
msgid "Get the writer data: start of the internal buffer."
#: ../../c-api/bytes.rst:393
"The pointer is valid until :c:func:`PyBytesWriter_Finish` or :c:func:"
"`PyBytesWriter_Discard` is called on *writer*."
#: ../../c-api/bytes.rst:400
msgid "Low-level API"
msgstr "低レベルAPI"
#: ../../c-api/bytes.rst:404
"Resize the writer to *size* bytes. It can be used to enlarge or to shrink "
"the writer. This function typically overallocates to achieve amortized "
"performance when resizing multiple times."
#: ../../c-api/bytes.rst:409 ../../c-api/bytes.rst:422
msgid "Newly allocated bytes are left uninitialized."
#: ../../c-api/bytes.rst:418
"Resize the writer by adding *grow* bytes to the current writer size. This "
"function typically overallocates to achieve amortized performance when "
"resizing multiple times."
#: ../../c-api/bytes.rst:427
msgid "*size* can be negative to shrink the writer."
#: ../../c-api/bytes.rst:431
"Similar to :c:func:`PyBytesWriter_Grow`, but update also the *buf* pointer."
#: ../../c-api/bytes.rst:434
"The *buf* pointer is moved if the internal buffer is moved in memory. The "
"*buf* relative position within the internal buffer is left unchanged."
#: ../../c-api/bytes.rst:440
msgid "*buf* must not be ``NULL``."
#: ../../c-api/bytes.rst:444
"Py_ssize_t pos = (char*)buf - (char*)PyBytesWriter_GetData(writer);\n"
"if (PyBytesWriter_Grow(writer, size) < 0) {\n"
"    return NULL;\n"
"return (char*)PyBytesWriter_GetData(writer) + pos;"
#: ../../c-api/bytes.rst:11
msgid "object"
msgstr "object"
#: ../../c-api/bytes.rst:11
msgid "bytes"
msgstr "bytes"
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

bytes.po

Latest commit

History

bytes.po

File metadata and controls
