# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 2.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2016-10-30 10:44+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/c-api/unicode.rst:6
msgid "Unicode Objects and Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:11
msgid "Unicode Objects"
msgstr ""

#: ../Doc/c-api/unicode.rst:15
msgid "Unicode Type"
msgstr ""

#: ../Doc/c-api/unicode.rst:17
msgid ""
"These are the basic Unicode object types used for the Unicode implementation "
"in Python:"
msgstr ""

#: ../Doc/c-api/unicode.rst:23
msgid ""
"This type represents the storage type which is used by Python internally as "
"basis for holding Unicode ordinals.  Python's default builds use a 16-bit "
"type for :c:type:`Py_UNICODE` and store Unicode values internally as UCS2. "
"It is also possible to build a UCS4 version of Python (most recent Linux "
"distributions come with UCS4 builds of Python). These builds then use a 32-"
"bit type for :c:type:`Py_UNICODE` and store Unicode data internally as UCS4. "
"On platforms where :c:type:`wchar_t` is available and compatible with the "
"chosen Python Unicode build variant, :c:type:`Py_UNICODE` is a typedef alias "
"for :c:type:`wchar_t` to enhance native platform compatibility. On all other "
"platforms, :c:type:`Py_UNICODE` is a typedef alias for either :c:type:"
"`unsigned short` (UCS2) or :c:type:`unsigned long` (UCS4)."
msgstr ""

#: ../Doc/c-api/unicode.rst:35
msgid ""
"Note that UCS2 and UCS4 Python builds are not binary compatible. Please keep "
"this in mind when writing extensions or interfaces."
msgstr ""

#: ../Doc/c-api/unicode.rst:41
msgid "This subtype of :c:type:`PyObject` represents a Python Unicode object."
msgstr ""

#: ../Doc/c-api/unicode.rst:46
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python Unicode type.  "
"It is exposed to Python code as ``unicode`` and ``types.UnicodeType``."
msgstr ""

#: ../Doc/c-api/unicode.rst:49
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:55
msgid ""
"Return true if the object *o* is a Unicode object or an instance of a "
"Unicode subtype."
msgstr ""

#: ../Doc/c-api/unicode.rst:58
msgid "Allowed subtypes to be accepted."
msgstr ""

#: ../Doc/c-api/unicode.rst:64
msgid ""
"Return true if the object *o* is a Unicode object, but not an instance of a "
"subtype."
msgstr ""

#: ../Doc/c-api/unicode.rst:72
msgid ""
"Return the size of the object.  *o* has to be a :c:type:`PyUnicodeObject` "
"(not checked)."
msgstr ""

#: ../Doc/c-api/unicode.rst:75 ../Doc/c-api/unicode.rst:85
#: ../Doc/c-api/unicode.rst:343
msgid ""
"This function returned an :c:type:`int` type. This might require changes in "
"your code for properly supporting 64-bit systems."
msgstr ""

#: ../Doc/c-api/unicode.rst:82
msgid ""
"Return the size of the object's internal buffer in bytes.  *o* has to be a :"
"c:type:`PyUnicodeObject` (not checked)."
msgstr ""

#: ../Doc/c-api/unicode.rst:92
msgid ""
"Return a pointer to the internal :c:type:`Py_UNICODE` buffer of the object.  "
"*o* has to be a :c:type:`PyUnicodeObject` (not checked)."
msgstr ""

#: ../Doc/c-api/unicode.rst:98
msgid ""
"Return a pointer to the internal buffer of the object. *o* has to be a :c:"
"type:`PyUnicodeObject` (not checked)."
msgstr ""

#: ../Doc/c-api/unicode.rst:104
msgid "Clear the free list. Return the total number of freed items."
msgstr ""

#: ../Doc/c-api/unicode.rst:110
msgid "Unicode Character Properties"
msgstr ""

#: ../Doc/c-api/unicode.rst:112
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:119
msgid "Return 1 or 0 depending on whether *ch* is a whitespace character."
msgstr ""

#: ../Doc/c-api/unicode.rst:124
msgid "Return 1 or 0 depending on whether *ch* is a lowercase character."
msgstr ""

#: ../Doc/c-api/unicode.rst:129
msgid "Return 1 or 0 depending on whether *ch* is an uppercase character."
msgstr ""

#: ../Doc/c-api/unicode.rst:134
msgid "Return 1 or 0 depending on whether *ch* is a titlecase character."
msgstr ""

#: ../Doc/c-api/unicode.rst:139
msgid "Return 1 or 0 depending on whether *ch* is a linebreak character."
msgstr ""

#: ../Doc/c-api/unicode.rst:144
msgid "Return 1 or 0 depending on whether *ch* is a decimal character."
msgstr ""

#: ../Doc/c-api/unicode.rst:149
msgid "Return 1 or 0 depending on whether *ch* is a digit character."
msgstr ""

#: ../Doc/c-api/unicode.rst:154
msgid "Return 1 or 0 depending on whether *ch* is a numeric character."
msgstr ""

#: ../Doc/c-api/unicode.rst:159
msgid "Return 1 or 0 depending on whether *ch* is an alphabetic character."
msgstr ""

#: ../Doc/c-api/unicode.rst:164
msgid "Return 1 or 0 depending on whether *ch* is an alphanumeric character."
msgstr ""

