forked from AFPy/python-docs-fr
1276 lines
39 KiB
Plaintext
1276 lines
39 KiB
Plaintext
# 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 "Caractères de format"
|
|
|
|
#: ../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 ""
|