pytho****@googl*****
pytho****@googl*****
2011年 11月 5日 (土) 22:15:55 JST
Revision: a8e7f1f8173c Author: Naoki INADA <inada****@klab*****> Date: Sat Nov 5 06:15:05 2011 Log: Update 2.7.2: calendar, ctypes, mimetypes, platform, pyexpat, urllib2 http://code.google.com/p/python-doc-ja/source/detail?r=a8e7f1f8173c Modified: /library/calendar.rst /library/ctypes.rst /library/mimetypes.rst /library/platform.rst /library/pyexpat.rst /library/urllib2.rst ======================================= --- /library/calendar.rst Sun May 22 06:11:37 2011 +++ /library/calendar.rst Sat Nov 5 06:15:05 2011 @@ -23,6 +23,11 @@ proleptic Gregorian 暦に一致しており、同書では全ての計算の基礎となる暦とし ています。 [#]_ +.. seealso:: + + 最新バージョンの `calendar module Python source code + <http://svn.python.org/view/python/branches/release27-maint/Lib/calendar.py?view=markup>`_ + .. class:: Calendar([firstweekday]) :class:`Calendar` オブジェクトを作ります。 @@ -194,6 +199,13 @@ .. versionadded:: 2.5 +.. note:: + + これら2つのクラスの :meth:`formatweekday` と :meth:`formatmonthname` メ ソッドは、 + 一時的に現在の locale を指定された *locale* に変更します。 + 現在の locale はプロセス全体に影響するので、これらはスレッドセーフではあ りません。 + + 単純なテキストのカレンダーに関して、このモジュールには以下のような関数が提 供されています。 ======================================= --- /library/ctypes.rst Wed Apr 20 03:07:25 2011 +++ /library/ctypes.rst Sat Nov 5 06:15:05 2011 @@ -227,47 +227,54 @@ :mod:`ctypes` はたくさんの C と互換性のあるデータ型を定義しています : - +-----------------------+-----------------------------------+----------------------------+ - | ctypes の型 | C の型 | Python の 型 | - +=======================+===================================+============================+ - | :class:`c_char` | :c:type:`char` | 1文字の文 字列 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_wchar` | :c:type:`wchar_t` | 1文字のユ ニコード文字列 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_byte` | :c:type:`char` | 整数/長整 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_ubyte` | :c:type:`unsigned char` | 整数/長整 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_short` | :c:type:`short` | 整数/長整 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_ushort` | :c:type:`unsigned short` | 整数/長整 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_int` | :c:type:`int` | 整数/長整 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_uint` | :c:type:`unsigned int` | 整数/長整 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_long` | :c:type:`long` | 整数/長整 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_ulong` | :c:type:`unsigned long` | 整数/長整 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_longlong` | :c:type:`__int64` または | 整数/長整 数 | - | | :c:type:`long long` | | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_ulonglong` | :c:type:`unsigned __int64` または | 整数/長整 数 | - | | :c:type:`unsigned long long` | | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_float` | :c:type:`float` | 浮動小数点 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_double` | :c:type:`double` | 浮動小数点 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_longdouble` | :c:type:`longdouble` | 浮動小数点 数 | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_char_p` | :c:type:`char *` (NUL 終端) | 文字列また は ``None`` | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_wchar_p` | :c:type:`wchar_t *` (NUL 終端) | ユニコード または ``None`` | - +-----------------------+-----------------------------------+----------------------------+ - | :class:`c_void_p` | :c:type:`void *` | 整数/長整 数または ``None`` | - +-----------------------+-----------------------------------+----------------------------+ ++-----------------------+-----------------------------------+----------------------------+ +| ctypes の型 | C の型 | Python の 型 | ++=======================+===================================+============================+ +| :class:`c_bool` | :ctype:`_Bool` | bool (1) | ++----------------------+------------------------------------+----------------------------+ +| :class:`c_char` | :c:type:`char` | 1文字の文字 列 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_wchar` | :c:type:`wchar_t` | 1文字のユニ コード文字列 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_byte` | :c:type:`char` | 整数/長整 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_ubyte` | :c:type:`unsigned char` | 整数/長整 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_short` | :c:type:`short` | 整数/長整 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_ushort` | :c:type:`unsigned short` | 整数/長整 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_int` | :c:type:`int` | 整数/長整 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_uint` | :c:type:`unsigned int` | 整数/長整 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_long` | :c:type:`long` | 整数/長整 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_ulong` | :c:type:`unsigned long` | 整数/長整 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_longlong` | :c:type:`__int64` または | 整数/長整 数 | +| | :c:type:`long long` | | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_ulonglong` | :c:type:`unsigned __int64` または | 整数/長整 数 | +| | :c:type:`unsigned long long` | | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_float` | :c:type:`float` | 浮動小数点 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_double` | :c:type:`double` | 浮動小数点 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_longdouble` | :c:type:`longdouble` | 浮動小数点 数 | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_char_p` | :c:type:`char *` (NUL 終端) | 文字列または ``None`` | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_wchar_p` | :c:type:`wchar_t *` (NUL 終端) | ユニコードま たは ``None`` | ++-----------------------+-----------------------------------+----------------------------+ +| :class:`c_void_p` | :c:type:`void *` | 整数/長整数ま たは ``None`` | ++-----------------------+-----------------------------------+----------------------------+ + +.. x* + +(1) + コンストラクタは任意のオブジェクトをその真偽値として受け取ります。 これら全ての型はその型を呼び出すことによって作成でき、オプションとして @@ -2326,6 +2333,13 @@ C :c:type:`size_t` データ型を表します。 +.. class:: c_ssize_t + + C :c:type:`ssize_t` データ型を表します。 + + .. versionadded:: 2.7 + + .. class:: c_ubyte C :c:type:`unsigned char` データ型を表します。その値は小整数として解釈さ ======================================= --- /library/mimetypes.rst Fri May 14 07:12:50 2010 +++ /library/mimetypes.rst Sat Nov 5 06:15:05 2011 @@ -64,11 +64,15 @@ .. function:: init([files]) - 内部のデータ構造を初期化します。もし *files* が与えられていれば、これは デフォールトの型のマップを - 増やすために使われる、一連のファイル名でなければなりません。もし省略され ていれば、使われるファイル名は :const:`knownfiles` から - 取られます。 *file* あるいは :const:`knownfiles` 内の各ファイル名は、そ れ以前に現れる名前より優先されます。繰り返し - :func:`init` を呼び出すことは許されています。 - + 内部のデータ構造を初期化します。もし *files* が与えられていれば、 + これはデフォールトの type map を増やすために使われる、一連のファイル名で なければなりません。 + もし省略されていれば、使われるファイル名は :const:`knownfiles` から + 取られます。 Windows であれば、現在のレジストリの設定が読み込まれます。 + *file* あるいは :const:`knownfiles` 内の各ファイル名は、それ以前に現れる + 名前より優先されます。繰り返し :func:`init` を呼び出すことは許されていま す。 + + .. versionchanged:: 2.7 + 前のバージョンでは、 Windows のレジストリの設定は無視されていました。 .. function:: read_mime_types(filename) @@ -183,20 +187,32 @@ .. method:: MimeTypes.guess_extension(type[, strict]) - :func:`guess_extension` 関数と同様に、オブジェクトの一部として保存された テーブルを使用します。 + :func:`guess_extension` 関数と同様ですが、オブジェクトに保存されたテーブ ルを使用します。 + + +.. method:: MimeTypes.guess_all_extensions(type[, strict]) + + :func:`guess_all_extensions` と同様ですが、オブジェクトに保存されたテー ブルを参照します。 .. method:: MimeTypes.guess_type(url[, strict]) - :func:`guess_type` 関数と同様に、オブジェクトの一部として保存されたテー ブルを使用します。 + :func:`guess_type` 関数と同様ですが、オブジェクトに保存されたテーブルを 使用します。 .. method:: MimeTypes.read(path) - MIME情報を、 *path* という名のファイルからロードします。これはファイルを 解析するのに :meth:`readfp` を使用します。 + MIME情報を、 *path* という名のファイルからロードします。 + これはファイルを解析するのに :meth:`readfp` を使用します。 .. method:: MimeTypes.readfp(file) MIME型情報を、オープンしたファイルからロードします。ファイルは、標準 の :file:`mime.types` ファイルの形式でなければなりません。 + +.. method:: MimeTypes.read_windows_registry() + + MIME type 情報を Windows のレジストリから読み込みます。 Windows でのみ利 用できます。 + + .. versionadded:: 2.7 ======================================= --- /library/platform.rst Fri Jun 3 08:50:44 2011 +++ /library/platform.rst Sat Nov 5 06:15:05 2011 @@ -33,6 +33,16 @@ とんどのUnixプラットフォームと一部の非Unixプラットフォームで利用 可能ですが、 :file:`file` コマンドが利用できず、かつ *executable* が Pythonインタープリタでない場合には適切なデフォルト値が返ります。 + .. note:: + + Mac OS X (とひょっとすると他のプラットフォーム) では、実行可能ファイ ルは + 複数のアーキテクチャを含んだユニバーサル形式かもしれません。 + + 現在のインタプリタが "64-bit" であるかどうかを調べるに は、 :attr:`sys.maxsize` + の方が信頼できます。 :: + + is_64bits = sys.maxsize > 2**32 + .. function:: machine() @@ -89,7 +99,7 @@ are: 'CPython', 'IronPython', 'Jython' Python実装を指定する文字列を返します。 - 戻り値は: `CPython`, `IronPython`, `Jython` のいずれかです。 + 戻り値は: 'CPython', 'IronPython', 'Jython', 'PyPy' のいずれかです。 .. versionadded:: 2.6 @@ -178,14 +188,11 @@ .. note:: - この関数は、Mark Hammondの :mod:`win32all` がインストールされた環境で \ + この関数は、Mark Hammondの :mod:`win32all` がインストールされた環境で 良く動作しますが、Python 2.3 以上なら一応動作します。(Python 2.6から サポートされました) もちろん、この関数が使えるのはWin32互換プラットフォームのみです。 - .. todo:: - このnoteの意味があっているかどうか確認 - Win95/98 固有 ^^^^^^^^^^^^^ ======================================= --- /library/pyexpat.rst Sat Apr 16 17:12:19 2011 +++ /library/pyexpat.rst Sat Nov 5 06:15:05 2011 @@ -148,6 +148,13 @@ :attr:`ordered_attributes`, :attr:`returns_unicode`, :attr:`specified_attributes` が現在のパーザの値に設定されて生成されます。 +.. method:: xmlparser.SetParamEntityParsing(flag) + + パラメーターエンティティ (外部DTDサブセットを含む) の解析を制御します。 + *flag* の有効な値は、 :const:`XML_PARAM_ENTITY_PARSING_NEVER`, + :const:`XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE`, + :const:`XML_PARAM_ENTITY_PARSING_ALWAYS` です。 + flag の設定をしたら true を返します。 .. method:: xmlparser.UseForeignDTD([flag]) @@ -409,9 +416,11 @@ .. method:: xmlparser.NotStandaloneHandler() - XML 文書がスタンドアロンの文書として宣言されていない場合に呼び出されま す。外部サブセットやパラメタエンティティへの参照が存在するが、XML 宣言が XML - 宣言中で standalone 変数を ``yes`` に設定していない場合に起きます。この ハンドラが ``0`` を返すと、パーザは - :const:`XML_ERROR_NOT_STANDALONE` を送出します。このハンドラが設定されて いなければ、パーザは前述の事態で + XML 文書がスタンドアロンの文書として宣言されていない場合に呼び出されま す。 + 外部サブセットやパラメタエンティティへの参照が存在するが、XML 宣言が XML + 宣言中で standalone 変数を ``yes`` に設定していない場合に起きます。 + このハンドラが ``0`` を返すと、パーザ は :const:`XML_ERROR_NOT_STANDALONE` + を発生させます。このハンドラが設定されていなければ、パーザは前述の事態で 例外を送出しません。 ======================================= --- /library/urllib2.rst Sat Jun 18 17:02:48 2011 +++ /library/urllib2.rst Sat Nov 5 06:15:05 2011 @@ -28,14 +28,19 @@ URL *url* を開きます。 *url* は文字列でも :class:`Request` オブジェクト でもかまいません。 - *data* はサーバに送信する追加のデータを示す文字列か、そのようなデータが 無ければ *None* を指定します。現時点でHTTP リクエストは *data* - をサポートする唯一のリクエスト形式です; *data* パラメタが指定が指定され た場合、HTTP リクエストは GET でなく POST になります。 + .. warning:: + HTTPS のリクエストはサーバーの認証を一切行いません。 + + *data* はサーバに送信する追加のデータを示す文字列か、そのようなデータが 無ければ + *None* を指定します。現時点でHTTPリクエストは *data* をサポートする唯一 のリクエスト形式です; + *data* パラメタが指定が指定された場合、HTTP リクエストは GET でなく POST になります。 *data* は標準的な :mimetype:`application/x-www-form-urlencoded` 形式のバ ッファでなくてはなりません。 :func:`urllib.urlencode` 関数はマップ型か2タプルのシーケンスを取り、この 形式の文字列を返します。 + urllib2 モジュールは HTTP/1.1 リクエストを `Connection:close` ヘッダ付き で送信します。 オプションの *timeout* 引数は、接続開始などのブロックする操作におけるタ イムアウト時間を秒数で指定します。 (指定されなかった場合、グローバルのデフォルトタイムアウト時間が利用され ます) - この引数は、 HTTP, HTTPS, FTP, FTPS 接続でのみ有効です。 + この引数は、 HTTP, HTTPS, FTP 接続でのみ有効です。 この関数は以下の 2 つのメソッドを持つファイル類似のオブジェクトを返しま す: @@ -389,7 +394,7 @@ グローバルな :class:`OpenerDirector` の :meth:`open` メソッドを呼び出し ます) 。 オプションの *timeout* 引数は、接続開始のようなブロックする処理における タイムアウト時間を 秒数で指定します。(指定しなかった場合は、グローバルのデフォルト設定が利 用されます) - タイムアウト機能は、 HTTP, HTTPS, FTP, FTPS 接続でのみ有効です。 + タイムアウト機能は、 HTTP, HTTPS, FTP 接続でのみ有効です。 .. versionchanged:: 2.6 *timeout* 引数が追加されました