#: ../Doc/c-api/unicode.rst:166
msgid "These APIs can be used for fast direct character conversions:"
msgstr ""

#: ../Doc/c-api/unicode.rst:171
msgid "Return the character *ch* converted to lower case."
msgstr ""

#: ../Doc/c-api/unicode.rst:176
msgid "Return the character *ch* converted to upper case."
msgstr ""

#: ../Doc/c-api/unicode.rst:181
msgid "Return the character *ch* converted to title case."
msgstr ""

#: ../Doc/c-api/unicode.rst:186
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:192
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:198
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:203
msgid "Plain Py_UNICODE"
msgstr ""

#: ../Doc/c-api/unicode.rst:205
msgid ""
"To create Unicode objects and access their basic sequence properties, use "
"these APIs:"
msgstr ""

#: ../Doc/c-api/unicode.rst:211
msgid ""
"Create a Unicode object from the Py_UNICODE buffer *u* of the given size. "
"*u* may be *NULL* which causes the contents to be undefined. It is the "
"user's responsibility to fill in the needed data.  The buffer is copied into "
"the new object. If the buffer is not *NULL*, the return value might be a "
"shared object. Therefore, modification of the resulting Unicode object is "
"only allowed when *u* is *NULL*."
msgstr ""

#: ../Doc/c-api/unicode.rst:218 ../Doc/c-api/unicode.rst:386
#: ../Doc/c-api/unicode.rst:449 ../Doc/c-api/unicode.rst:462
#: ../Doc/c-api/unicode.rst:487 ../Doc/c-api/unicode.rst:501
#: ../Doc/c-api/unicode.rst:511 ../Doc/c-api/unicode.rst:631
#: ../Doc/c-api/unicode.rst:670 ../Doc/c-api/unicode.rst:725
#: ../Doc/c-api/unicode.rst:736 ../Doc/c-api/unicode.rst:759
#: ../Doc/c-api/unicode.rst:770 ../Doc/c-api/unicode.rst:794
#: ../Doc/c-api/unicode.rst:804 ../Doc/c-api/unicode.rst:828
#: ../Doc/c-api/unicode.rst:838 ../Doc/c-api/unicode.rst:888
#: ../Doc/c-api/unicode.rst:899 ../Doc/c-api/unicode.rst:926
#: ../Doc/c-api/unicode.rst:945 ../Doc/c-api/unicode.rst:965
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 ""

#: ../Doc/c-api/unicode.rst:225
msgid ""
"Create a Unicode object from the char buffer *u*.  The bytes will be "
"interpreted as being UTF-8 encoded.  *u* may also be *NULL* which causes the "
"contents to be undefined. It is the user's responsibility to fill in the "
"needed data.  The buffer is copied into the new object. If the buffer is not "
"*NULL*, the return value might be a shared object. Therefore, modification "
"of the resulting Unicode object is only allowed when *u* is *NULL*."
msgstr ""

#: ../Doc/c-api/unicode.rst:237
msgid ""
"Create a Unicode object from a UTF-8 encoded null-terminated char buffer *u*."
msgstr ""

#: ../Doc/c-api/unicode.rst:245
msgid ""
"Take a C :c:func:`printf`\\ -style *format* string and a variable number of "
"arguments, calculate the size of the resulting Python unicode string and "
"return a string with the values formatted into it.  The variable arguments "
"must be C types and must correspond exactly to the format characters in the "
"*format* string.  The following format characters are allowed:"
msgstr ""

#: ../Doc/c-api/unicode.rst:258
msgid "Format Characters"
msgstr ""

#: ../Doc/c-api/unicode.rst:258
msgid "Type"
msgstr "Type"

#: ../Doc/c-api/unicode.rst:258
msgid "Comment"
msgstr ""

#: ../Doc/c-api/unicode.rst:260
msgid ":attr:`%%`"
msgstr ""

#: ../Doc/c-api/unicode.rst:260
msgid "*n/a*"
msgstr ""

#: ../Doc/c-api/unicode.rst:260
msgid "The literal % character."
msgstr ""

#: ../Doc/c-api/unicode.rst:262
msgid ":attr:`%c`"
msgstr ""

#: ../Doc/c-api/unicode.rst:262 ../Doc/c-api/unicode.rst:265
#: ../Doc/c-api/unicode.rst:283 ../Doc/c-api/unicode.rst:286
msgid "int"
msgstr "*int*"

#: ../Doc/c-api/unicode.rst:262
msgid "A single character, represented as a C int."
msgstr ""

#: ../Doc/c-api/unicode.rst:265
msgid ":attr:`%d`"
msgstr ""

#: ../Doc/c-api/unicode.rst:265
msgid "Exactly equivalent to ``printf(\"%d\")``."
msgstr ""

#: ../Doc/c-api/unicode.rst:268
msgid ":attr:`%u`"
msgstr ""

#: ../Doc/c-api/unicode.rst:268
msgid "unsigned int"
msgstr "``unsigned int``"

#: ../Doc/c-api/unicode.rst:268
msgid "Exactly equivalent to ``printf(\"%u\")``."
msgstr ""

#: ../Doc/c-api/unicode.rst:271
msgid ":attr:`%ld`"
msgstr ""

