# 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, 2025

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-04-11 14:31+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"

#: ../../library/codecs.rst:2

msgid ":mod:`!codecs` --- Codec registry and base classes"

msgstr ":mod:`!codecs` --- codec レジストリと基底クラス"

#: ../../library/codecs.rst:11

msgid "**Source code:** :source:`Lib/codecs.py`"

msgstr "**ソースコード:** :source:`Lib/codecs.py`"

#: ../../library/codecs.rst:23

msgid ""

"This module defines base classes for standard Python codecs (encoders and "

"decoders) and provides access to the internal Python codec registry, which "

"manages the codec and error handling lookup process. Most standard codecs "

"are :term:`text encodings <text encoding>`, which encode text to bytes (and "

"decode bytes to text), but there are also codecs provided that encode text "

"to text, and bytes to bytes. Custom codecs may encode and decode between "

"arbitrary types, but some module features are restricted to be used "

"specifically with :term:`text encodings <text encoding>` or with codecs that "

"encode to :class:`bytes`."

msgstr ""

"このモジュールは、標準的な Python codec (エンコーダとデコーダ) 用の基底クラス"

"を定義し、codec とエラー処理検索プロセスを管理する内部の Python codec レジス"

"トリへのアクセスを提供します。多くの codec はテキストをバイトにエンコードす"

"る (そしてバイトをテキストにデコードする) :term:`テキストエンコーディング "

"<text encoding>` ですが、テキストをテキストに、またはバイトをバイトにエンコー"

"ドする codec も提供されています。カスタムの codec は任意の型間でエンコードと"

"デコードを行えますが、一部のモジュール機能は :term:`テキストエンコーディング "

"<text encoding>` か :class:`bytes` へのエンコードのみに制限されています。"

#: ../../library/codecs.rst:33

msgid ""

"The module defines the following functions for encoding and decoding with "

"any codec:"

msgstr ""

"このモジュールでは、任意の codec でエンコードやデコードを行うための、以下の関"

"数が定義されています。"

#: ../../library/codecs.rst:38

msgid "Encodes *obj* using the codec registered for *encoding*."

msgstr "*encoding* に記載された codec を使用して *obj* をエンコードします。"

#: ../../library/codecs.rst:40

msgid ""

"*Errors* may be given to set the desired error handling scheme. The default "

"error handler is ``'strict'`` meaning that encoding errors raise :exc:"

"`ValueError` (or a more codec specific subclass, such as :exc:"

"`UnicodeEncodeError`). Refer to :ref:`codec-base-classes` for more "

"information on codec error handling."

msgstr ""

"希望のエラー処理スキームを *errors* に設定することができます。デフォルトのエ"

"ラーハンドラ (エラー処理関数) は ``'strict'`` です。これはエンコードエラー"

"は :exc:`ValueError` (もしくは :exc:`UnicodeEncodeError` のような、より "

"codec に固有のサブクラス) を送出することを意味します。codec エラー処理につい"

"てのより詳しい情報は :ref:`codec-base-classes` を参照してください。"

#: ../../library/codecs.rst:48

msgid "Decodes *obj* using the codec registered for *encoding*."

msgstr "*encoding* に記載された codec を使用して *obj* をデコードします。"

#: ../../library/codecs.rst:50

msgid ""

"*Errors* may be given to set the desired error handling scheme. The default "

"error handler is ``'strict'`` meaning that decoding errors raise :exc:"

"`ValueError` (or a more codec specific subclass, such as :exc:"

"`UnicodeDecodeError`). Refer to :ref:`codec-base-classes` for more "

"information on codec error handling."

msgstr ""

"希望のエラー処理スキームを *errors* に設定することができます。デフォルトのエ"

"ラーハンドラは ``'strict'`` です。これはデコードエラーは :exc:`ValueError` "

"(もしくは :exc:`UnicodeDecodeError` のような、より codec に固有のサブクラス) "

"を送出することを意味します。codec エラー処理についてのより詳しい情報は :ref:"

"`codec-base-classes` を参照してください。"

#: ../../library/codecs.rst:58

msgid ""

"Return a mapping suitable for encoding with a custom single-byte encoding. "

"Given a :class:`str` *string* of up to 256 characters representing a "

"decoding table, returns either a compact internal mapping object "

"``EncodingMap`` or a :class:`dictionary <dict>` mapping character ordinals "

"to byte values. Raises a :exc:`TypeError` on invalid input."

msgstr ""

#: ../../library/codecs.rst:64

msgid "The full details for each codec can also be looked up directly:"

msgstr "各 codec についての詳細も、次のようにして直接調べることができます。"

#: ../../library/codecs.rst:68

msgid ""

"Looks up the codec info in the Python codec registry and returns a :class:"

"`CodecInfo` object as defined below."

msgstr ""

"Python codec レジストリから codec 情報を探し、以下で定義するような :class:"

"`CodecInfo` オブジェクトを返します。"

#: ../../library/codecs.rst:71

msgid ""

"Encodings are first looked up in the registry's cache. If not found, the "

"list of registered search functions is scanned. If no :class:`CodecInfo` "

"object is found, a :exc:`LookupError` is raised. Otherwise, the :class:"

"`CodecInfo` object is stored in the cache and returned to the caller."

msgstr ""

"エンコーディングの検索は、まずレジストリのキャッシュから行います。見つからな"

"ければ、登録されている検索関数のリストから探します。 :class:`CodecInfo` オブ"

