# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2017, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR , 2017.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-05-26 11:10+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME \n"
"Language-Team: LANGUAGE \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.5.1\n"
#: ../Doc/c-api/unicode.rst:6
msgid "Unicode Objects and Codecs"
msgstr ""
#: ../Doc/c-api/unicode.rst:12
msgid "Unicode Objects"
msgstr ""
#: ../Doc/c-api/unicode.rst:14
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 ""
#: ../Doc/c-api/unicode.rst:20
msgid ""
":c:type:`Py_UNICODE*` and UTF-8 representations are created on demand and"
" cached in the Unicode object. The :c:type:`Py_UNICODE*` representation "
"is deprecated and inefficient; it should be avoided in performance- or "
"memory-sensitive situations."
msgstr ""
#: ../Doc/c-api/unicode.rst:25
msgid ""
"Due to the transition between the old APIs and the new APIs, unicode "
"objects can internally be in two states depending on how they were "
"created:"
msgstr ""
#: ../Doc/c-api/unicode.rst:28
msgid ""
"\"canonical\" unicode objects are all objects created by a non-deprecated"
" unicode API. They use the most efficient representation allowed by the "
"implementation."
msgstr ""
#: ../Doc/c-api/unicode.rst:32
msgid ""
"\"legacy\" unicode objects have been created through one of the "
"deprecated APIs (typically :c:func:`PyUnicode_FromUnicode`) and only bear"
" the :c:type:`Py_UNICODE*` representation; you will have to call "
":c:func:`PyUnicode_READY` on them before calling any other API."
msgstr ""
#: ../Doc/c-api/unicode.rst:39
msgid "Unicode Type"
msgstr ""
#: ../Doc/c-api/unicode.rst:41
msgid ""
"These are the basic Unicode object types used for the Unicode "
"implementation in Python:"
msgstr ""
#: ../Doc/c-api/unicode.rst:48
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 ""
#: ../Doc/c-api/unicode.rst:57
msgid ""
"This is a typedef of :c:type:`wchar_t`, which is a 16-bit type or 32-bit "
"type depending on the platform."
msgstr ""
#: ../Doc/c-api/unicode.rst:60
msgid ""
"In previous versions, this was a 16-bit type or a 32-bit type depending "
"on whether you selected a \"narrow\" or \"wide\" Unicode version of "
"Python at build time."
msgstr ""
#: ../Doc/c-api/unicode.rst:70
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 ""
#: ../Doc/c-api/unicode.rst:79
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python Unicode "
"type. It is exposed to Python code as ``str``."
msgstr ""
#: ../Doc/c-api/unicode.rst:83
msgid ""
"The following APIs are really C macros and can be used to do fast checks "
"and to access internal read-only data of Unicode objects:"
msgstr ""
#: ../Doc/c-api/unicode.rst:88
msgid ""
"Return true if the object *o* is a Unicode object or an instance of a "
"Unicode subtype."
msgstr ""
#: ../Doc/c-api/unicode.rst:94
msgid ""
"Return true if the object *o* is a Unicode object, but not an instance of"
" a subtype."
msgstr ""
#: ../Doc/c-api/unicode.rst:100
msgid ""
"Ensure the string object *o* is in the \"canonical\" representation. "
"This is required before using any of the access macros described below."
msgstr ""
#: ../Doc/c-api/unicode.rst:105
msgid ""
"Returns ``0`` on success and ``-1`` with an exception set on failure, "
"which in particular happens if memory allocation fails."
msgstr ""
#: ../Doc/c-api/unicode.rst:113
msgid ""
"Return the length of the Unicode string, in code points. *o* has to be a"
" Unicode object in the \"canonical\" representation (not checked)."
msgstr ""
#: ../Doc/c-api/unicode.rst:123
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 macro. Make sure "
":c:func:`PyUnicode_READY` has been called before accessing this."
msgstr ""
#: ../Doc/c-api/unicode.rst:137
msgid "Return values of the :c:func:`PyUnicode_KIND` macro."
msgstr ""
#: ../Doc/c-api/unicode.rst:144
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. *o*"
" has to be a Unicode object in the \"canonical\" representation (not "
"checked)."
msgstr ""
#: ../Doc/c-api/unicode.rst:155
msgid ""
"Return a void pointer to the raw unicode buffer. *o* has to be a Unicode"
" object in the \"canonical\" representation (not checked)."
msgstr ""
#: ../Doc/c-api/unicode.rst:164
msgid ""
"Write into a canonical representation *data* (as obtained with "
":c:func:`PyUnicode_DATA`). This macro does not do any sanity checks and "
"is intended for usage in loops. The caller should cache the *kind* value"
" and *data* pointer as obtained from other macro calls. *index* is the "
"index in the string (starts at 0) and *value* is the new code point value"
" which should be written to that location."
msgstr ""
#: ../Doc/c-api/unicode.rst:176
msgid ""
"Read a code point from a canonical representation *data* (as obtained "
"with :c:func:`PyUnicode_DATA`). No checks or ready calls are performed."
msgstr ""
#: ../Doc/c-api/unicode.rst:184
msgid ""
"Read a character from a Unicode object *o*, which must be in the "
"\"canonical\" representation. This is less efficient than "
":c:func:`PyUnicode_READ` if you do multiple consecutive reads."
msgstr ""
#: ../Doc/c-api/unicode.rst:193
msgid ""
"Return the maximum code point that is suitable for creating another "
"string based on *o*, which must be in the \"canonical\" representation. "
"This is always an approximation but more efficient than iterating over "
"the string."
msgstr ""
#: ../Doc/c-api/unicode.rst:202
msgid "Clear the free list. Return the total number of freed items."
msgstr ""
#: ../Doc/c-api/unicode.rst:207
msgid ""
"Return the size of the deprecated :c:type:`Py_UNICODE` representation, in"
" code units (this includes surrogate pairs as 2 units). *o* has to be a "
"Unicode object (not checked)."
msgstr ""
#: ../Doc/c-api/unicode.rst:213 ../Doc/c-api/unicode.rst:223
msgid ""
"Part of the old-style Unicode API, please migrate to using "
":c:func:`PyUnicode_GET_LENGTH`."
msgstr ""
#: ../Doc/c-api/unicode.rst:218
msgid ""
"Return the size of the deprecated :c:type:`Py_UNICODE` representation in "
"bytes. *o* has to be a Unicode object (not checked)."
msgstr ""
#: ../Doc/c-api/unicode.rst:229
msgid ""
"Return a pointer to a :c:type:`Py_UNICODE` representation of the object."
" The returned buffer is always terminated with an extra null code point."
" It may also contain embedded null code points, which would cause the "
"string to be truncated when used in most C functions. The ``AS_DATA`` "
"form casts the pointer to :c:type:`const char *`. The *o* argument has "
"to be a Unicode object (not checked)."
msgstr ""
#: ../Doc/c-api/unicode.rst:236
msgid ""
"This macro is now inefficient -- because in many cases the "
":c:type:`Py_UNICODE` representation does not exist and needs to be "
"created -- and can fail (return *NULL* with an exception set). Try to "
"port the code to use the new :c:func:`PyUnicode_nBYTE_DATA` macros or use"
" :c:func:`PyUnicode_WRITE` or :c:func:`PyUnicode_READ`."
msgstr ""
#: ../Doc/c-api/unicode.rst:245
msgid ""
"Part of the old-style Unicode API, please migrate to using the "
":c:func:`PyUnicode_nBYTE_DATA` family of macros."
msgstr ""
#: ../Doc/c-api/unicode.rst:249
msgid "Unicode Character Properties"
msgstr ""
#: ../Doc/c-api/unicode.rst:251
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 ""
#: ../Doc/c-api/unicode.rst:258
msgid "Return ``1`` or ``0`` depending on whether *ch* is a whitespace character."
msgstr ""
#: ../Doc/c-api/unicode.rst:263
msgid "Return ``1`` or ``0`` depending on whether *ch* is a lowercase character."
msgstr ""
#: ../Doc/c-api/unicode.rst:268
msgid "Return ``1`` or ``0`` depending on whether *ch* is an uppercase character."
msgstr ""
#: ../Doc/c-api/unicode.rst:273
msgid "Return ``1`` or ``0`` depending on whether *ch* is a titlecase character."
msgstr ""
#: ../Doc/c-api/unicode.rst:278
msgid "Return ``1`` or ``0`` depending on whether *ch* is a linebreak character."
msgstr ""
#: ../Doc/c-api/unicode.rst:283
msgid "Return ``1`` or ``0`` depending on whether *ch* is a decimal character."
msgstr ""
#: ../Doc/c-api/unicode.rst:288
msgid "Return ``1`` or ``0`` depending on whether *ch* is a digit character."
msgstr ""
#: ../Doc/c-api/unicode.rst:293
msgid "Return ``1`` or ``0`` depending on whether *ch* is a numeric character."
msgstr ""
#: ../Doc/c-api/unicode.rst:298
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is an alphabetic "
"character."
msgstr ""
#: ../Doc/c-api/unicode.rst:303
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is an alphanumeric "
"character."
msgstr ""
#: ../Doc/c-api/unicode.rst:308
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a printable character."
" Nonprintable characters are those characters defined in the Unicode "
"character database as \"Other\" or \"Separator\", excepting the ASCII "
"space (0x20) which is considered printable. (Note that printable "
"characters in this context are those which should not be escaped when "
":func:`repr` is invoked on a string. It has no bearing on the handling of"
" strings written to :data:`sys.stdout` or :data:`sys.stderr`.)"
msgstr ""
#: ../Doc/c-api/unicode.rst:317
msgid "These APIs can be used for fast direct character conversions:"
msgstr ""
#: ../Doc/c-api/unicode.rst:322
msgid "Return the character *ch* converted to lower case."
msgstr ""
#: ../Doc/c-api/unicode.rst:324 ../Doc/c-api/unicode.rst:332
#: ../Doc/c-api/unicode.rst:340
msgid "This function uses simple case mappings."
msgstr ""
#: ../Doc/c-api/unicode.rst:330
msgid "Return the character *ch* converted to upper case."
msgstr ""
#: ../Doc/c-api/unicode.rst:338
msgid "Return the character *ch* converted to title case."
msgstr ""
#: ../Doc/c-api/unicode.rst:346
msgid ""
"Return the character *ch* converted to a decimal positive integer. "
"Return ``-1`` if this is not possible. This macro does not raise "
"exceptions."
msgstr ""
#: ../Doc/c-api/unicode.rst:352
msgid ""
"Return the character *ch* converted to a single digit integer. Return "
"``-1`` if this is not possible. This macro does not raise exceptions."
msgstr ""
#: ../Doc/c-api/unicode.rst:358
msgid ""
"Return the character *ch* converted to a double. Return ``-1.0`` if this "
"is not possible. This macro does not raise exceptions."
msgstr ""
#: ../Doc/c-api/unicode.rst:362
msgid "These APIs can be used to work with surrogates:"
msgstr ""
#: ../Doc/c-api/unicode.rst:366
msgid "Check if *ch* is a surrogate (``0xD800