buffer.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2021, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
# tomo, 2017
# 秘湯 <xwhhsprings@gmail.com>, 2016
msgid ""
msgstr ""
"Project-Id-Version: Python 2.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-01 01:01+0900\n"
"PO-Revision-Date: 2018-12-19 22:58+0000\n"
"Last-Translator: tomo\n"
"Language-Team: Japanese (http://www.transifex.com/python-doc/python-27/"
"language/ja/)\n"
"Language: ja\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../c-api/buffer.rst:6
msgid "Buffers and Memoryview Objects"
msgstr "buffer オブジェクトと memoryview オブジェクト"

#: ../../c-api/buffer.rst:16
msgid ""
"Python objects implemented in C can export a group of functions called the "
"\"buffer interface.\"  These functions can be used by an object to expose "
"its data in a raw, byte-oriented format. Clients of the object can use the "
"buffer interface to access the object data directly, without needing to copy "
"it first."
msgstr ""
"C で実装された Python オブジェクトは、\"バッファインタフェース (buffer "
"interface)\" と呼ばれる一連の関数を公開していることがあります。これらの関数"
"は、あるオブジェクトのデータを生 (raw) のバイト列形式で公開するために使いま"
"す。このオブジェクトの使い手は、バッファインタフェースを使うことで、オブジェ"
"クトをあらかじめコピーしておく必要なしに、オブジェクトのデータに直接アクセス"
"できます。"

#: ../../c-api/buffer.rst:22
msgid ""
"Two examples of objects that support the buffer interface are strings and "
"arrays. The string object exposes the character contents in the buffer "
"interface's byte-oriented form. An array can only expose its contents via "
"the old-style buffer interface. This limitation does not apply to Python 3, "
"where :class:`memoryview` objects can be constructed from arrays, too. Array "
"elements may be multi-byte values."
msgstr ""
"バッファインタフェースをサポートするオブジェクトの例として、文字列型とアレイ "
"(array) 型の二つがあります。文字列オブジェクトは、その内容をバッファインタ"
"フェースのバイト指向の形式で公開しています。アレイはその内容を旧スタイルバッ"
"ファインターフェイス経由でしか公開できません。この制限は :class:`memoryview` "
"オブジェクトをアレイから構築出来る Python 3 には適用されません。アレイの要素"
"は複数バイトの値になりえます。"

#: ../../c-api/buffer.rst:29
msgid ""
"An example user of the buffer interface is the file object's :meth:`write` "
"method. Any object that can export a series of bytes through the buffer "
"interface can be written to a file. There are a number of format codes to :c:"
"func:`PyArg_ParseTuple` that operate against an object's buffer interface, "
"returning data from the target object."
msgstr ""
"バッファインタフェースの使い手の一例として、ファイルオブジェクトの :meth:"
"`write` メソッドがあります。バッファインタフェースを介してバイト列を公開して"
"いるオブジェクトは全て、ファイルへの書き出しができます。オブジェクトのバッ"
"ファインタフェースを操作し、対象となるオブジェクトからデータを返させる :c:"
"func:`PyArg_ParseTuple` には数多くのデータ書式化コードがあります。"

#: ../../c-api/buffer.rst:35
msgid ""
"Starting from version 1.6, Python has been providing Python-level buffer "
"objects and a C-level buffer API so that any built-in or used-defined type "
"can expose its characteristics. Both, however, have been deprecated because "
"of various shortcomings, and have been officially removed in Python 3 in "
"favour of a new C-level buffer API and a new Python-level object named :"
"class:`memoryview`."
msgstr ""
"バージョン 1.6 から、Python は Python レベルのバッファオブジェクトと、 C 言語"
"レベルのバッファ API を提供しており、任意のビルトイン型やユーザー定義型はその"
"文字列表現を公開することができます。しかし、両方共、幾つかの欠点のために廃止"
"予定扱いされていて、 Python 3 では公式に削除され、新しい C 言語レベルのバッ"
"ファ API と新しい Python レベルの :class:`memoryview` という名前のオブジェク"
"トに置き換えられています。"

#: ../../c-api/buffer.rst:42
msgid ""
"The new buffer API has been backported to Python 2.6, and the :class:"
"`memoryview` object has been backported to Python 2.7. It is strongly "
"advised to use them rather than the old APIs, unless you are blocked from "
"doing so for compatibility reasons."
msgstr ""
"新しいバッファ API は Python 2.6 に逆移植されており、 :class:`memoryviews` オ"
"ブジェクトは Python 2.7 に逆移植されています。古いバージョンとの互換性が必要"
"なければ、古いAPIの代わりにこれらを使うことをおすすめします。"

#: ../../c-api/buffer.rst:49
msgid "The new-style Py_buffer struct"
msgstr "新スタイル Py_buffer 構造体"