"ジェクトが一つも見つからなければ :exc:`LookupError` を送出します。見つかった"

"ら、その :class:`CodecInfo` オブジェクトはキャッシュに保存され、呼び出し側に"

"返されます。"

#: ../../library/codecs.rst:78

msgid ""

"Codec details when looking up the codec registry. The constructor arguments "

"are stored in attributes of the same name:"

msgstr ""

"codec レジストリ内を検索する場合の、codec の詳細です。コントラクタ引数は、次"

"の同名の属性に保存されます。"

#: ../../library/codecs.rst:84

msgid "The name of the encoding."

msgstr "エンコーディングの名前です。"

#: ../../library/codecs.rst:90

msgid ""

"The stateless encoding and decoding functions. These must be functions or "

"methods which have the same interface as the :meth:`~Codec.encode` and :meth:"

"`~Codec.decode` methods of Codec instances (see :ref:`Codec Interface <codec-"

"objects>`). The functions or methods are expected to work in a stateless "

"mode."

msgstr ""

"ステートレスなエンコーディングとデコーディングの関数です。これらは、Codec イ"

"ンスタンスの :meth:`~Codec.encode` メソッドと :meth:`~Codec.decode` メソッド"

"と同じインターフェースを持っている必要があります (see :ref:`Codec のインター"

"フェース <codec-objects>` を参照)。この関数またはメソッドは、ステートレスモー"

"ドで動作することが想定されています。"

#: ../../library/codecs.rst:100

msgid ""

"Incremental encoder and decoder classes or factory functions. These have to "

"provide the interface defined by the base classes :class:"

"`IncrementalEncoder` and :class:`IncrementalDecoder`, respectively. "

"Incremental codecs can maintain state."

msgstr ""

"インクリメンタル・エンコーダとデコーダのクラスまたはファクトリ関数です。これ"

"らは、基底クラスの :class:`IncrementalEncoder` と :class:"

"`IncrementalDecoder` が定義するインターフェースをそれぞれ提供する必要がありま"

"す。インクリメンタルな codec は、ステート (内部状態) を保持することができま"

"す。"

#: ../../library/codecs.rst:109

msgid ""

"Stream writer and reader classes or factory functions. These have to provide "

"the interface defined by the base classes :class:`StreamWriter` and :class:"

"`StreamReader`, respectively. Stream codecs can maintain state."

msgstr ""

"ストリームライターとリーダーのクラスまたはファクトリ関数です。これらは、基底"

"クラスの :class:`StreamWriter` と :class:`StreamReader` が定義するインター"

"フェースをそれぞれ提供する必要があります。ストリーム codec は、ステートを保持"

"することができます。"

#: ../../library/codecs.rst:114

msgid ""

"To simplify access to the various codec components, the module provides "

"these additional functions which use :func:`lookup` for the codec lookup:"

msgstr ""

"さまざまな codec 構成要素へのアクセスを簡便化するために、このモジュールは以下"

"のような関数を提供しています。これらの関数は、 codec の検索に :func:`lookup` "

"を使います:"

#: ../../library/codecs.rst:119

msgid ""

"Look up the codec for the given encoding and return its encoder function."

msgstr ""

"与えられたエンコーディングに対する codec を検索し、エンコーダ関数を返します。"

#: ../../library/codecs.rst:121 ../../library/codecs.rst:128

#: ../../library/codecs.rst:154 ../../library/codecs.rst:162

msgid "Raises a :exc:`LookupError` in case the encoding cannot be found."

msgstr "エンコーディングが見つからなければ :exc:`LookupError` を送出します。"

#: ../../library/codecs.rst:126

msgid ""

"Look up the codec for the given encoding and return its decoder function."

msgstr ""

"与えられたエンコーディングに対する codec を検索し、デコーダ関数を返します。"

#: ../../library/codecs.rst:133

msgid ""

"Look up the codec for the given encoding and return its incremental encoder "

"class or factory function."

msgstr ""

"与えられたエンコーディングに対する codec を検索し、インクリメンタル・エンコー"

"ダクラスまたはファクトリ関数を返します。"

#: ../../library/codecs.rst:136

msgid ""

"Raises a :exc:`LookupError` in case the encoding cannot be found or the "

"codec doesn't support an incremental encoder."

msgstr ""

"エンコーディングが見つからないか、 codec がインクリメンタル・エンコーダをサ"

"ポートしなければ :exc:`LookupError` を送出します。"

#: ../../library/codecs.rst:142

msgid ""

"Look up the codec for the given encoding and return its incremental decoder "

"class or factory function."

msgstr ""

"与えられたエンコーディングに対する codec を検索し、インクリメンタル・デコーダ"

"クラスまたはファクトリ関数を返します。"

#: ../../library/codecs.rst:145

msgid ""

"Raises a :exc:`LookupError` in case the encoding cannot be found or the "

"codec doesn't support an incremental decoder."

msgstr ""

"エンコーディングが見つからないか、 codec がインクリメンタル・デコーダをサポー"

"トしなければ :exc:`LookupError` を送出します。"

#: ../../library/codecs.rst:151

msgid ""

"Look up the codec for the given encoding and return its :class:"

"`StreamReader` class or factory function."

msgstr ""

"与えられたエンコーディングに対する codec を検索し、:class:`StreamReader` クラ"

"スまたはファクトリ関数を返します。"

#: ../../library/codecs.rst:159

msgid ""

"Look up the codec for the given encoding and return its :class:"

"`StreamWriter` class or factory function."

msgstr ""