#: ../Doc/c-api/unicode.rst:271
msgid "long"
msgstr ""

#: ../Doc/c-api/unicode.rst:271
msgid "Exactly equivalent to ``printf(\"%ld\")``."
msgstr ""

#: ../Doc/c-api/unicode.rst:274
msgid ":attr:`%lu`"
msgstr ""

#: ../Doc/c-api/unicode.rst:274
msgid "unsigned long"
msgstr "``unsigned long``"

#: ../Doc/c-api/unicode.rst:274
msgid "Exactly equivalent to ``printf(\"%lu\")``."
msgstr ""

#: ../Doc/c-api/unicode.rst:277
msgid ":attr:`%zd`"
msgstr ""

#: ../Doc/c-api/unicode.rst:277
msgid "Py_ssize_t"
msgstr ""

#: ../Doc/c-api/unicode.rst:277
msgid "Exactly equivalent to ``printf(\"%zd\")``."
msgstr ""

#: ../Doc/c-api/unicode.rst:280
msgid ":attr:`%zu`"
msgstr ""

#: ../Doc/c-api/unicode.rst:280
msgid "size_t"
msgstr ""

#: ../Doc/c-api/unicode.rst:280
msgid "Exactly equivalent to ``printf(\"%zu\")``."
msgstr ""

#: ../Doc/c-api/unicode.rst:283
msgid ":attr:`%i`"
msgstr ""

#: ../Doc/c-api/unicode.rst:283
msgid "Exactly equivalent to ``printf(\"%i\")``."
msgstr ""

#: ../Doc/c-api/unicode.rst:286
msgid ":attr:`%x`"
msgstr ""

#: ../Doc/c-api/unicode.rst:286
msgid "Exactly equivalent to ``printf(\"%x\")``."
msgstr ""

#: ../Doc/c-api/unicode.rst:289
msgid ":attr:`%s`"
msgstr ""

#: ../Doc/c-api/unicode.rst:289
msgid "char\\*"
msgstr ""

#: ../Doc/c-api/unicode.rst:289
msgid "A null-terminated C character array."
msgstr ""

#: ../Doc/c-api/unicode.rst:292
msgid ":attr:`%p`"
msgstr ""

#: ../Doc/c-api/unicode.rst:292
msgid "void\\*"
msgstr ""

#: ../Doc/c-api/unicode.rst:292
msgid ""
"The hex representation of a C pointer. Mostly equivalent to ``printf(\"%p"
"\")`` except that it is guaranteed to start with the literal ``0x`` "
"regardless of what the platform's ``printf`` yields."
msgstr ""

#: ../Doc/c-api/unicode.rst:300
msgid ":attr:`%U`"
msgstr ""

#: ../Doc/c-api/unicode.rst:300 ../Doc/c-api/unicode.rst:309
#: ../Doc/c-api/unicode.rst:312
msgid "PyObject\\*"
msgstr "PyObject\\*"

#: ../Doc/c-api/unicode.rst:300
msgid "A unicode object."
msgstr "Un objet Unicode."

#: ../Doc/c-api/unicode.rst:302
msgid ":attr:`%V`"
msgstr ""

#: ../Doc/c-api/unicode.rst:302
msgid "PyObject\\*, char \\*"
msgstr ""

#: ../Doc/c-api/unicode.rst:302
msgid ""
"A unicode object (which may be *NULL*) and a null-terminated C character "
"array as a second parameter (which will be used, if the first parameter is "
"*NULL*)."
msgstr ""

#: ../Doc/c-api/unicode.rst:309
msgid ":attr:`%S`"
msgstr ""

#: ../Doc/c-api/unicode.rst:309
msgid "The result of calling :func:`PyObject_Unicode`."
msgstr ""

#: ../Doc/c-api/unicode.rst:312
msgid ":attr:`%R`"
msgstr ""

#: ../Doc/c-api/unicode.rst:312
msgid "The result of calling :func:`PyObject_Repr`."
msgstr ""

#: ../Doc/c-api/unicode.rst:316
msgid ""
"An unrecognized format character causes all the rest of the format string to "
"be copied as-is to the result string, and any extra arguments discarded."
msgstr ""

#: ../Doc/c-api/unicode.rst:324
msgid ""
"Identical to :func:`PyUnicode_FromFormat` except that it takes exactly two "
"arguments."
msgstr ""

#: ../Doc/c-api/unicode.rst:332
msgid ""
"Return a read-only pointer to the Unicode object's internal :c:type:"
"`Py_UNICODE` buffer, *NULL* if *unicode* is not a Unicode object. Note that "
"the resulting :c:type:`Py_UNICODE*` string may contain embedded null "
"characters, which would cause the string to be truncated when used in most C "
"functions."
msgstr ""

#: ../Doc/c-api/unicode.rst:341
msgid "Return the length of the Unicode object."
msgstr ""

#: ../Doc/c-api/unicode.rst:350
msgid ""
"Coerce an encoded object *obj* to a Unicode object and return a reference "
"with incremented refcount."
msgstr ""

#: ../Doc/c-api/unicode.rst:353
msgid ""
"String and other char buffer compatible objects are decoded according to the "
"given encoding and using the error handling defined by errors.  Both can be "
"*NULL* to have the interface use the default values (see the next section "
"for details)."
msgstr ""