#: ../../c-api/buffer.rst:56
msgid "A pointer to the start of the memory for the object."
msgstr "オブジェクトのメモリの開始位置へのポインタ"

#: ../../c-api/buffer.rst:61
msgid "The total length of the memory in bytes."
msgstr "メモリのトータルサイズ [byte]"

#: ../../c-api/buffer.rst:65
msgid "An indicator of whether the buffer is read only."
msgstr "バッファが読み込み専用かどうかを示す"

#: ../../c-api/buffer.rst:70
msgid ""
"A *NULL* terminated string in :mod:`struct` module style syntax giving the "
"contents of the elements available through the buffer.  If this is *NULL*, "
"``\"B\"`` (unsigned bytes) is assumed."
msgstr ""
"バッファを通してアクセスできる要素の形式を指定する、 :mod:`struct` モジュール"
"スタイル文法の、 *NULL* 終端文字列。このポインタの値が *NULL* なら、 "
"``\"B\"`` (符号無しバイト) として扱われます。"

#: ../../c-api/buffer.rst:76
msgid ""
"The number of dimensions the memory represents as a multi-dimensional "
"array.  If it is ``0``, :c:data:`strides` and :c:data:`suboffsets` must be "
"*NULL*."
msgstr ""
"メモリが多次元配列を表している時の次元数。 ``0`` の場合、 :c:data:`strides` "
"と :c:data:`suboffsets` は *NULL* でなければなりません。"

#: ../../c-api/buffer.rst:82
msgid ""
"An array of :c:type:`Py_ssize_t`\\s the length of :c:data:`ndim` giving the "
"shape of the memory as a multi-dimensional array.  Note that ``((*shape)[0] "
"* ... * (*shape)[ndims-1])*itemsize`` should be equal to :c:data:`len`."
msgstr ""
"メモリが多次元配列を表しているとき、その形を示す長さ :c:data:`ndim` の :c:"
"type:`Py_ssize_t` の配列。 ``((*shape)[0] * ... * (*shape)"
"[ndims-1])*itemsize`` は :c:data:`len` と等しくなければならないことに気をつけ"
"てください。"

#: ../../c-api/buffer.rst:89
msgid ""
"An array of :c:type:`Py_ssize_t`\\s the length of :c:data:`ndim` giving the "
"number of bytes to skip to get to a new element in each dimension."
msgstr ""
"各次元で次の要素を得るためにスキップするバイト数を示す、長さ :c:data:`ndim` "
"の :c:type:`Py_ssize_t` の配列。"

#: ../../c-api/buffer.rst:94
msgid ""
"An array of :c:type:`Py_ssize_t`\\s the length of :c:data:`ndim`.  If these "
"suboffset numbers are greater than or equal to 0, then the value stored "
"along the indicated dimension is a pointer and the suboffset value dictates "
"how many bytes to add to the pointer after de-referencing. A suboffset value "
"that it negative indicates that no de-referencing should occur (striding in "
"a contiguous memory block)."
msgstr ""
"長さ :c:data:`ndim` の :c:type:`Py_ssize_t` の配列。 suboffset の各数値が 0 "
"以上であるとき、その次元に格納されているのはポインタで、 suboffset の値はその"
"ポインタの参照を解決するときに何バイトのオフセットを足すかを示しています。 "
"suboffset に負の数が格納されているときは、参照解決が不要であること (連続した"
"メモリブロック内に直接配置されていること)を意味しています。"

#: ../../c-api/buffer.rst:101
msgid ""
"If all suboffsets are negative (i.e. no de-referencing is needed), then this "
"field must be NULL (the default value)."
msgstr ""
"全ての suboffset が負数の場合 (つまり参照解決が不要) な場合、このフィールド"
"は NULL (デフォルト値) でなければなりません。"

#: ../../c-api/buffer.rst:104
msgid ""
"Here is a function that returns a pointer to the element in an N-D array "
"pointed to by an N-dimensional index when there are both non-NULL strides "
"and suboffsets::"
msgstr ""
"次の例は、 strides も suboffsets も NULL でない場合の、N 次元インデックスに"
"よって指されている N 次元配列内の要素へのポインタを返す関数です。 ::"

#: ../../c-api/buffer.rst:124
msgid ""
"This is a storage for the itemsize (in bytes) of each element of the shared "
"memory. It is technically un-necessary as it can be obtained using :c:func:"
"`PyBuffer_SizeFromFormat`, however an exporter may know this information "
"without parsing the format string and it is necessary to know the itemsize "
"for proper interpretation of striding. Therefore, storing it is more "
"convenient and faster."
msgstr ""
"これは共有メモリ上の各要素のbyte単位のサイズを格納する変数です。これは :c:"
"func:`PyBuffer_SizeFromFormat` を使って計算できる値なので技術的には不要なので"
"すが、バッファを提供する側はフォーマット文字列を解析しなくてもこの情報を知っ"
"ているでしょうし、バッファを受け取る側にとっては正しく解釈するのに必要な情報"
"です。なので、要素サイズを格納するほうが便利ですし高速です。"