"与えられたエンコーディングに対する codec を検索し、:class:`StreamWriter` クラ"

"スまたはファクトリ関数を返します。"

#: ../../library/codecs.rst:164

msgid ""

"Custom codecs are made available by registering a suitable codec search "

"function:"

msgstr ""

"次のように、適切な codec 検索関数を登録することで、カスタムの codecs を利用す"

"ることができます。"

#: ../../library/codecs.rst:169

msgid ""

"Register a codec search function. Search functions are expected to take one "

"argument, being the encoding name in all lower case letters with hyphens and "

"spaces converted to underscores, and return a :class:`CodecInfo` object. In "

"case a search function cannot find a given encoding, it should return "

"``None``."

msgstr ""

#: ../../library/codecs.rst:175

msgid "Hyphens and spaces are converted to underscore."

msgstr ""

#: ../../library/codecs.rst:181

msgid ""

"Unregister a codec search function and clear the registry's cache. If the "

"search function is not registered, do nothing."

msgstr ""

#: ../../library/codecs.rst:187

msgid ""

"While the builtin :func:`open` and the associated :mod:`io` module are the "

"recommended approach for working with encoded text files, this module "

"provides additional utility functions and classes that allow the use of a "

"wider range of codecs when working with binary files:"

msgstr ""

"エンコードされたテキストファイルを処理する場合、組み込みの :func:`open` とそ"

"れに関連付けられた :mod:`io` モジュールの使用が推奨されていますが、このモ"

"ジュールは追加のユーティリティ関数とクラスを提供し、バイナリファイルを処理す"

"る場合に幅広い codecs を利用できるようにします。"

#: ../../library/codecs.rst:194

msgid ""

"Open an encoded file using the given *mode* and return an instance of :class:"

"`StreamReaderWriter`, providing transparent encoding/decoding. The default "

"file mode is ``'r'``, meaning to open the file in read mode."

msgstr ""

"エンコードされたファイルを *mode* を使って開き、透過的なエンコード/デコードを"

"提供する :class:`StreamReaderWriter` のインスタンスを返します。デフォルトの"

"ファイルモードは ``'r'`` 、つまり、読み出しモードでファイルを開きます。"

#: ../../library/codecs.rst:200

msgid ""

"If *encoding* is not ``None``, then the underlying encoded files are always "

"opened in binary mode. No automatic conversion of ``'\\n'`` is done on "

"reading and writing. The *mode* argument may be any binary mode acceptable "

"to the built-in :func:`open` function; the ``'b'`` is automatically added."

msgstr ""

"*encoding* が ``None`` でなければ、下層のエンコードされたファイルは、常にバイ"

"ナリモードで開きます。読み書き時に、 ``'\\n'`` の自動変換は行われません。"

"*mode* 引数は、組み込みの :func:`open` 関数が受け入れる任意のバイナリモードに"

"することができます。``'b'`` が自動的に付加されます。"

#: ../../library/codecs.rst:206

msgid ""

"*encoding* specifies the encoding which is to be used for the file. Any "

"encoding that encodes to and decodes from bytes is allowed, and the data "

"types supported by the file methods depend on the codec used."

msgstr ""

"*encoding* は、そのファイルに対して使用されるエンコーディングを指定します。バ"

"イトにエンコードする、あるいはバイトからデコードするすべてのエンコーディング"

"が許可されます。ファイルメソッドがサポートするデータ型は、使用される codec に"

"よって異なります。"

#: ../../library/codecs.rst:210

msgid ""

"*errors* may be given to define the error handling. It defaults to "

"``'strict'`` which causes a :exc:`ValueError` to be raised in case an "

"encoding error occurs."

msgstr ""

"エラーハンドリングのために *errors* を渡すことができます。これはデフォルトで"

"は ``'strict'`` で、エンコード時にエラーがあれば :exc:`ValueError` を送出しま"

"す。"

#: ../../library/codecs.rst:213

msgid ""

"*buffering* has the same meaning as for the built-in :func:`open` function. "

"It defaults to -1 which means that the default buffer size will be used."

msgstr ""

#: ../../library/codecs.rst:216

msgid "The ``'U'`` mode has been removed."

msgstr "``'U'`` モードは削除されました。"

#: ../../library/codecs.rst:221

msgid ":func:`codecs.open` has been superseded by :func:`open`."

msgstr ""

#: ../../library/codecs.rst:226

msgid ""

"Return a :class:`StreamRecoder` instance, a wrapped version of *file* which "

"provides transparent transcoding. The original file is closed when the "

"wrapped version is closed."

msgstr ""

"透過的なエンコード変換を行うファイルのラップされたバージョンである、:class:"

"`StreamRecoder` インスタンスを返します。元のファイルは、ラップされたバージョ"

"ンが閉じられる時に、閉じられます。"

#: ../../library/codecs.rst:230

msgid ""

"Data written to the wrapped file is decoded according to the given "

"*data_encoding* and then written to the original file as bytes using "

"*file_encoding*. Bytes read from the original file are decoded according to "

"*file_encoding*, and the result is encoded using *data_encoding*."

msgstr ""

"ラップされたファイルに書き込まれたデータは、指定された *data_encoding* に従っ"

"てデコードされ、次に *file_encoding* を使用して元のファイルにバイトとして書き"

"出されます。元のファイルから読み出されたバイトは、*file_encoding* に従ってデ"

"コードされ、結果は *data_encoding* を使用してエンコードされます。"

#: ../../library/codecs.rst:236