#: ../Doc/c-api/unicode.rst:358
msgid ""
"All other objects, including Unicode objects, cause a :exc:`TypeError` to be "
"set."
msgstr ""

#: ../Doc/c-api/unicode.rst:361
msgid ""
"The API returns *NULL* if there was an error.  The caller is responsible for "
"decref'ing the returned objects."
msgstr ""

#: ../Doc/c-api/unicode.rst:367
msgid ""
"Shortcut for ``PyUnicode_FromEncodedObject(obj, NULL, \"strict\")`` which is "
"used throughout the interpreter whenever coercion to Unicode is needed."
msgstr ""

#: ../Doc/c-api/unicode.rst:370
msgid ""
"If the platform supports :c:type:`wchar_t` and provides a header file wchar."
"h, Python can interface directly to this type using the following functions. "
"Support is optimized if Python's own :c:type:`Py_UNICODE` type is identical "
"to the system's :c:type:`wchar_t`."
msgstr ""

#: ../Doc/c-api/unicode.rst:377
msgid "wchar_t Support"
msgstr ""

#: ../Doc/c-api/unicode.rst:379
msgid ":c:type:`wchar_t` support for platforms which support it:"
msgstr ""

#: ../Doc/c-api/unicode.rst:383
msgid ""
"Create a Unicode object from the :c:type:`wchar_t` buffer *w* of the given "
"*size*. Return *NULL* on failure."
msgstr ""

#: ../Doc/c-api/unicode.rst:393
msgid ""
"Copy the Unicode object contents into the :c:type:`wchar_t` buffer *w*.  At "
"most *size* :c:type:`wchar_t` characters are copied (excluding a possibly "
"trailing 0-termination character).  Return the number of :c:type:`wchar_t` "
"characters copied or -1 in case of an error.  Note that the resulting :c:"
"type:`wchar_t` string may or may not be 0-terminated.  It is the "
"responsibility of the caller to make sure that the :c:type:`wchar_t` string "
"is 0-terminated in case this is required by the application. Also, note that "
"the :c:type:`wchar_t*` string might contain null characters, which would "
"cause the string to be truncated when used with most C functions."
msgstr ""

#: ../Doc/c-api/unicode.rst:403
msgid ""
"This function returned an :c:type:`int` type and used an :c:type:`int` type "
"for *size*. This might require changes in your code for properly supporting "
"64-bit systems."
msgstr ""

#: ../Doc/c-api/unicode.rst:412
msgid "Built-in Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:414
msgid ""
"Python provides a set of built-in codecs which are written in C for speed. "
"All of these codecs are directly usable via the following functions."
msgstr ""

#: ../Doc/c-api/unicode.rst:417
msgid ""
"Many of the following APIs take two arguments encoding and errors, and they "
"have the same semantics as the ones of the built-in :func:`unicode` Unicode "
"object constructor."
msgstr ""

#: ../Doc/c-api/unicode.rst:421
msgid ""
"Setting encoding to *NULL* causes the default encoding to be used which is "
"ASCII.  The file system calls should use :c:data:"
"`Py_FileSystemDefaultEncoding` as the encoding for file names. This variable "
"should be treated as read-only: on some systems, it will be a pointer to a "
"static string, on others, it will change at run-time (such as when the "
"application invokes setlocale)."
msgstr ""

#: ../Doc/c-api/unicode.rst:427
msgid ""
"Error handling is set by errors which may also be set to *NULL* meaning to "
"use the default handling defined for the codec.  Default error handling for "
"all built-in codecs is \"strict\" (:exc:`ValueError` is raised)."
msgstr ""

#: ../Doc/c-api/unicode.rst:431
msgid ""
"The codecs all use a similar interface.  Only deviation from the following "
"generic ones are documented for simplicity."
msgstr ""

#: ../Doc/c-api/unicode.rst:436
msgid "Generic Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:438
msgid "These are the generic codec APIs:"
msgstr ""

#: ../Doc/c-api/unicode.rst:443
msgid ""
"Create a Unicode object by decoding *size* bytes of the encoded string *s*. "
"*encoding* and *errors* have the same meaning as the parameters of the same "
"name in the :func:`unicode` built-in function.  The codec to be used is "
"looked up using the Python codec registry.  Return *NULL* if an exception "
"was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:456
msgid ""
"Encode the :c:type:`Py_UNICODE` buffer *s* of the given *size* and return a "
"Python string object.  *encoding* and *errors* have the same meaning as the "
"parameters of the same name in the Unicode :meth:`~unicode.encode` method.  "
"The codec to be used is looked up using the Python codec registry.  Return "
"*NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:469
msgid ""
"Encode a Unicode object and return the result as Python string object. "
"*encoding* and *errors* have the same meaning as the parameters of the same "
"name in the Unicode :meth:`encode` method. The codec to be used is looked up "
"using the Python codec registry. Return *NULL* if an exception was raised by "
"the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:477
msgid "UTF-8 Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:479
msgid "These are the UTF-8 codec APIs:"
msgstr ""