#: ../../c-api/buffer.rst:133
msgid ""
"This is for use internally by the exporting object. For example, this might "
"be re-cast as an integer by the exporter and used to store flags about "
"whether or not the shape, strides, and suboffsets arrays must be freed when "
"the buffer is released. The consumer should never alter this value."
msgstr ""
"バッファを提供する側のオブジェクトが内部的に利用するための変数です。例えば、"
"提供側はこの変数に整数型をキャストして、 shape, strides, suboffsets といった"
"配列をバッファを解放するときに同時に解放するべきかどうかを管理するフラグに使"
"うことができるでしょう。バッファを受け取る側は、この値を変更してはなりませ"
"ん。"

#: ../../c-api/buffer.rst:141
msgid "Buffer related functions"
msgstr "バッファ関連関数"

#: ../../c-api/buffer.rst:146
msgid "Return ``1`` if *obj* supports the buffer interface otherwise ``0``."
msgstr ""
"*obj* がバッファインタフェースをサポートしている場合に ``1`` を、それ以外の場"
"合に ``0`` を返します。"

#: ../../c-api/buffer.rst:151
msgid ""
"Export *obj* into a :c:type:`Py_buffer`, *view*.  These arguments must never "
"be *NULL*.  The *flags* argument is a bit field indicating what kind of "
"buffer the caller is prepared to deal with and therefore what kind of buffer "
"the exporter is allowed to return.  The buffer interface allows for "
"complicated memory sharing possibilities, but some caller may not be able to "
"handle all the complexity but may want to see if the exporter will let them "
"take a simpler view to its memory."
msgstr ""
"*obj* を :c:type:`Py_buffer` *view* へエクスポートします。これらの引数は "
"*NULL* であってはなりません。 *flag* 引数は呼び出し側がどんなバッファを扱おう"
"としているのか、バッファ提供側がどんなバッファを返すことが許されているのかを"
"示す、ビットフィールドです。バッファインタフェースは複雑なメモリ共有を可能に"
"していますが、呼び出し元はすべての複雑なバッファを扱えるとは限らず、バッファ"
"提供側がシンプルなビューを提供できるならそれを利用したいとかもしれません。"

#: ../../c-api/buffer.rst:159
msgid ""
"Some exporters may not be able to share memory in every possible way and may "
"need to raise errors to signal to some consumers that something is just not "
"possible. These errors should be a :exc:`BufferError` unless there is "
"another error that is actually causing the problem. The exporter can use "
"flags information to simplify how much of the :c:data:`Py_buffer` structure "
"is filled in with non-default values and/or raise an error if the object "
"can't support a simpler view of its memory."
msgstr ""
"バッファ提供側はすべての方法でメモリを共有できるとは限らず、呼び出し側に何か"
"が不可能であることを伝えるためにエラーを発生させる必要があるかもしれません。"
"その場合のエラーは、もしその問題を実際に引き起こしているのが別のエラーだった"
"としても、 :exc:`BufferError` でなければなりません。バッファ提供側は flag の"
"情報を使って :c:data:`Py_buffer` 構造体のどのフィールドへの非デフォルト値の設"
"定を省略したり、要求されたシンプルな view を提供できない場合はエラーを発生さ"
"せたりすることができます。"

#: ../../c-api/buffer.rst:167
msgid "``0`` is returned on success and ``-1`` on error."
msgstr "成功したら ``0`` が、エラー時には ``-1`` が返されます。"

#: ../../c-api/buffer.rst:169
msgid "The following table gives possible values to the *flags* arguments."
msgstr "次のテーブルは、 *flags* 引数が取りうる値です。"

#: ../../c-api/buffer.rst:172
msgid "Flag"
msgstr "Flag"

#: ../../c-api/buffer.rst:172
msgid "Description"
msgstr "説明"

#: ../../c-api/buffer.rst:174
msgid ":c:macro:`PyBUF_SIMPLE`"
msgstr ":c:macro:`PyBUF_SIMPLE`"

#: ../../c-api/buffer.rst:174
msgid ""
"This is the default flag state.  The returned buffer may or may not have "
"writable memory.  The format of the data will be assumed to be unsigned "
"bytes.  This is a \"stand-alone\" flag constant. It never needs to be '|'d "
"to the others. The exporter will raise an error if it cannot provide such a "
"contiguous buffer of bytes."
msgstr ""
"これはデフォルトの flag の状態です。結果のバッファは書き込み可能かもしれませ"
"んし、不可能かもしれません。データのフォーマットは unsigned byte とします。こ"
"れは \"スタンドアロン\" のフラグ定数です。他の定数と '|' を取る必要はありませ"
"ん。提供側はこのような連続したバイト列のバッファを提供できない場合に、エラー"
"を発生させるかもしれません。"