msgid "If *file_encoding* is not given, it defaults to *data_encoding*."

msgstr ""

"*file_encoding* が与えられなければ、*data_encoding* がデフォルトになります。"

#: ../../library/codecs.rst:238

msgid ""

"*errors* may be given to define the error handling. It defaults to "

"``'strict'``, which causes :exc:`ValueError` to be raised in case an "

"encoding error occurs."

msgstr ""

"エラーハンドリングのために *errors* を渡すことができます。これはデフォルトで"

"は ``'strict'`` で、エンコード時にエラーがあれば :exc:`ValueError` を送出しま"

"す。"

#: ../../library/codecs.rst:245

msgid ""

"Uses an incremental encoder to iteratively encode the input provided by "

"*iterator*. *iterator* must yield :class:`str` objects. This function is a :"

"term:`generator`. The *errors* argument (as well as any other keyword "

"argument) is passed through to the incremental encoder."

msgstr ""

#: ../../library/codecs.rst:250

msgid ""

"This function requires that the codec accept text :class:`str` objects to "

"encode. Therefore it does not support bytes-to-bytes encoders such as "

"``base64_codec``."

msgstr ""

"この関数では、コーデックはエンコードするテキストの :class:`str` オブジェクト"

"を受け付ける必要があります。\n"

"従って、 ``base64_codec`` のようなバイトからバイトへのエンコーダはサポートし"

"ていません。"

#: ../../library/codecs.rst:257

msgid ""

"Uses an incremental decoder to iteratively decode the input provided by "

"*iterator*. *iterator* must yield :class:`bytes` objects. This function is "

"a :term:`generator`. The *errors* argument (as well as any other keyword "

"argument) is passed through to the incremental decoder."

msgstr ""

#: ../../library/codecs.rst:262

msgid ""

"This function requires that the codec accept :class:`bytes` objects to "

"decode. Therefore it does not support text-to-text encoders such as "

"``rot_13``, although ``rot_13`` may be used equivalently with :func:"

"`iterencode`."

msgstr ""

"この関数では、コーデックはエンコードする :class:`bytes` オブジェクトを受け付"

"ける必要があります。\n"

"従って、 ``rot_13`` のようなテキストからテキストへのエンコーダが :func:"

"`iterencode` で同等に使えるとしても、この関数ではサポートしていません。"

#: ../../library/codecs.rst:270

msgid ""

"Return a :class:`tuple` containing the raw bytes of *buffer*, a :ref:`buffer-"

"compatible object <bufferobjects>` or :class:`str` (encoded to UTF-8 before "

"processing), and their length in bytes."

msgstr ""

#: ../../library/codecs.rst:274

msgid "The *errors* argument is ignored."

msgstr ""

#: ../../library/codecs.rst:276

msgid ""

">>> codecs.readbuffer_encode(b\"Zito\")\n"

"(b'Zito', 4)"

msgstr ""

#: ../../library/codecs.rst:282

msgid ""

"The module also provides the following constants which are useful for "

"reading and writing to platform dependent files:"

msgstr ""

"このモジュールは以下のような定数も定義しています。プラットフォーム依存なファ"

"イルを読み書きするのに役立ちます:"

#: ../../library/codecs.rst:297

msgid ""

"These constants define various byte sequences, being Unicode byte order "

"marks (BOMs) for several encodings. They are used in UTF-16 and UTF-32 data "

"streams to indicate the byte order used, and in UTF-8 as a Unicode "

"signature. :const:`BOM_UTF16` is either :const:`BOM_UTF16_BE` or :const:"

"`BOM_UTF16_LE` depending on the platform's native byte order, :const:`BOM` "

"is an alias for :const:`BOM_UTF16`, :const:`BOM_LE` for :const:"

"`BOM_UTF16_LE` and :const:`BOM_BE` for :const:`BOM_UTF16_BE`. The others "

"represent the BOM in UTF-8 and UTF-32 encodings."

msgstr ""

"これらの定数は、いくつかのエンコーディングの Unicode のバイトオーダマーク "

"(BOM) で、様々なバイトシーケンスを定義します。これらは、UTF-16 と UTF-32 の"

"データストリームで使用するバイトオーダを指定したり、 UTF-8 で Unicode シグネ"

"チャとして使われます。 :const:`BOM_UTF16` は、プラットフォームのネイティブバ"

"イトオーダによって :const:`BOM_UTF16_BE` または :const:`BOM_UTF16_LE` で"

"す。 :const:`BOM` は :const:`BOM_UTF16` のエイリアスです。同様に、 :const:"

"`BOM_LE` は :const:`BOM_UTF16_LE` の、 :const:`BOM_BE` は :const:"

"`BOM_UTF16_BE` のエイリアスです。その他の定数は UTF-8 と UTF-32 エンコーディ"

"ングの BOM を表します。"

#: ../../library/codecs.rst:311

msgid "Codec Base Classes"

msgstr "Codec 基底クラス"

#: ../../library/codecs.rst:313

msgid ""

"The :mod:`!codecs` module defines a set of base classes which define the "

"interfaces for working with codec objects, and can also be used as the basis "

"for custom codec implementations."

msgstr ""

#: ../../library/codecs.rst:317

msgid ""

"Each codec has to define four interfaces to make it usable as codec in "

"Python: stateless encoder, stateless decoder, stream reader and stream "

"writer. The stream reader and writers typically reuse the stateless encoder/"

"decoder to implement the file protocols. Codec authors also need to define "