#: ../Doc/c-api/unicode.rst:484
msgid ""
"Create a Unicode object by decoding *size* bytes of the UTF-8 encoded string "
"*s*. Return *NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:494
msgid ""
"If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeUTF8`. If "
"*consumed* is not *NULL*, trailing incomplete UTF-8 byte sequences will not "
"be treated as an error. Those bytes will not be decoded and the number of "
"bytes that have been decoded will be stored in *consumed*."
msgstr ""

#: ../Doc/c-api/unicode.rst:508
msgid ""
"Encode the :c:type:`Py_UNICODE` buffer *s* of the given *size* using UTF-8 "
"and return a Python string object.  Return *NULL* if an exception was raised "
"by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:518
msgid ""
"Encode a Unicode object using UTF-8 and return the result as Python string "
"object.  Error handling is \"strict\".  Return *NULL* if an exception was "
"raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:524
msgid "UTF-32 Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:526
msgid "These are the UTF-32 codec APIs:"
msgstr ""

#: ../Doc/c-api/unicode.rst:531
msgid ""
"Decode *size* bytes from a UTF-32 encoded buffer string and return the "
"corresponding Unicode object.  *errors* (if non-*NULL*) defines the error "
"handling. It defaults to \"strict\"."
msgstr ""

#: ../Doc/c-api/unicode.rst:535 ../Doc/c-api/unicode.rst:611
msgid ""
"If *byteorder* is non-*NULL*, the decoder starts decoding using the given "
"byte order::"
msgstr ""

#: ../Doc/c-api/unicode.rst:542
msgid ""
"If ``*byteorder`` is zero, and the first four bytes of the input data are a "
"byte order mark (BOM), the decoder switches to this byte order and the BOM "
"is not copied into the resulting Unicode string.  If ``*byteorder`` is "
"``-1`` or ``1``, any byte order mark is copied to the output."
msgstr ""

#: ../Doc/c-api/unicode.rst:547 ../Doc/c-api/unicode.rst:624
msgid ""
"After completion, *\\*byteorder* is set to the current byte order at the end "
"of input data."
msgstr ""

#: ../Doc/c-api/unicode.rst:550
msgid ""
"In a narrow build code points outside the BMP will be decoded as surrogate "
"pairs."
msgstr ""

#: ../Doc/c-api/unicode.rst:552 ../Doc/c-api/unicode.rst:627
msgid "If *byteorder* is *NULL*, the codec starts in native order mode."
msgstr ""

#: ../Doc/c-api/unicode.rst:554 ../Doc/c-api/unicode.rst:585
#: ../Doc/c-api/unicode.rst:629 ../Doc/c-api/unicode.rst:668
msgid "Return *NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:561
msgid ""
"If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeUTF32`. If "
"*consumed* is not *NULL*, :c:func:`PyUnicode_DecodeUTF32Stateful` will not "
"treat trailing incomplete UTF-32 byte sequences (such as a number of bytes "
"not divisible by four) as an error. Those bytes will not be decoded and the "
"number of bytes that have been decoded will be stored in *consumed*."
msgstr ""

#: ../Doc/c-api/unicode.rst:572
msgid ""
"Return a Python bytes object holding the UTF-32 encoded value of the Unicode "
"data in *s*.  Output is written according to the following byte order::"
msgstr ""

#: ../Doc/c-api/unicode.rst:579 ../Doc/c-api/unicode.rst:661
msgid ""
"If byteorder is ``0``, the output string will always start with the Unicode "
"BOM mark (U+FEFF). In the other two modes, no BOM mark is prepended."
msgstr ""

#: ../Doc/c-api/unicode.rst:582
msgid ""
"If *Py_UNICODE_WIDE* is not defined, surrogate pairs will be output as a "
"single code point."
msgstr ""

#: ../Doc/c-api/unicode.rst:592
msgid ""
"Return a Python string using the UTF-32 encoding in native byte order. The "
"string always starts with a BOM mark.  Error handling is \"strict\".  Return "
"*NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:600
msgid "UTF-16 Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:602
msgid "These are the UTF-16 codec APIs:"
msgstr ""

#: ../Doc/c-api/unicode.rst:607
msgid ""
"Decode *size* bytes from a UTF-16 encoded buffer string and return the "
"corresponding Unicode object.  *errors* (if non-*NULL*) defines the error "
"handling. It defaults to \"strict\"."
msgstr ""

#: ../Doc/c-api/unicode.rst:618
msgid ""
"If ``*byteorder`` is zero, and the first two bytes of the input data are a "
"byte order mark (BOM), the decoder switches to this byte order and the BOM "
"is not copied into the resulting Unicode string.  If ``*byteorder`` is "
"``-1`` or ``1``, any byte order mark is copied to the output (where it will "
"result in either a ``\\ufeff`` or a ``\\ufffe`` character)."
msgstr ""

#: ../Doc/c-api/unicode.rst:638
msgid ""
"If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeUTF16`. If "
"*consumed* is not *NULL*, :c:func:`PyUnicode_DecodeUTF16Stateful` will not "
"treat trailing incomplete UTF-16 byte sequences (such as an odd number of "
"bytes or a split surrogate pair) as an error. Those bytes will not be "
"decoded and the number of bytes that have been decoded will be stored in "
"*consumed*."
msgstr ""