#: ../../c-api/buffer.rst:183
msgid ":c:macro:`PyBUF_WRITABLE`"
msgstr ":c:macro:`PyBUF_WRITABLE`"

#: ../../c-api/buffer.rst:183
msgid ""
"The returned buffer must be writable.  If it is not writable, then raise an "
"error."
msgstr ""
"結果のバッファは書込み可能でなければなりません。書き込み不可能な場合はエラー"
"を発生させます。"

#: ../../c-api/buffer.rst:186
msgid ":c:macro:`PyBUF_STRIDES`"
msgstr ":c:macro:`PyBUF_STRIDES`"

#: ../../c-api/buffer.rst:186
msgid ""
"This implies :c:macro:`PyBUF_ND`. The returned buffer must provide strides "
"information (i.e. the strides cannot be NULL). This would be used when the "
"consumer can handle strided, discontiguous arrays.  Handling strides "
"automatically assumes you can handle shape.  The exporter can raise an error "
"if a strided representation of the data is not possible (i.e. without the "
"suboffsets)."
msgstr ""
"この値は :c:macro:`PyBUF_ND` を含みます。バッファは strides 情報を提供しなけ"
"ればなりません。 (言い換えると、 strides は NULL であってはいけません。) この"
"フラグは、呼び出し元が、要素間に隙間のある不連続な配列を扱えるときに使われま"
"す。 strides を扱うことは、自動的に shape も扱えることを要求されます。提供側"
"は stride 形式のバッファを提供できないとき(例えば、 suboffset が必要な場合)は"
"エラーを発生させます。"

#: ../../c-api/buffer.rst:196
msgid ":c:macro:`PyBUF_ND`"
msgstr ":c:macro:`PyBUF_ND`"

#: ../../c-api/buffer.rst:196
msgid ""
"The returned buffer must provide shape information. The memory will be "
"assumed C-style contiguous (last dimension varies the fastest). The exporter "
"may raise an error if it cannot provide this kind of contiguous buffer. If "
"this is not given then shape will be *NULL*."
msgstr ""
"バッファは shape 情報を提供しなければなりません。メモリは C スタイルの並び "
"(最後の次元が一番高速) だと仮定されます。提供側はこの種類の連続バッファを提供"
"できない場合はエラーを発生させます。このフラグが指定されていな場合は shape "
"は *NULL* になります。"

#: ../../c-api/buffer.rst:206
msgid ""
":c:macro:`PyBUF_C_CONTIGUOUS` :c:macro:`PyBUF_F_CONTIGUOUS` :c:macro:"
"`PyBUF_ANY_CONTIGUOUS`"
msgstr ""
":c:macro:`PyBUF_C_CONTIGUOUS` :c:macro:`PyBUF_F_CONTIGUOUS` :c:macro:"
"`PyBUF_ANY_CONTIGUOUS`"

#: ../../c-api/buffer.rst:206
msgid ""
"These flags indicate that the contiguity returned buffer must be "
"respectively, C-contiguous (last dimension varies the fastest), Fortran "
"contiguous (first dimension varies the fastest) or either one.  All of these "
"flags imply :c:macro:`PyBUF_STRIDES` and guarantee that the strides buffer "
"info structure will be filled in correctly."
msgstr ""
"これらのフラグは、返されるバッファの並びを指定します。それぞれ、C並び(最後の"
"次元が一番高速)、Fortran並び(最初の次元が一番高速), そのどちらでも、を意味し"
"ます。これらのフラグは :c:macro:`PyBUF_STRIDES` を含んでおり、 strides 情報が"
"正しく格納されていることを保証します。"

#: ../../c-api/buffer.rst:216
msgid ":c:macro:`PyBUF_INDIRECT`"
msgstr ":c:macro:`PyBUF_INDIRECT`"

#: ../../c-api/buffer.rst:216
msgid ""
"This flag indicates the returned buffer must have suboffsets information "
"(which can be NULL if no suboffsets are needed).  This can be used when the "
"consumer can handle indirect array referencing implied by these suboffsets. "
"This implies :c:macro:`PyBUF_STRIDES`."
msgstr ""
"このフラグは、返されるバッファが suboffsets 情報を含んでいることを示します。"
"(suboffsets が必要無いときは NULL でもかまいません。) このフラグは、バッファ"
"利用側が suboffsets を使って参照されている間接配列を扱えるときに利用されま"
"す。このフラグは :c:macro:`PyBUF_STRIDES` を含みます。"

#: ../../c-api/buffer.rst:226
msgid ":c:macro:`PyBUF_FORMAT`"
msgstr ":c:macro:`PyBUF_FORMAT`"