"how the codec will handle encoding and decoding errors."

msgstr ""

"Python で codec として使えるようにするには、ステートレスエンコーダ、ステート"

"レスデコーダ、ストリームリーダ、ストリームライタの 4 つのインターフェースを定"

"義する必要があります。通常は、ストリームリーダとライタはステートレスエンコー"

"ダとデコーダを再利用して、ファイルプロトコルを実装します。codec の作者は、"

"codec がエンコードとデコードのエラーの処理方法も定義する必要があります。"

#: ../../library/codecs.rst:328

msgid "Error Handlers"

msgstr "エラーハンドラ"

#: ../../library/codecs.rst:330

msgid ""

"To simplify and standardize error handling, codecs may implement different "

"error handling schemes by accepting the *errors* string argument:"

msgstr ""

"エラー処理の簡便化と標準化のため、コーデックは、*errors* 文字列引数を指定した"

"場合に別のエラー処理を行うような仕組みを実装してもかまいません\\:"

#: ../../library/codecs.rst:350

msgid ""

"The following error handlers can be used with all Python :ref:`standard-"

"encodings` codecs:"

msgstr ""

#: ../../library/codecs.rst:356 ../../library/codecs.rst:399

#: ../../library/codecs.rst:419

msgid "Value"

msgstr "値"

#: ../../library/codecs.rst:356 ../../library/codecs.rst:399

#: ../../library/codecs.rst:419 ../../library/codecs.rst:1376

#: ../../library/codecs.rst:1448 ../../library/codecs.rst:1533

msgid "Meaning"

msgstr "意味"

#: ../../library/codecs.rst:358

msgid "``'strict'``"

msgstr "``'strict'``"

#: ../../library/codecs.rst:358

msgid ""

"Raise :exc:`UnicodeError` (or a subclass), this is the default. Implemented "

"in :func:`strict_errors`."

msgstr ""

":exc:`UnicodeError` (または、そのサブクラス) を送出します。これがデフォルトの"

"動作です。 :func:`strict_errors` で実装されています。"

#: ../../library/codecs.rst:362

msgid "``'ignore'``"

msgstr "``'ignore'``"

#: ../../library/codecs.rst:362

msgid ""

"Ignore the malformed data and continue without further notice. Implemented "

"in :func:`ignore_errors`."

msgstr ""

"不正な形式のデータを無視し、何も通知することなく処理を継続します。:func:"

"`ignore_errors` で実装されています。"

#: ../../library/codecs.rst:366

msgid "``'replace'``"

msgstr "``'replace'``"

#: ../../library/codecs.rst:366

msgid ""

"Replace with a replacement marker. On encoding, use ``?`` (ASCII character). "

"On decoding, use ``�`` (U+FFFD, the official REPLACEMENT CHARACTER). "

"Implemented in :func:`replace_errors`."

msgstr ""

#: ../../library/codecs.rst:372

msgid "``'backslashreplace'``"

msgstr "``'backslashreplace'``"

#: ../../library/codecs.rst:372

msgid ""

"Replace with backslashed escape sequences. On encoding, use hexadecimal form "

"of Unicode code point with formats :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}` :"

"samp:`\\\\U{xxxxxxxx}`. On decoding, use hexadecimal form of byte value with "

"format :samp:`\\\\x{hh}`. Implemented in :func:`backslashreplace_errors`."

msgstr ""

#: ../../library/codecs.rst:381

msgid "``'surrogateescape'``"

msgstr "``'surrogateescape'``"

#: ../../library/codecs.rst:381

msgid ""

"On decoding, replace byte with individual surrogate code ranging from "

"``U+DC80`` to ``U+DCFF``. This code will then be turned back into the same "

"byte when the ``'surrogateescape'`` error handler is used when encoding the "

"data. (See :pep:`383` for more.)"

msgstr ""

"デコード時には、バイト列を ``U+DC80`` から ``U+DCFF`` の範囲の個々のサロゲー"

"トコードで置き換えます。データのエンコード時に ``'surrogateescape'`` エラーハ"

"ンドラが使用されると、このコードは同じバイト列に戻されます。 (詳しくは :pep:"

"`383` を参照。)"

#: ../../library/codecs.rst:395

msgid ""

"The following error handlers are only applicable to encoding (within :term:"

"`text encodings <text encoding>`):"

msgstr ""

#: ../../library/codecs.rst:401

msgid "``'xmlcharrefreplace'``"

msgstr "``'xmlcharrefreplace'``"

#: ../../library/codecs.rst:401

msgid ""

"Replace with XML/HTML numeric character reference, which is a decimal form "

"of Unicode code point with format :samp:`&#{num};`. Implemented in :func:"

"`xmlcharrefreplace_errors`."

msgstr ""

#: ../../library/codecs.rst:407

msgid "``'namereplace'``"

msgstr "``'namereplace'``"

#: ../../library/codecs.rst:407

msgid ""

"Replace with ``\\N{...}`` escape sequences, what appears in the braces is "

"the Name property from Unicode Character Database. Implemented in :func:"

"`namereplace_errors`."

msgstr ""

#: ../../library/codecs.rst:416

msgid ""

"In addition, the following error handler is specific to the given codecs:"

msgstr "さらに、次のエラーハンドラは与えられた codec に特有です:"

#: ../../library/codecs.rst:13 ../../library/codecs.rst:419

msgid "Codecs"

msgstr "Codecs"

#: ../../library/codecs.rst:421

msgid "``'surrogatepass'``"