#: ../Doc/c-api/unicode.rst:646
msgid ""
"This function used an :c:type:`int` type for *size* and an :c:type:`int *` "
"type for *consumed*. This might require changes in your code for properly "
"supporting 64-bit systems."
msgstr ""

#: ../Doc/c-api/unicode.rst:654
msgid ""
"Return a Python string object holding the UTF-16 encoded value of the "
"Unicode data in *s*.  Output is written according to the following byte "
"order::"
msgstr ""

#: ../Doc/c-api/unicode.rst:664
msgid ""
"If *Py_UNICODE_WIDE* is defined, a single :c:type:`Py_UNICODE` value may get "
"represented as a surrogate pair. If it is not defined, each :c:type:"
"`Py_UNICODE` values is interpreted as a UCS-2 character."
msgstr ""

#: ../Doc/c-api/unicode.rst:677
msgid ""
"Return a Python string using the UTF-16 encoding in native byte order. The "
"string always starts with a BOM mark.  Error handling is \"strict\".  Return "
"*NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:683
msgid "UTF-7 Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:685
msgid "These are the UTF-7 codec APIs:"
msgstr ""

#: ../Doc/c-api/unicode.rst:690
msgid ""
"Create a Unicode object by decoding *size* bytes of the UTF-7 encoded string "
"*s*.  Return *NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:696
msgid ""
"If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeUTF7`.  If "
"*consumed* is not *NULL*, trailing incomplete UTF-7 base-64 sections will "
"not be treated as an error.  Those bytes will not be decoded and the number "
"of bytes that have been decoded will be stored in *consumed*."
msgstr ""

#: ../Doc/c-api/unicode.rst:704
msgid ""
"Encode the :c:type:`Py_UNICODE` buffer of the given size using UTF-7 and "
"return a Python bytes object.  Return *NULL* if an exception was raised by "
"the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:708
msgid ""
"If *base64SetO* is nonzero, \"Set O\" (punctuation that has no otherwise "
"special meaning) will be encoded in base-64.  If *base64WhiteSpace* is "
"nonzero, whitespace will be encoded in base-64.  Both are set to zero for "
"the Python \"utf-7\" codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:715
msgid "Unicode-Escape Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:717
msgid "These are the \"Unicode Escape\" codec APIs:"
msgstr ""

#: ../Doc/c-api/unicode.rst:722
msgid ""
"Create a Unicode object by decoding *size* bytes of the Unicode-Escape "
"encoded string *s*.  Return *NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:732
msgid ""
"Encode the :c:type:`Py_UNICODE` buffer of the given *size* using Unicode-"
"Escape and return a Python string object.  Return *NULL* if an exception was "
"raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:743
msgid ""
"Encode a Unicode object using Unicode-Escape and return the result as Python "
"string object.  Error handling is \"strict\". Return *NULL* if an exception "
"was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:749
msgid "Raw-Unicode-Escape Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:751
msgid "These are the \"Raw Unicode Escape\" codec APIs:"
msgstr ""

#: ../Doc/c-api/unicode.rst:756
msgid ""
"Create a Unicode object by decoding *size* bytes of the Raw-Unicode-Escape "
"encoded string *s*.  Return *NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:766
msgid ""
"Encode the :c:type:`Py_UNICODE` buffer of the given *size* using Raw-Unicode-"
"Escape and return a Python string object.  Return *NULL* if an exception was "
"raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:777
msgid ""
"Encode a Unicode object using Raw-Unicode-Escape and return the result as "
"Python string object. Error handling is \"strict\". Return *NULL* if an "
"exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:783
msgid "Latin-1 Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:785
msgid ""
"These are the Latin-1 codec APIs: Latin-1 corresponds to the first 256 "
"Unicode ordinals and only these are accepted by the codecs during encoding."
msgstr ""

#: ../Doc/c-api/unicode.rst:791
msgid ""
"Create a Unicode object by decoding *size* bytes of the Latin-1 encoded "
"string *s*.  Return *NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:801
msgid ""
"Encode the :c:type:`Py_UNICODE` buffer of the given *size* using Latin-1 and "
"return a Python string object.  Return *NULL* if an exception was raised by "
"the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:811
msgid ""
"Encode a Unicode object using Latin-1 and return the result as Python string "
"object.  Error handling is \"strict\".  Return *NULL* if an exception was "
"raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:817
msgid "ASCII Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:819
msgid ""
"These are the ASCII codec APIs.  Only 7-bit ASCII data is accepted. All "
"other codes generate errors."
msgstr ""

#: ../Doc/c-api/unicode.rst:825
msgid ""
"Create a Unicode object by decoding *size* bytes of the ASCII encoded string "
"*s*.  Return *NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:835
msgid ""
"Encode the :c:type:`Py_UNICODE` buffer of the given *size* using ASCII and "
"return a Python string object.  Return *NULL* if an exception was raised by "
"the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:845
msgid ""
"Encode a Unicode object using ASCII and return the result as Python string "
"object.  Error handling is \"strict\".  Return *NULL* if an exception was "
"raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:851
msgid "Character Map Codecs"
msgstr ""

#: ../Doc/c-api/unicode.rst:853
msgid ""
"This codec is special in that it can be used to implement many different "
"codecs (and this is in fact what was done to obtain most of the standard "
"codecs included in the :mod:`encodings` package). The codec uses mapping to "
"encode and decode characters."
msgstr ""