#: ../../c-api/buffer.rst:226
msgid ""
"The returned buffer must have true format information if this flag is "
"provided. This would be used when the consumer is going to be checking for "
"what 'kind' of data is actually stored. An exporter should always be able to "
"provide this information if requested. If format is not explicitly requested "
"then the format must be returned as *NULL* (which means ``'B'``, or unsigned "
"bytes)"
msgstr ""
"返されるバッファは正しい format 情報を持っていなければなりません。このフラグ"
"は、バッファ利用側が実際に格納されているデータの '種類' をチェックするときに"
"利用します。バッファ提供側は、要求された場合は常にこの情報を提供できるべきで"
"す。 format が明示的に要求されていない場合は format は *NULL* (``'B'``, "
"unsigned byte を意味する)であるべきです。"

#: ../../c-api/buffer.rst:236
msgid ":c:macro:`PyBUF_STRIDED`"
msgstr ":c:macro:`PyBUF_STRIDED`"

#: ../../c-api/buffer.rst:236
msgid "This is equivalent to ``(PyBUF_STRIDES | PyBUF_WRITABLE)``."
msgstr "``(PyBUF_STRIDES | PyBUF_WRITABLE)`` と同じ"

#: ../../c-api/buffer.rst:239
msgid ":c:macro:`PyBUF_STRIDED_RO`"
msgstr ":c:macro:`PyBUF_STRIDED_RO`"

#: ../../c-api/buffer.rst:239
msgid "This is equivalent to ``(PyBUF_STRIDES)``."
msgstr "``(PyBUF_STRIDES)`` と同じ"

#: ../../c-api/buffer.rst:242
msgid ":c:macro:`PyBUF_RECORDS`"
msgstr ":c:macro:`PyBUF_RECORDS`"

#: ../../c-api/buffer.rst:242
msgid ""
"This is equivalent to ``(PyBUF_STRIDES | PyBUF_FORMAT | PyBUF_WRITABLE)``."
msgstr "``(PyBUF_STRIDES | PyBUF_FORMAT | PyBUF_WRITABLE)`` と同じ"

#: ../../c-api/buffer.rst:245
msgid ":c:macro:`PyBUF_RECORDS_RO`"
msgstr ":c:macro:`PyBUF_RECORDS_RO`"

#: ../../c-api/buffer.rst:245
msgid "This is equivalent to ``(PyBUF_STRIDES | PyBUF_FORMAT)``."
msgstr "``(PyBUF_STRIDES | PyBUF_FORMAT)`` と同じ"

#: ../../c-api/buffer.rst:248
msgid ":c:macro:`PyBUF_FULL`"
msgstr ":c:macro:`PyBUF_FULL`"

#: ../../c-api/buffer.rst:248
msgid ""
"This is equivalent to ``(PyBUF_INDIRECT | PyBUF_FORMAT | PyBUF_WRITABLE)``."
msgstr "``(PyBUF_INDIRECT | PyBUF_FORMAT | PyBUF_WRITABLE)`` と同じ"

#: ../../c-api/buffer.rst:251
msgid ":c:macro:`PyBUF_FULL_RO`"
msgstr ":c:macro:`PyBUF_FULL_RO`"

#: ../../c-api/buffer.rst:251
msgid "This is equivalent to ``(PyBUF_INDIRECT | PyBUF_FORMAT)``."
msgstr "``(PyBUF_INDIRECT | PyBUF_FORMAT)`` と同じ"

#: ../../c-api/buffer.rst:254
msgid ":c:macro:`PyBUF_CONTIG`"
msgstr ":c:macro:`PyBUF_CONTIG`"

#: ../../c-api/buffer.rst:254
msgid "This is equivalent to ``(PyBUF_ND | PyBUF_WRITABLE)``."
msgstr "``(PyBUF_ND | PyBUF_WRITABLE)`` と同じ"

#: ../../c-api/buffer.rst:257
msgid ":c:macro:`PyBUF_CONTIG_RO`"
msgstr ":c:macro:`PyBUF_CONTIG_RO`"

#: ../../c-api/buffer.rst:257
msgid "This is equivalent to ``(PyBUF_ND)``."
msgstr "``(PyBUF_ND)`` と同じ"

#: ../../c-api/buffer.rst:264
msgid ""
"Release the buffer *view*.  This should be called when the buffer is no "
"longer being used as it may free memory from it."
msgstr ""
"*view* バッファを解放します。バッファが利用されなくなったときに、そのメモリを"
"解放できるようにこの関数を呼び出すべきです。"

#: ../../c-api/buffer.rst:270
msgid ""
"Return the implied :c:data:`~Py_buffer.itemsize` from the struct-stype :c:"
"data:`~Py_buffer.format`."
msgstr ""
":c:data:`~Py_buffer.itemsize` の値を :c:data:`~PyBuffer.format` から計算して"
"返します。"

