GitHub Viewer
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR , YEAR.
#
# Translators:
# python-doc bot, 2025
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-17 16:44+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/"
"ja/)\n"
"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/unicode.rst:6
msgid "Unicode Objects and Codecs"
msgstr "Unicode オブジェクトと codec"
#: ../../c-api/unicode.rst:9
msgid "Unicode Objects"
msgstr "Unicode オブジェクト"
#: ../../c-api/unicode.rst:11
msgid ""
"Since the implementation of :pep:`393` in Python 3.3, Unicode objects "
"internally use a variety of representations, in order to allow handling the "
"complete range of Unicode characters while staying memory efficient. There "
"are special cases for strings where all code points are below 128, 256, or "
"65536; otherwise, code points must be below 1114112 (which is the full "
"Unicode range)."
msgstr ""
"Python3.3 の :pep:`393` 実装から、メモリ効率を維持しながらUnicode文字の完全な"
"範囲を扱えるように、Unicodeオブジェクトは内部的に多様な表現形式を用いていま"
"す。すべてのコードポイントが128、256または65536以下の文字列に対して特別なケー"
"スが存在しますが、それ以外ではコードポイントは1114112以下 (これはすべての"
"Unicode範囲です) でなければなりません。"
#: ../../c-api/unicode.rst:17
msgid ""
"UTF-8 representation is created on demand and cached in the Unicode object."
msgstr ""
#: ../../c-api/unicode.rst:21
msgid ""
"The internal buffer always includes an extra trailing null character for "
"compatibility with null terminated C strings. This extra character is not "
"counted in :c:func:`PyUnicode_GetLength` nor in the various *size* arguments "
"of the functions below."
msgstr ""
#: ../../c-api/unicode.rst:27
msgid ""
"The :c:type:`Py_UNICODE` representation has been removed since Python 3.12 "
"with deprecated APIs. See :pep:`623` for more information."
msgstr ""
#: ../../c-api/unicode.rst:33
msgid "Unicode Type"
msgstr "Unicode 型"
#: ../../c-api/unicode.rst:35
msgid ""
"These are the basic Unicode object types used for the Unicode implementation "
"in Python:"
msgstr ""
"以下は Python の Unicode 実装に用いられている基本 Unicode オブジェクト型です:"
#: ../../c-api/unicode.rst:40
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python Unicode type. "
"It is exposed to Python code as :py:class:`str`."
msgstr ""
#: ../../c-api/unicode.rst:46
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python Unicode "
"iterator type. It is used to iterate over Unicode string objects."
msgstr ""
#: ../../c-api/unicode.rst:54
msgid ""
"These types are typedefs for unsigned integer types wide enough to contain "
"characters of 32 bits, 16 bits and 8 bits, respectively. When dealing with "
"single Unicode characters, use :c:type:`Py_UCS4`."
msgstr ""
"これらの型は、それぞれ、32ビット、16ビット、そして8ビットの文字を保持するのに"
"充分な幅を持つ符号なしの整数型のtypedefです。単一のUnicode文字を扱う場合"
"は、 :c:type:`Py_UCS4` を用いてください。"
#: ../../c-api/unicode.rst:65
msgid ""
"These subtypes of :c:type:`PyObject` represent a Python Unicode object. In "
"almost all cases, they shouldn't be used directly, since all API functions "
"that deal with Unicode objects take and return :c:type:`PyObject` pointers."
msgstr ""
"これらの :c:type:`PyObject` のサブタイプは Python Unicode オブジェクトを表現"
"します。\n"
"Unicode オブジェクトを扱う全ての API 関数は :c:type:`PyObject` へのポインタを"
"受け取って PyObject へのポインタを返すので、ほとんどの場合、これらの型を直接"
"使うべきではありません。"
#: ../../c-api/unicode.rst:72
msgid ""
"The structure of a particular object can be determined using the following "
"macros. The macros cannot fail; their behavior is undefined if their "
"argument is not a Python Unicode object."
msgstr ""
#: ../../c-api/unicode.rst:81
msgid "True if *o* uses the :c:struct:`PyCompactUnicodeObject` structure."
msgstr ""
#: ../../c-api/unicode.rst:88
msgid "True if *o* uses the :c:struct:`PyASCIIObject` structure."
msgstr ""
#: ../../c-api/unicode.rst:93
msgid ""
"The following APIs are C macros and static inlined functions for fast checks "
"and access to internal read-only data of Unicode objects:"
msgstr ""
#: ../../c-api/unicode.rst:98
msgid ""
"Return true if the object *obj* is a Unicode object or an instance of a "
"Unicode subtype. This function always succeeds."
msgstr ""
"オブジェクト *obj* が Unicode オブジェクトか Unicode 型のサブタイプのインスタ"
"ンスである場合に真を返します。この関数は常に成功します。"
#: ../../c-api/unicode.rst:104
msgid ""
"Return true if the object *obj* is a Unicode object, but not an instance of "
"a subtype. This function always succeeds."
msgstr ""
"オブジェクト *obj* が Unicode オブジェクトだがサブタイプのインスタンスでない"
"場合に真を返します。この関数は常に成功します。"
#: ../../c-api/unicode.rst:110
msgid ""
"Return the length of the Unicode string, in code points. *unicode* has to "
"be a Unicode object in the \"canonical\" representation (not checked)."
msgstr ""
"Unicode 文字列のコードポイントでの長さを返します。\n"
"*unicode* は \"正統な\" 表現形式の Unicode オブジェクトでなければなりません "
"(ただしチェックはしません)。"
#: ../../c-api/unicode.rst:120
msgid ""
"Return a pointer to the canonical representation cast to UCS1, UCS2 or UCS4 "
"integer types for direct character access. No checks are performed if the "
"canonical representation has the correct character size; use :c:func:"
"`PyUnicode_KIND` to select the right function."
msgstr ""
"文字に直接アクセスするために、 UCS1, UCS2, UCS4 のいずれかの整数型にキャスト"
"された正統な表現形式へのポインタを返します。\n"
"正統な表現が適正な文字サイズになっているかどうかのチェックはしません;\n"
":c:func:`PyUnicode_KIND` を使って正しい関数を選んでください。"
#: ../../c-api/unicode.rst:132
msgid "Return values of the :c:func:`PyUnicode_KIND` macro."
msgstr ":c:func:`PyUnicode_KIND` マクロの返り値です。"
#: ../../c-api/unicode.rst:136
msgid "``PyUnicode_WCHAR_KIND`` has been removed."
msgstr "``PyUnicode_WCHAR_KIND`` は削除されました。"
#: ../../c-api/unicode.rst:142
msgid ""
"Return one of the PyUnicode kind constants (see above) that indicate how "
"many bytes per character this Unicode object uses to store its data. "
"*unicode* has to be a Unicode object in the \"canonical\" representation "
"(not checked)."
msgstr ""
"この Unicode がデータを保存するのに1文字あたり何バイト使っているかを示す "
"PyUnicode 種別の定数 (上を読んでください) のうち1つを返します。\n"
"*unicode* は \"正統な\" 表現形式の Unicode オブジェクトでなければなりません "
"(ただしチェックはしません)。"
#: ../../c-api/unicode.rst:151
msgid ""
"Return a void pointer to the raw Unicode buffer. *unicode* has to be a "
"Unicode object in the \"canonical\" representation (not checked)."
msgstr ""
"生の Unicode バッファへの void ポインタを返します。\n"
"*unicode* は \"正統な\" 表現形式の Unicode オブジェクトでなければなりません "
"(ただしチェックはしません)。"
#: ../../c-api/unicode.rst:160
msgid ""
"Write the code point *value* to the given zero-based *index* in a string."
msgstr ""
#: ../../c-api/unicode.rst:162
msgid ""
"The *kind* value and *data* pointer must have been obtained from a string "
"using :c:func:`PyUnicode_KIND` and :c:func:`PyUnicode_DATA` respectively. "
"You must hold a reference to that string while calling :c:func:`!"
"PyUnicode_WRITE`. All requirements of :c:func:`PyUnicode_WriteChar` also "
"apply."
msgstr ""
#: ../../c-api/unicode.rst:168
msgid ""
"The function performs no checks for any of its requirements, and is intended "
"for usage in loops."
msgstr ""
#: ../../c-api/unicode.rst:176
msgid ""
"Read a code point from a canonical representation *data* (as obtained with :"
"c:func:`PyUnicode_DATA`). No checks are performed."
msgstr ""
#: ../../c-api/unicode.rst:181 ../../c-api/unicode.rst:195
msgid ""
"Accept reading the trailing null character at index :c:func:"
"`PyUnicode_GetLength`."
msgstr ""
#: ../../c-api/unicode.rst:189
msgid ""
"Read a character from a Unicode object *unicode*, which must be in the "
"\"canonical\" representation. This is less efficient than :c:func:"
"`PyUnicode_READ` if you do multiple consecutive reads."
msgstr ""
"Unicode オブジェクト *unicode* から文字を読み取ります。\n"
"この Unicode オブジェクトは \"正統な\" 表現形式でなければなりません。\n"
"何度も連続して読み取る場合には、このマクロは :c:func:`PyUnicode_READ` よりも"
"非効率的です。"
#: ../../c-api/unicode.rst:203
msgid ""
"Return the maximum code point that is suitable for creating another string "
"based on *unicode*, which must be in the \"canonical\" representation. This "
"is always an approximation but more efficient than iterating over the string."
msgstr ""
"*unicode* に基づいて他の文字列を作るのに適した最大のコードポイントを返しま"
"す。\n"
"この Unicode オブジェクトは \"正統な\" 表現形式でなければなりません。\n"
"この値は常に概算値ですが、文字列全体を調べるよりも効率的です。"
#: ../../c-api/unicode.rst:212
msgid ""
"Return ``1`` if the string is a valid identifier according to the language "
"definition, section :ref:`identifiers`. Return ``0`` otherwise."
msgstr ""
"文字列が、 :ref:`identifiers` 節の言語定義における有効な識別子であれば ``1`` "
"を返します。それ以外の場合は ``0`` を返します。"
#: ../../c-api/unicode.rst:215
msgid ""
"The function does not call :c:func:`Py_FatalError` anymore if the string is "
"not ready."
msgstr ""
#: ../../c-api/unicode.rst:222
msgid ""
"Return true if the string only contains ASCII characters. Equivalent to :py:"
"meth:`str.isascii`."
msgstr ""
#: ../../c-api/unicode.rst:230
msgid ""
"If the hash of *str*, as returned by :c:func:`PyObject_Hash`, has been "
"cached and is immediately available, return it. Otherwise, return ``-1`` "
"*without* setting an exception."
msgstr ""
#: ../../c-api/unicode.rst:234
msgid ""
"If *str* is not a string (that is, if ``PyUnicode_Check(obj)`` is false), "
"the behavior is undefined."
msgstr ""
#: ../../c-api/unicode.rst:237
msgid "This function never fails with an exception."
msgstr ""
#: ../../c-api/unicode.rst:239
msgid ""
"Note that there are no guarantees on when an object's hash is cached, and "
"the (non-)existence of a cached hash does not imply that the string has any "
"other properties."
msgstr ""
#: ../../c-api/unicode.rst:245
msgid "Unicode Character Properties"
msgstr "Unicode 文字プロパティ"
#: ../../c-api/unicode.rst:247
msgid ""
"Unicode provides many different character properties. The most often needed "
"ones are available through these macros which are mapped to C functions "
"depending on the Python configuration."
msgstr ""
"Unicode は数多くの異なる文字プロパティ (character property) を提供していま"
"す。よく使われる文字プロパティは、以下のマクロで利用できます。これらのマクロ"
"は Python の設定に応じて、各々 C の関数に対応付けられています。"
#: ../../c-api/unicode.rst:254
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a whitespace character."
msgstr "*ch* が空白文字かどうかに応じて ``1`` または ``0`` を返します。"
#: ../../c-api/unicode.rst:259
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a lowercase character."
msgstr "*ch* が小文字かどうかに応じて ``1`` または ``0`` を返します。"
#: ../../c-api/unicode.rst:264
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is an uppercase character."
msgstr "*ch* が大文字かどうかに応じて ``1`` または ``0`` を返します。"
#: ../../c-api/unicode.rst:269
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a titlecase character."
msgstr ""
"*ch* がタイトルケース文字 (titlecase character) かどうかに応じて ``1`` また"
"は ``0`` を返します。"
#: ../../c-api/unicode.rst:274
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a linebreak character."
msgstr "*ch* が改行文字かどうかに応じて ``1`` または ``0`` を返します。"
#: ../../c-api/unicode.rst:279
msgid "Return ``1`` or ``0`` depending on whether *ch* is a decimal character."
msgstr "*ch* が decimal 文字かどうかに応じて ``1`` または ``0`` を返します。"
#: ../../c-api/unicode.rst:284
msgid "Return ``1`` or ``0`` depending on whether *ch* is a digit character."
msgstr "*ch* が digit 文字かどうかに応じて ``1`` または ``0`` を返します。"
#: ../../c-api/unicode.rst:289
msgid "Return ``1`` or ``0`` depending on whether *ch* is a numeric character."
msgstr ""
"*ch* が数字 (numeric) 文字かどうかに応じて ``1`` または ``0`` を返します。"
#: ../../c-api/unicode.rst:294
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is an alphabetic character."
msgstr ""
"*ch* がアルファベット文字かどうかに応じて ``1`` または ``0`` を返します。"
#: ../../c-api/unicode.rst:299
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is an alphanumeric character."
msgstr "*ch* が英数文字かどうかに応じて ``1`` または ``0`` を返します。"
#: ../../c-api/unicode.rst:304
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a printable character, in "
"the sense of :meth:`str.isprintable`."
msgstr ""
#: ../../c-api/unicode.rst:308
msgid "These APIs can be used for fast direct character conversions:"
msgstr "以下の API は、高速に直接文字変換を行うために使われます:"
#: ../../c-api/unicode.rst:313
msgid "Return the character *ch* converted to lower case."
msgstr "*ch* を小文字に変換したものを返します。"
#: ../../c-api/unicode.rst:318
msgid "Return the character *ch* converted to upper case."
msgstr "*ch* を大文字に変換したものを返します。"
#: ../../c-api/unicode.rst:323
msgid "Return the character *ch* converted to title case."
msgstr "*ch* をタイトルケース文字に変換したものを返します。"
#: ../../c-api/unicode.rst:328
msgid ""
"Return the character *ch* converted to a decimal positive integer. Return "
"``-1`` if this is not possible. This function does not raise exceptions."
msgstr ""
#: ../../c-api/unicode.rst:334
msgid ""
"Return the character *ch* converted to a single digit integer. Return ``-1`` "
"if this is not possible. This function does not raise exceptions."
msgstr ""
#: ../../c-api/unicode.rst:340
msgid ""
"Return the character *ch* converted to a double. Return ``-1.0`` if this is "
"not possible. This function does not raise exceptions."
msgstr ""
"*ch* を double に変換したものを返します。不可能ならば ``-1.0`` を返します。こ"
"の関数は例外を送出しません。"
#: ../../c-api/unicode.rst:344
msgid "These APIs can be used to work with surrogates:"
msgstr "これらの API はサロゲートにも使えます:"
#: ../../c-api/unicode.rst:348
msgid "Check if *ch* is a surrogate (``0xD800