#: ../Doc/c-api/unicode.rst:858
msgid ""
"Decoding mappings must map single string characters to single Unicode "
"characters, integers (which are then interpreted as Unicode ordinals) or "
"``None`` (meaning \"undefined mapping\" and causing an error)."
msgstr ""

#: ../Doc/c-api/unicode.rst:862
msgid ""
"Encoding mappings must map single Unicode characters to single string "
"characters, integers (which are then interpreted as Latin-1 ordinals) or "
"``None`` (meaning \"undefined mapping\" and causing an error)."
msgstr ""

#: ../Doc/c-api/unicode.rst:866
msgid ""
"The mapping objects provided must only support the __getitem__ mapping "
"interface."
msgstr ""

#: ../Doc/c-api/unicode.rst:869
msgid ""
"If a character lookup fails with a LookupError, the character is copied as-"
"is meaning that its ordinal value will be interpreted as Unicode or Latin-1 "
"ordinal resp. Because of this, mappings only need to contain those mappings "
"which map characters to different code points."
msgstr ""

#: ../Doc/c-api/unicode.rst:874
msgid "These are the mapping codec APIs:"
msgstr ""

#: ../Doc/c-api/unicode.rst:878
msgid ""
"Create a Unicode object by decoding *size* bytes of the encoded string *s* "
"using the given *mapping* object.  Return *NULL* if an exception was raised "
"by the codec. If *mapping* is *NULL* latin-1 decoding will be done. Else it "
"can be a dictionary mapping byte or a unicode string, which is treated as a "
"lookup table. Byte values greater that the length of the string and U+FFFE "
"\"characters\" are treated as \"undefined mapping\"."
msgstr ""

#: ../Doc/c-api/unicode.rst:885
msgid "Allowed unicode string as mapping argument."
msgstr ""

#: ../Doc/c-api/unicode.rst:895
msgid ""
"Encode the :c:type:`Py_UNICODE` buffer of the given *size* using the given "
"*mapping* object and return a Python string object. Return *NULL* if an "
"exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:906
msgid ""
"Encode a Unicode object using the given *mapping* object and return the "
"result as Python string object.  Error handling is \"strict\".  Return "
"*NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:910
msgid "The following codec API is special in that maps Unicode to Unicode."
msgstr ""

#: ../Doc/c-api/unicode.rst:915
msgid ""
"Translate a :c:type:`Py_UNICODE` buffer of the given *size* by applying a "
"character mapping *table* to it and return the resulting Unicode object.  "
"Return *NULL* when an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:919
msgid ""
"The *mapping* table must map Unicode ordinal integers to Unicode ordinal "
"integers or ``None`` (causing deletion of the character)."
msgstr ""

#: ../Doc/c-api/unicode.rst:922 ../Doc/c-api/unicode.rst:1024
msgid ""
"Mapping tables need only provide the :meth:`__getitem__` interface; "
"dictionaries and sequences work well.  Unmapped character ordinals (ones "
"which cause a :exc:`LookupError`) are left untouched and are copied as-is."
msgstr ""

#: ../Doc/c-api/unicode.rst:932
msgid "MBCS codecs for Windows"
msgstr ""

#: ../Doc/c-api/unicode.rst:934
msgid ""
"These are the MBCS codec APIs. They are currently only available on Windows "
"and use the Win32 MBCS converters to implement the conversions.  Note that "
"MBCS (or DBCS) is a class of encodings, not just one.  The target encoding "
"is defined by the user settings on the machine running the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:942
msgid ""
"Create a Unicode object by decoding *size* bytes of the MBCS encoded string "
"*s*. Return *NULL* if an exception was raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:952
msgid ""
"If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeMBCS`. If "
"*consumed* is not *NULL*, :c:func:`PyUnicode_DecodeMBCSStateful` will not "
"decode trailing lead byte and the number of bytes that have been decoded "
"will be stored in *consumed*."
msgstr ""

#: ../Doc/c-api/unicode.rst:962
msgid ""
"Encode the :c:type:`Py_UNICODE` buffer of the given *size* using MBCS and "
"return a Python string object.  Return *NULL* if an exception was raised by "
"the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:972
msgid ""
"Encode a Unicode object using MBCS and return the result as Python string "
"object.  Error handling is \"strict\".  Return *NULL* if an exception was "
"raised by the codec."
msgstr ""

#: ../Doc/c-api/unicode.rst:978
msgid "Methods & Slots"
msgstr ""

#: ../Doc/c-api/unicode.rst:983
msgid "Methods and Slot Functions"
msgstr ""

#: ../Doc/c-api/unicode.rst:985
msgid ""
"The following APIs are capable of handling Unicode objects and strings on "
"input (we refer to them as strings in the descriptions) and return Unicode "
"objects or integers as appropriate."
msgstr ""

#: ../Doc/c-api/unicode.rst:989
msgid "They all return *NULL* or ``-1`` if an exception occurs."
msgstr ""

#: ../Doc/c-api/unicode.rst:994
msgid "Concat two strings giving a new Unicode string."
msgstr ""