#: ../../c-api/buffer.rst:276
msgid ""
"Return ``1`` if the memory defined by the *view* is C-style (*fortran* is "
"``'C'``) or Fortran-style (*fortran* is ``'F'``) contiguous or either one "
"(*fortran* is ``'A'``).  Return ``0`` otherwise."
msgstr ""
"*view* で定義されているメモリが、 C スタイル (*fortran* == ``'C'``) のとき"
"か、 Fortran スタイル (*fortran* == ``'F'``) のときか、そのいずれか "
"(*fortran* == ``'A'``) であれば ``1`` を返します。それ以外の場合は ``0`` を返"
"します。"

#: ../../c-api/buffer.rst:283
msgid ""
"Fill the *strides* array with byte-strides of a contiguous (C-style if "
"*fortran* is ``'C'`` or Fortran-style if *fortran* is ``'F'``) array of the "
"given shape with the given number of bytes per element."
msgstr ""
"*strides* 配列を、 *itemsize* の大きさの要素がバイト単位で連続した、 *shape* "
"の形をした (*fortran* が ``'C'`` なら C-style, ``'F'`` なら Fortran-style "
"の) 多次元配列として埋める。"

#: ../../c-api/buffer.rst:290
msgid ""
"Fill in a buffer-info structure, *view*, correctly for an exporter that can "
"only share a contiguous chunk of memory of \"unsigned bytes\" of the given "
"length.  Return ``0`` on success and ``-1`` (with raising an error) on error."
msgstr ""
"バッファ提供側が与えられた長さの \"unsigned bytes\" の連続した1つのメモリブ"
"ロックしか提供できないものとして、 *view* バッファ情報構造体を正しく埋める。"
"成功したら ``0`` を、エラー時には (例外を発生させつつ) ``-1`` を返す。"

#: ../../c-api/buffer.rst:296
msgid "MemoryView objects"
msgstr "memoryview オブジェクト"

#: ../../c-api/buffer.rst:300
msgid ""
"A :class:`memoryview` object exposes the new C level buffer interface as a "
"Python object which can then be passed around like any other object."
msgstr ""
":class:`memoryview` オブジェクトは、新しい、他のオブジェクトと同じように扱え"
"る Python オブジェクトの形をした C言語レベルのバッファへのインタフェースで"
"す。"

#: ../../c-api/buffer.rst:305
msgid ""
"Create a memoryview object from an object that defines the new buffer "
"interface."
msgstr ""
"新しいバッファインタフェースを定義しているオブジェクトから memoryview オブ"
"ジェクトを作ります。"

#: ../../c-api/buffer.rst:311
msgid ""
"Create a memoryview object wrapping the given buffer-info structure *view*. "
"The memoryview object then owns the buffer, which means you shouldn't try to "
"release it yourself: it will be released on deallocation of the memoryview "
"object."
msgstr ""
"buffer-info 構造体 *view* をラップする memoryview オブジェクトを作ります。作"
"られた memoryview オブジェクトはバッファを所有することになるので、 *view* を"
"解放してはいけません。このバッファは memoryview オブジェクトが削除されるとき"
"に解放されます。"

#: ../../c-api/buffer.rst:319
msgid ""
"Create a memoryview object to a contiguous chunk of memory (in either 'C' or "
"'F'ortran *order*) from an object that defines the buffer interface. If "
"memory is contiguous, the memoryview object points to the original memory. "
"Otherwise copy is made and the memoryview points to a new bytes object."
msgstr ""
"buffer インタフェースを定義しているオブジェクトから ('C' か 'F'ortran の "
"*order* で) 連続したメモリチャンクへの memoryview オブジェクトを作ります。メ"
"モリが連続している場合、 memoryview オブジェクトは元のメモリを参照します。そ"
"れ以外の場合、メモリはコピーされて、 memoryview オブジェクトは新しい bytes オ"
"ブジェクトを参照します。"

#: ../../c-api/buffer.rst:328
msgid ""
"Return true if the object *obj* is a memoryview object.  It is not currently "
"allowed to create subclasses of :class:`memoryview`."
msgstr ""
"*obj* が memoryview オブジェクトの場合に真を返します。現在のところ、 :class:"
"`memoryview` のサブクラスの作成は許可されていません。"

#: ../../c-api/buffer.rst:334
msgid ""
"Return a pointer to the buffer-info structure wrapped by the given object.  "
"The object **must** be a memoryview instance; this macro doesn't check its "
"type, you must do it yourself or you will risk crashes."
msgstr ""
"与えられたオブジェクトにラップされた buffer-info 構造体へのポインタを返しま"
"す。オブジェクトは memoryview インスタンスで **なければなりません** 。このマ"
"クロはオブジェクトの型をチェックしないので、呼び出し側で保証しなければクラッ"
"シュする可能性があります。"