msgstr "``'surrogatepass'``"

#: ../../library/codecs.rst:421

msgid "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le"

msgstr "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le"

#: ../../library/codecs.rst:421

msgid ""

"Allow encoding and decoding surrogate code point (``U+D800`` - ``U+DFFF``) "

"as normal code point. Otherwise these codecs treat the presence of surrogate "

"code point in :class:`str` as an error."

msgstr ""

#: ../../library/codecs.rst:428

msgid "The ``'surrogateescape'`` and ``'surrogatepass'`` error handlers."

msgstr "``'surrogateescape'`` および ``'surrogatepass'`` エラーハンドラ。"

#: ../../library/codecs.rst:431

msgid ""

"The ``'surrogatepass'`` error handler now works with utf-16\\* and utf-32\\* "

"codecs."

msgstr ""

#: ../../library/codecs.rst:435

msgid "The ``'namereplace'`` error handler."

msgstr "``'namereplace'`` エラーハンドラです。"

#: ../../library/codecs.rst:438

msgid ""

"The ``'backslashreplace'`` error handler now works with decoding and "

"translating."

msgstr ""

#: ../../library/codecs.rst:442

msgid ""

"The set of allowed values can be extended by registering a new named error "

"handler:"

msgstr ""

"次のように、名前付きの新しいエラーハンドラを登録することで、許可される値の集"

"合を拡張することができます。"

#: ../../library/codecs.rst:447

msgid ""

"Register the error handling function *error_handler* under the name *name*. "

"The *error_handler* argument will be called during encoding and decoding in "

"case of an error, when *name* is specified as the errors parameter."

msgstr ""

"エラーハンドラ *error_handler* を名前 *name* で登録します。エンコード中および"

"デコード中にエラーが送出された場合、*name* が errors 引数として指定されていれ"

"ば *error_handler* が呼び出されます。"

#: ../../library/codecs.rst:451

msgid ""

"For encoding, *error_handler* will be called with a :exc:"

"`UnicodeEncodeError` instance, which contains information about the location "

"of the error. The error handler must either raise this or a different "

"exception, or return a tuple with a replacement for the unencodable part of "

"the input and a position where encoding should continue. The replacement may "

"be either :class:`str` or :class:`bytes`. If the replacement is bytes, the "

"encoder will simply copy them into the output buffer. If the replacement is "

"a string, the encoder will encode the replacement. Encoding continues on "

"original input at the specified position. Negative position values will be "

"treated as being relative to the end of the input string. If the resulting "

"position is out of bound an :exc:`IndexError` will be raised."

msgstr ""

"*error_handler* はエラーの場所に関する情報の入った :exc:`UnicodeEncodeError` "

"インスタンスとともに呼び出されます。エラー処理関数はこの例外を送出するか、別"

"の例外を送出するか、入力のエンコードできなかった部分の代替文字列とエンコード"

"を再開する場所が入ったタプルを返す必要があります。代替文字列は :class:`str` "

"または :class:`bytes` のいずれかにすることができます。代替文字列がバイト列で"

"ある場合、エンコーダは単に出力バッファにそれをコピーします。代替文字列が文字"

"列である場合、エンコーダは代替文字列をエンコードします。元の入力中の指定位置"

"からエンコードが再開されます。位置を負の値にすると、入力文字列の末端からの相"

"対位置として扱われます。境界の外側にある位置を返した場合には :exc:"

"`IndexError` が送出されます。"

#: ../../library/codecs.rst:463

msgid ""

"Decoding and translating works similarly, except :exc:`UnicodeDecodeError` "

"or :exc:`UnicodeTranslateError` will be passed to the handler and that the "

"replacement from the error handler will be put into the output directly."

msgstr ""

"デコードと翻訳の動作は似ていますが、エラーハンドラに渡されるのが :exc:"

"`UnicodeDecodeError` か :exc:`UnicodeTranslateError` である点と、エラーハンド"

"ラの置換した内容が直接出力されるという点が異なります。"

#: ../../library/codecs.rst:468

msgid ""

"Previously registered error handlers (including the standard error handlers) "

"can be looked up by name:"

msgstr ""

"登録済みのエラーハンドラ (標準エラーハンドラを含む) は、次のようにその名前で"

"検索することができます。"

#: ../../library/codecs.rst:473

msgid "Return the error handler previously registered under the name *name*."

msgstr "名前 *name* で登録済みのエラーハンドラを返します。"

#: ../../library/codecs.rst:475

msgid "Raises a :exc:`LookupError` in case the handler cannot be found."

msgstr "エラーハンドラが見つからなければ :exc:`LookupError` を送出します。"

#: ../../library/codecs.rst:477

msgid ""

"The following standard error handlers are also made available as module "

"level functions:"

msgstr "以下の標準エラーハンドラも、モジュールレベルの関数として利用できます。"

#: ../../library/codecs.rst:482

msgid "Implements the ``'strict'`` error handling."

msgstr ""

#: ../../library/codecs.rst:484

msgid "Each encoding or decoding error raises a :exc:`UnicodeError`."

msgstr ""

#: ../../library/codecs.rst:489

msgid "Implements the ``'ignore'`` error handling."

msgstr ""

#: ../../library/codecs.rst:491

msgid ""

"Malformed data is ignored; encoding or decoding is continued without further "

"notice."

msgstr ""

#: ../../library/codecs.rst:497

msgid "Implements the ``'replace'`` error handling."

msgstr ""

#: ../../library/codecs.rst:499

msgid ""