#: ../Doc/c-api/unicode.rst:999
msgid ""
"Split a string giving a list of Unicode strings.  If *sep* is *NULL*, "
"splitting will be done at all whitespace substrings.  Otherwise, splits "
"occur at the given separator.  At most *maxsplit* splits will be done.  If "
"negative, no limit is set.  Separators are not included in the resulting "
"list."
msgstr ""

#: ../Doc/c-api/unicode.rst:1004
msgid ""
"This function used an :c:type:`int` type for *maxsplit*. This might require "
"changes in your code for properly supporting 64-bit systems."
msgstr ""

#: ../Doc/c-api/unicode.rst:1011
msgid ""
"Split a Unicode string at line breaks, returning a list of Unicode strings. "
"CRLF is considered to be one line break.  If *keepend* is 0, the Line break "
"characters are not included in the resulting strings."
msgstr ""

#: ../Doc/c-api/unicode.rst:1018
msgid ""
"Translate a string by applying a character mapping table to it and return "
"the resulting Unicode object."
msgstr ""

#: ../Doc/c-api/unicode.rst:1021
msgid ""
"The mapping table must map Unicode ordinal integers to Unicode ordinal "
"integers or ``None`` (causing deletion of the character)."
msgstr ""

#: ../Doc/c-api/unicode.rst:1028
msgid ""
"*errors* has the usual meaning for codecs. It may be *NULL* which indicates "
"to use the default error handling."
msgstr ""

#: ../Doc/c-api/unicode.rst:1034
msgid ""
"Join a sequence of strings using the given *separator* and return the "
"resulting Unicode string."
msgstr ""

#: ../Doc/c-api/unicode.rst:1040
msgid ""
"Return 1 if *substr* matches ``str[start:end]`` at the given tail end "
"(*direction* == -1 means to do a prefix match, *direction* == 1 a suffix "
"match), 0 otherwise. Return ``-1`` if an error occurred."
msgstr ""

#: ../Doc/c-api/unicode.rst:1044 ../Doc/c-api/unicode.rst:1058
msgid ""
"This function used an :c:type:`int` type for *start* and *end*. This might "
"require changes in your code for properly supporting 64-bit systems."
msgstr ""

#: ../Doc/c-api/unicode.rst:1052
msgid ""
"Return the first position of *substr* in ``str[start:end]`` using the given "
"*direction* (*direction* == 1 means to do a forward search, *direction* == "
"-1 a backward search).  The return value is the index of the first match; a "
"value of ``-1`` indicates that no match was found, and ``-2`` indicates that "
"an error occurred and an exception has been set."
msgstr ""

#: ../Doc/c-api/unicode.rst:1066
msgid ""
"Return the number of non-overlapping occurrences of *substr* in ``str[start:"
"end]``.  Return ``-1`` if an error occurred."
msgstr ""

#: ../Doc/c-api/unicode.rst:1069
msgid ""
"This function returned an :c:type:`int` type and used an :c:type:`int` type "
"for *start* and *end*. This might require changes in your code for properly "
"supporting 64-bit systems."
msgstr ""

#: ../Doc/c-api/unicode.rst:1077
msgid ""
"Replace at most *maxcount* occurrences of *substr* in *str* with *replstr* "
"and return the resulting Unicode object. *maxcount* == -1 means replace all "
"occurrences."
msgstr ""

#: ../Doc/c-api/unicode.rst:1081
msgid ""
"This function used an :c:type:`int` type for *maxcount*. This might require "
"changes in your code for properly supporting 64-bit systems."
msgstr ""

#: ../Doc/c-api/unicode.rst:1088
msgid ""
"Compare two strings and return -1, 0, 1 for less than, equal, and greater "
"than, respectively."
msgstr ""

#: ../Doc/c-api/unicode.rst:1094
msgid "Rich compare two unicode strings and return one of the following:"
msgstr ""

#: ../Doc/c-api/unicode.rst:1096
msgid "``NULL`` in case an exception was raised"
msgstr ""

#: ../Doc/c-api/unicode.rst:1097
msgid ":const:`Py_True` or :const:`Py_False` for successful comparisons"
msgstr ""

#: ../Doc/c-api/unicode.rst:1098
msgid ":const:`Py_NotImplemented` in case the type combination is unknown"
msgstr ""

#: ../Doc/c-api/unicode.rst:1100
msgid ""
"Note that :const:`Py_EQ` and :const:`Py_NE` comparisons can cause a :exc:"
"`UnicodeWarning` in case the conversion of the arguments to Unicode fails "
"with a :exc:`UnicodeDecodeError`."
msgstr ""

#: ../Doc/c-api/unicode.rst:1104
msgid ""
"Possible values for *op* are :const:`Py_GT`, :const:`Py_GE`, :const:"
"`Py_EQ`, :const:`Py_NE`, :const:`Py_LT`, and :const:`Py_LE`."
msgstr ""

#: ../Doc/c-api/unicode.rst:1110
msgid ""
"Return a new string object from *format* and *args*; this is analogous to "
"``format % args``."
msgstr ""

#: ../Doc/c-api/unicode.rst:1116
msgid ""
"Check whether *element* is contained in *container* and return true or false "
"accordingly."
msgstr ""

#: ../Doc/c-api/unicode.rst:1119
msgid ""
"*element* has to coerce to a one element Unicode string. ``-1`` is returned "
"if there was an error."
msgstr ""