#: ../../c-api/buffer.rst:340
msgid "Old-style buffer objects"
msgstr "旧スタイルバッファオブジェクト"

#: ../../c-api/buffer.rst:344
msgid ""
"More information on the old buffer interface is provided in the section :ref:"
"`buffer-structs`, under the description for :c:type:`PyBufferProcs`."
msgstr ""
"古いバッファインタフェースに関するより詳しい情報は、 \"バッファオブジェクト構"
"造体\" 節 ( :ref:`buffer-structs` 節) の、 :c:type:`PyBufferProcs` の説明のと"
"ころにあります。"

#: ../../c-api/buffer.rst:347
msgid ""
"A \"buffer object\" is defined in the :file:`bufferobject.h` header "
"(included by :file:`Python.h`). These objects look very similar to string "
"objects at the Python programming level: they support slicing, indexing, "
"concatenation, and some other standard string operations. However, their "
"data can come from one of two sources: from a block of memory, or from "
"another object which exports the buffer interface."
msgstr ""
"\"バッファオブジェクト\" はヘッダファイル :file:`bufferobject.h` の中で定義さ"
"れています (このファイルは :file:`Python.h` がインクルードしています)。バッ"
"ファオブジェクトは、 Python プログラミングのレベルからは文字列オブジェクトと"
"非常によく似ているように見えます: スライス、インデックス指定、結合、その他標"
"準の文字列操作をサポートしています。しかし、バッファオブジェクトのデータは二"
"つのデータソース: 何らかのメモリブロックか、バッファインタフェースを公開して"
"いる別のオブジェクト、のいずれかに由来しています。"

#: ../../c-api/buffer.rst:354
msgid ""
"Buffer objects are useful as a way to expose the data from another object's "
"buffer interface to the Python programmer. They can also be used as a zero-"
"copy slicing mechanism. Using their ability to reference a block of memory, "
"it is possible to expose any data to the Python programmer quite easily. The "
"memory could be a large, constant array in a C extension, it could be a raw "
"block of memory for manipulation before passing to an operating system "
"library, or it could be used to pass around structured data in its native, "
"in-memory format."
msgstr ""
"バッファオブジェクトは、他のオブジェクトのバッファインタフェースから Python "
"プログラマにデータを公開する方法として便利です。バッファオブジェクトはゼロコ"
"ピーなスライス機構 (zero-copy slicing mechanism) としても使われます。ブロック"
"メモリを参照するというバッファオブジェクトの機能を使うことで、任意のデータを"
"きわめて簡単に Python プログラマに公開できます。メモリブロックは巨大でもかま"
"いませんし、C 拡張モジュール内の定数配列でもかまいません。また、オペレーティ"
"ングシステムライブラリ側に渡す前の、操作用の生のブロックメモリでもかまいませ"
"んし、構造化されたデータをネイティブのメモリ配置形式でやりとりするためにも使"
"えます。"

#: ../../c-api/buffer.rst:366
msgid "This subtype of :c:type:`PyObject` represents a buffer object."
msgstr ""
"この :c:type:`PyObject` のサブタイプはバッファオブジェクトを表現します。"

#: ../../c-api/buffer.rst:373
msgid ""
"The instance of :c:type:`PyTypeObject` which represents the Python buffer "
"type; it is the same object as ``buffer`` and  ``types.BufferType`` in the "
"Python layer. ."
msgstr ""
"Python バッファ型 (buffer type) を表現する :c:type:`PyTypeObject` です; "
"Python レイヤにおける ``buffer`` や ``types.BufferType`` と同じオブジェクトで"
"す。"

#: ../../c-api/buffer.rst:380
msgid ""
"This constant may be passed as the *size* parameter to :c:func:"
"`PyBuffer_FromObject` or :c:func:`PyBuffer_FromReadWriteObject`.  It "
"indicates that the new :c:type:`PyBufferObject` should refer to *base* "
"object from the specified *offset* to the end of its exported buffer. Using "
"this enables the caller to avoid querying the *base* object for its length."
msgstr ""
"この定数は、 :c:func:`PyBuffer_FromObject` や :c:func:"
"`PyBuffer_FromReadWriteObject` に *size* パラメタとして渡します。このパラメタ"
"を渡すと、 :c:type:`PyBufferObject` は指定された *offset* からバッファの終わ"
"りまでを *base* オブジェクトとして参照します。このパラメタを使うことで、関数"
"の呼び出し側が *base* オブジェクトのサイズを調べる必要がなくなります。"

#: ../../c-api/buffer.rst:390
msgid "Return true if the argument has type :c:data:`PyBuffer_Type`."
msgstr "引数が :c:data:`PyBuffer_Type` 型のときに真を返します。"