"Substitutes ``?`` (ASCII character) for encoding errors or ``�`` (U+FFFD, "

"the official REPLACEMENT CHARACTER) for decoding errors."

msgstr ""

#: ../../library/codecs.rst:505

msgid "Implements the ``'backslashreplace'`` error handling."

msgstr ""

#: ../../library/codecs.rst:507

msgid ""

"Malformed data is replaced by a backslashed escape sequence. On encoding, "

"use the hexadecimal form of Unicode code point with formats :samp:`\\\\x{hh}"

"` :samp:`\\\\u{xxxx}` :samp:`\\\\U{xxxxxxxx}`. On decoding, use the "

"hexadecimal form of byte value with format :samp:`\\\\x{hh}`."

msgstr ""

#: ../../library/codecs.rst:513

msgid "Works with decoding and translating."

msgstr ""

#: ../../library/codecs.rst:519

msgid ""

"Implements the ``'xmlcharrefreplace'`` error handling (for encoding within :"

"term:`text encoding` only)."

msgstr ""

#: ../../library/codecs.rst:522

msgid ""

"The unencodable character is replaced by an appropriate XML/HTML numeric "

"character reference, which is a decimal form of Unicode code point with "

"format :samp:`&#{num};` ."

msgstr ""

#: ../../library/codecs.rst:529

msgid ""

"Implements the ``'namereplace'`` error handling (for encoding within :term:"

"`text encoding` only)."

msgstr ""

#: ../../library/codecs.rst:532

msgid ""

"The unencodable character is replaced by a ``\\N{...}`` escape sequence. The "

"set of characters that appear in the braces is the Name property from "

"Unicode Character Database. For example, the German lowercase letter ``'ß'`` "

"will be converted to byte sequence ``\\N{LATIN SMALL LETTER SHARP S}`` ."

msgstr ""

#: ../../library/codecs.rst:543

msgid "Stateless Encoding and Decoding"

msgstr "ステートレスなエンコードとデコード"

#: ../../library/codecs.rst:545

msgid ""

"The base :class:`Codec` class defines these methods which also define the "

"function interfaces of the stateless encoder and decoder:"

msgstr ""

"基底の :class:`Codec` クラスは以下のメソッドを定義します。これらのメソッド"

"は、内部状態を持たないエンコーダ／デコーダ関数のインターフェースを定義します:"

#: ../../library/codecs.rst:553

msgid ""

"Encodes the object *input* and returns a tuple (output object, length "

"consumed). For instance, :term:`text encoding` converts a string object to a "

"bytes object using a particular character set encoding (e.g., ``cp1252`` or "

"``iso-8859-1``)."

msgstr ""

"オブジェクト *input* エンコードし、(出力オブジェクト, 消費した長さ) のタプル"

"を返します。例えば、 :term:`テキストエンコーディング <text encoding>` は文字"

"列オブジェクトを特有の文字セット (例えば ``cp1252`` や ``iso-8859-1``) を用い"

"てバイト列オブジェクトに変換します。"

#: ../../library/codecs.rst:558 ../../library/codecs.rst:580

msgid ""

"The *errors* argument defines the error handling to apply. It defaults to "

"``'strict'`` handling."

msgstr ""

"*errors* 引数は適用するエラー処理を定義します。``'strict'`` 処理がデフォルト"

"です。"

#: ../../library/codecs.rst:561

msgid ""

"The method may not store state in the :class:`Codec` instance. Use :class:"

"`StreamWriter` for codecs which have to keep state in order to make encoding "

"efficient."

msgstr ""

"このメソッドは :class:`Codec` に内部状態を保存してはなりません。効率よくエン"

"コードするために状態を保持しなければならないような codecs には :class:"

"`StreamWriter` を使ってください。"

#: ../../library/codecs.rst:565

msgid ""

"The encoder must be able to handle zero length input and return an empty "

"object of the output object type in this situation."

msgstr ""

"エンコーダは長さが 0 の入力を処理できなければなりません。この場合、空のオブ"

"ジェクトを出力オブジェクトとして返さなければなりません。"

#: ../../library/codecs.rst:571

msgid ""

"Decodes the object *input* and returns a tuple (output object, length "

"consumed). For instance, for a :term:`text encoding`, decoding converts a "

"bytes object encoded using a particular character set encoding to a string "

"object."

msgstr ""

"オブジェクト *input* をデコードし、(出力オブジェクト, 消費した長さ) のタプル"

"を返します。例えば、 :term:`テキストエンコーディング <text encoding>` は、特"

"定の文字集合エンコーディングでエンコードされたバイト列オブジェクトを文字列オ"

"ブジェクトに変換します。"

#: ../../library/codecs.rst:576

msgid ""

"For text encodings and bytes-to-bytes codecs, *input* must be a bytes object "

"or one which provides the read-only buffer interface -- for example, buffer "

"objects and memory mapped files."

msgstr ""

"テキストエンコーディングとバイト列からバイト列への codec では、*input* は "

"bytes オブジェクト、または読み出し専用のバッファインターフェースを提供するオ"

"ブジェクトである必要があります。例えば、buffer オブジェクトやメモリマップド"

"ファイルでなければなりません。"

#: ../../library/codecs.rst:583

msgid ""

"The method may not store state in the :class:`Codec` instance. Use :class:"

"`StreamReader` for codecs which have to keep state in order to make decoding "

"efficient."

msgstr ""

"このメソッドは、 :class:`Codec` インスタンスに内部状態を保存してはなりませ"