#: ../../c-api/buffer.rst:395
msgid ""
"Return a new read-only buffer object.  This raises :exc:`TypeError` if "
"*base* doesn't support the read-only buffer protocol or doesn't provide "
"exactly one buffer segment, or it raises :exc:`ValueError` if *offset* is "
"less than zero.  The buffer will hold a reference to the *base* object, and "
"the buffer's contents will refer to the *base* object's buffer interface, "
"starting as position *offset* and extending for *size* bytes. If *size* is :"
"const:`Py_END_OF_BUFFER`, then the new buffer's contents extend to the "
"length of the *base* object's exported buffer data."
msgstr ""
"新たな読み出し専用バッファオブジェクトを返します。 *base* が読み出し専用バッ"
"ファに必要なバッファプロトコルをサポートしていない場合や、厳密に一つのバッ"
"ファセグメントを提供していない場合には :exc:`TypeError` を送出し、 *offset* "
"がゼロ以下の場合には :exc:`ValueError` を送出します。バッファオブジェクトは "
"*base* オブジェクトに対する参照を保持し、バッファオブジェクトの内容は *base* "
"オブジェクトの *offset* から *size* バイトのバッファインタフェースへの参照に"
"なります。 *size* が :const:`Py_END_OF_BUFFER` の場合、新たに作成するバッファ"
"オブジェクトの内容は *base* から公開されているバッファの末尾までにわたりま"
"す。"

#: ../../c-api/buffer.rst:404 ../../c-api/buffer.rst:416
msgid ""
"This function used an :c:type:`int` type for *offset* and *size*. This might "
"require changes in your code for properly supporting 64-bit systems."
msgstr ""
"この関数は以前は *offset*, *size* の型に :c:type:`int` を利用していました。こ"
"の変更により、 64bit システムを正しくサポートするには修正が必要になります。"

#: ../../c-api/buffer.rst:412
msgid ""
"Return a new writable buffer object.  Parameters and exceptions are similar "
"to those for :c:func:`PyBuffer_FromObject`.  If the *base* object does not "
"export the writeable buffer protocol, then :exc:`TypeError` is raised."
msgstr ""
"新たな書き込み可能バッファオブジェクトを返します。パラメタおよび例外は :c:"
"func:`PyBuffer_FromObject` と同じです。 *base* オブジェクトが書き込み可能バッ"
"ファに必要なバッファプロトコルを公開していない場合、 :exc:`TypeError` を送出"
"します。"

#: ../../c-api/buffer.rst:424
msgid ""
"Return a new read-only buffer object that reads from a specified location in "
"memory, with a specified size.  The caller is responsible for ensuring that "
"the memory buffer, passed in as *ptr*, is not deallocated while the returned "
"buffer object exists.  Raises :exc:`ValueError` if *size* is less than "
"zero.  Note that :const:`Py_END_OF_BUFFER` may *not* be passed for the "
"*size* parameter; :exc:`ValueError` will be raised in that case."
msgstr ""
"メモリ上の指定された場所から指定されたサイズのデータを読み出せる、新たな読み"
"出し専用バッファオブジェクトを返します。この関数が返すバッファオブジェクトが"
"存続する間、 *ptr* で与えられたメモリバッファがデアロケートされないようにする"
"のは呼び出し側の責任です。 *size* がゼロ以下の場合には :exc:`ValueError` を送"
"出します。 *size* には :const:`Py_END_OF_BUFFER` を指定しては *いけません* ; "
"指定すると、 :exc:`ValueError` を送出します。"

#: ../../c-api/buffer.rst:431 ../../c-api/buffer.rst:441
#: ../../c-api/buffer.rst:453
msgid ""
"This function used an :c:type:`int` type for *size*. This might require "
"changes in your code for properly supporting 64-bit systems."
msgstr ""
"この関数は以前は *size* の型に :c:type:`int` を利用していました。この変更によ"
"り、 64bit システムを正しくサポートするには修正が必要になります。"

#: ../../c-api/buffer.rst:438
msgid ""
"Similar to :c:func:`PyBuffer_FromMemory`, but the returned buffer is "
"writable."
msgstr ""
":c:func:`PyBuffer_FromMemory` に似ていますが、書き込み可能なバッファを返しま"
"す。"

#: ../../c-api/buffer.rst:448
msgid ""
"Return a new writable buffer object that maintains its own memory buffer of "
"*size* bytes.  :exc:`ValueError` is returned if *size* is not zero or "
"positive.  Note that the memory buffer (as returned by :c:func:"
"`PyObject_AsWriteBuffer`) is not specifically aligned."
msgstr ""
"*size* バイトのメモリバッファを独自に維持する新たな書き込み可能バッファオブ"
"ジェクトを返します。 *size* がゼロまたは正の値でない場合、 :exc:`ValueError` "
"を送出します。( :c:func:`PyObject_AsWriteBuffer` が返すような) メモリバッファ"
"は特に整列されていないので注意して下さい。"