"ん。効率よくエンコード／デコードするために状態を保持しなければならないような "

"codecs には :class:`StreamReader` を使ってください。"

#: ../../library/codecs.rst:587

msgid ""

"The decoder must be able to handle zero length input and return an empty "

"object of the output object type in this situation."

msgstr ""

"デコーダは長さが 0 の入力を処理できなければなりません。この場合、空のオブジェ"

"クトを出力オブジェクトとして返さなければなりません。"

#: ../../library/codecs.rst:592

msgid "Incremental Encoding and Decoding"

msgstr "インクリメンタルなエンコードとデコード"

#: ../../library/codecs.rst:594

msgid ""

"The :class:`IncrementalEncoder` and :class:`IncrementalDecoder` classes "

"provide the basic interface for incremental encoding and decoding. Encoding/"

"decoding the input isn't done with one call to the stateless encoder/decoder "

"function, but with multiple calls to the :meth:`~IncrementalEncoder.encode`/:"

"meth:`~IncrementalDecoder.decode` method of the incremental encoder/decoder. "

"The incremental encoder/decoder keeps track of the encoding/decoding process "

"during method calls."

msgstr ""

":class:`IncrementalEncoder` クラスおよび :class:`IncrementalDecoder` クラスは"

"それぞれインクリメンタル・エンコードおよびデコードのための基本的なインター"

"フェースを提供します。エンコード／デコードは内部状態を持たないエンコーダ／デ"

"コーダを一度呼び出すことで行なわれるのではなく、インクリメンタル・エンコーダ"

"／デコーダの :meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder."

"decode` メソッドを複数回呼び出すことで行なわれます。インクリメンタル・エン"

"コーダ／デコーダはメソッド呼び出しの間エンコード／デコード処理の進行を管理し"

"ます。"

#: ../../library/codecs.rst:602

msgid ""

"The joined output of calls to the :meth:`~IncrementalEncoder.encode`/:meth:"

"`~IncrementalDecoder.decode` method is the same as if all the single inputs "

"were joined into one, and this input was encoded/decoded with the stateless "

"encoder/decoder."

msgstr ""

":meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder.decode` メソッ"

"ド呼び出しの出力結果をまとめたものは、入力をひとまとめにして内部状態を持たな"

"いエンコーダ／デコーダでエンコード／デコードしたものと同じになります。"

#: ../../library/codecs.rst:611

msgid "IncrementalEncoder Objects"

msgstr "IncrementalEncoder オブジェクト"

#: ../../library/codecs.rst:613

msgid ""

"The :class:`IncrementalEncoder` class is used for encoding an input in "

"multiple steps. It defines the following methods which every incremental "

"encoder must define in order to be compatible with the Python codec registry."

msgstr ""

":class:`IncrementalEncoder` クラスは入力を複数ステップでエンコードするのに使"

"われます。全てのインクリメンタル・エンコーダが Python codec レジストリと互換"

"性を持つために定義すべきメソッドとして、このクラスには以下のメソッドが定義さ"

"れています。"

#: ../../library/codecs.rst:620

msgid "Constructor for an :class:`IncrementalEncoder` instance."

msgstr ":class:`IncrementalEncoder` インスタンスのコンストラクタ。"

#: ../../library/codecs.rst:622

msgid ""

"All incremental encoders must provide this constructor interface. They are "

"free to add additional keyword arguments, but only the ones defined here are "

"used by the Python codec registry."

msgstr ""

"全てのインクリメンタル・エンコーダはこのコンストラクタインターフェースを提供"

"しなければなりません。さらにキーワード引数を付け加えるのは構いませんが、"

"Python codec レジストリで利用されるのはここで定義されているものだけです。"

#: ../../library/codecs.rst:626

msgid ""

"The :class:`IncrementalEncoder` may implement different error handling "

"schemes by providing the *errors* keyword argument. See :ref:`error-"

"handlers` for possible values."

msgstr ""

":class:`IncrementalEncoder` は、 *errors* キーワード引数を提供することで、"

"様々なエラー取扱方法を実装することができます。取り得る値については :ref:"

"`error-handlers` を参照してください。"

#: ../../library/codecs.rst:630

msgid ""

"The *errors* argument will be assigned to an attribute of the same name. "

"Assigning to this attribute makes it possible to switch between different "

"error handling strategies during the lifetime of the :class:"

"`IncrementalEncoder` object."

msgstr ""

"*errors* 引数は、同名の属性に代入されます。この属性を変更すると、 :class:"

"`IncrementalEncoder` オブジェクトが生きている間に、異なるエラー処理方法に切り"

"替えることができるようになります。"

#: ../../library/codecs.rst:638

msgid ""

"Encodes *object* (taking the current state of the encoder into account) and "

"returns the resulting encoded object. If this is the last call to :meth:"

"`encode` *final* must be true (the default is false)."

msgstr ""

"*object* を(エンコーダの現在の状態を考慮に入れて)エンコードし、得られたエン"

"コードされたオブジェクトを返します。 :meth:`encode` 呼び出しがこれで最後とい"

"う時には *final* は真でなければなりません(デフォルトは偽です)。"

#: ../../library/codecs.rst:645

msgid ""

"Reset the encoder to the initial state. The output is discarded: call ``."

"encode(object, final=True)``, passing an empty byte or text string if "

"necessary, to reset the encoder and to get the output."

msgstr ""

"エンコーダを初期状態にリセットします。出力は破棄されます。``.encode(object, "