# SOME DESCRIPTIVE TITLE. # Copyright (C) 1990-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , 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 \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/c-api/string.rst:6 msgid "String/Bytes Objects" msgstr "" #: ../Doc/c-api/string.rst:8 msgid "" "These functions raise :exc:`TypeError` when expecting a string parameter and " "are called with a non-string parameter." msgstr "" #: ../Doc/c-api/string.rst:13 msgid "" "These functions have been renamed to PyBytes_* in Python 3.x. Unless " "otherwise noted, the PyBytes functions available in 3.x are aliased to their " "PyString_* equivalents to help porting." msgstr "" #: ../Doc/c-api/string.rst:22 msgid "This subtype of :c:type:`PyObject` represents a Python string object." msgstr "" #: ../Doc/c-api/string.rst:29 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python string type; " "it is the same object as ``str`` and ``types.StringType`` in the Python " "layer. ." msgstr "" #: ../Doc/c-api/string.rst:35 msgid "" "Return true if the object *o* is a string object or an instance of a subtype " "of the string type." msgstr "" #: ../Doc/c-api/string.rst:38 msgid "Allowed subtypes to be accepted." msgstr "" #: ../Doc/c-api/string.rst:44 msgid "" "Return true if the object *o* is a string object, but not an instance of a " "subtype of the string type." msgstr "" #: ../Doc/c-api/string.rst:52 msgid "" "Return a new string object with a copy of the string *v* as value on " "success, and *NULL* on failure. The parameter *v* must not be *NULL*; it " "will not be checked." msgstr "" #: ../Doc/c-api/string.rst:59 msgid "" "Return a new string object with a copy of the string *v* as value and length " "*len* on success, and *NULL* on failure. If *v* is *NULL*, the contents of " "the string are uninitialized." msgstr "" #: ../Doc/c-api/string.rst:63 msgid "" "This function used an :c:type:`int` type for *len*. This might require " "changes in your code for properly supporting 64-bit systems." msgstr "" #: ../Doc/c-api/string.rst:70 msgid "" "Take a C :c:func:`printf`\\ -style *format* string and a variable number of " "arguments, calculate the size of the resulting Python 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/string.rst:86 msgid "Format Characters" msgstr "Caractères de format" #: ../Doc/c-api/string.rst:86 msgid "Type" msgstr "Type" #: ../Doc/c-api/string.rst:86 msgid "Comment" msgstr "" #: ../Doc/c-api/string.rst:88 msgid ":attr:`%%`" msgstr "" #: ../Doc/c-api/string.rst:88 msgid "*n/a*" msgstr "" #: ../Doc/c-api/string.rst:88 msgid "The literal % character." msgstr "" #: ../Doc/c-api/string.rst:90 msgid ":attr:`%c`" msgstr "" #: ../Doc/c-api/string.rst:90 ../Doc/c-api/string.rst:93 #: ../Doc/c-api/string.rst:117 ../Doc/c-api/string.rst:120 msgid "int" msgstr "*int*" #: ../Doc/c-api/string.rst:90 msgid "A single character, represented as a C int." msgstr "" #: ../Doc/c-api/string.rst:93 msgid ":attr:`%d`" msgstr "" #: ../Doc/c-api/string.rst:93 msgid "Exactly equivalent to ``printf(\"%d\")``." msgstr "" #: ../Doc/c-api/string.rst:96 msgid ":attr:`%u`" msgstr "" #: ../Doc/c-api/string.rst:96 msgid "unsigned int" msgstr "``unsigned int``" #: ../Doc/c-api/string.rst:96 msgid "Exactly equivalent to ``printf(\"%u\")``." msgstr "" #: ../Doc/c-api/string.rst:99 msgid ":attr:`%ld`" msgstr "" #: ../Doc/c-api/string.rst:99 msgid "long" msgstr "" #: ../Doc/c-api/string.rst:99 msgid "Exactly equivalent to ``printf(\"%ld\")``." msgstr "" #: ../Doc/c-api/string.rst:102 msgid ":attr:`%lu`" msgstr "" #: ../Doc/c-api/string.rst:102 msgid "unsigned long" msgstr "``unsigned long``" #: ../Doc/c-api/string.rst:102 msgid "Exactly equivalent to ``printf(\"%lu\")``." msgstr "" #: ../Doc/c-api/string.rst:105 msgid ":attr:`%lld`" msgstr "" #: ../Doc/c-api/string.rst:105 msgid "long long" msgstr "" #: ../Doc/c-api/string.rst:105 msgid "Exactly equivalent to ``printf(\"%lld\")``." msgstr "" #: ../Doc/c-api/string.rst:108 msgid ":attr:`%llu`" msgstr "" #: ../Doc/c-api/string.rst:108 msgid "unsigned long long" msgstr "``unsigned long long``" #: ../Doc/c-api/string.rst:108 msgid "Exactly equivalent to ``printf(\"%llu\")``." msgstr "" #: ../Doc/c-api/string.rst:111 msgid ":attr:`%zd`" msgstr "" #: ../Doc/c-api/string.rst:111 msgid "Py_ssize_t" msgstr "" #: ../Doc/c-api/string.rst:111 msgid "Exactly equivalent to ``printf(\"%zd\")``." msgstr "" #: ../Doc/c-api/string.rst:114 msgid ":attr:`%zu`" msgstr "" #: ../Doc/c-api/string.rst:114 msgid "size_t" msgstr "" #: ../Doc/c-api/string.rst:114 msgid "Exactly equivalent to ``printf(\"%zu\")``." msgstr "" #: ../Doc/c-api/string.rst:117 msgid ":attr:`%i`" msgstr "" #: ../Doc/c-api/string.rst:117 msgid "Exactly equivalent to ``printf(\"%i\")``." msgstr "" #: ../Doc/c-api/string.rst:120 msgid ":attr:`%x`" msgstr "" #: ../Doc/c-api/string.rst:120 msgid "Exactly equivalent to ``printf(\"%x\")``." msgstr "" #: ../Doc/c-api/string.rst:123 msgid ":attr:`%s`" msgstr "" #: ../Doc/c-api/string.rst:123 msgid "char\\*" msgstr "" #: ../Doc/c-api/string.rst:123 msgid "A null-terminated C character array." msgstr "" #: ../Doc/c-api/string.rst:126 msgid ":attr:`%p`" msgstr "" #: ../Doc/c-api/string.rst:126 msgid "void\\*" msgstr "" #: ../Doc/c-api/string.rst:126 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/string.rst:135 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/string.rst:140 msgid "" "The `\"%lld\"` and `\"%llu\"` format specifiers are only available when :" "const:`HAVE_LONG_LONG` is defined." msgstr "" #: ../Doc/c-api/string.rst:143 msgid "Support for `\"%lld\"` and `\"%llu\"` added." msgstr "" #: ../Doc/c-api/string.rst:149 msgid "" "Identical to :c:func:`PyString_FromFormat` except that it takes exactly two " "arguments." msgstr "" #: ../Doc/c-api/string.rst:155 msgid "Return the length of the string in string object *string*." msgstr "" #: ../Doc/c-api/string.rst:157 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/string.rst:164 msgid "Macro form of :c:func:`PyString_Size` but without error checking." msgstr "" #: ../Doc/c-api/string.rst:166 msgid "" "This macro returned an :c:type:`int` type. This might require changes in " "your code for properly supporting 64-bit systems." msgstr "" #: ../Doc/c-api/string.rst:173 msgid "" "Return a NUL-terminated representation of the contents of *string*. The " "pointer refers to the internal buffer of *string*, not a copy. The data " "must not be modified in any way, unless the string was just created using " "``PyString_FromStringAndSize(NULL, size)``. It must not be deallocated. If " "*string* is a Unicode object, this function computes the default encoding of " "*string* and operates on that. If *string* is not a string object at all, :" "c:func:`PyString_AsString` returns *NULL* and raises :exc:`TypeError`." msgstr "" #: ../Doc/c-api/string.rst:184 msgid "" "Macro form of :c:func:`PyString_AsString` but without error checking. Only " "string objects are supported; no Unicode objects should be passed." msgstr "" #: ../Doc/c-api/string.rst:190 msgid "" "Return a NUL-terminated representation of the contents of the object *obj* " "through the output variables *buffer* and *length*." msgstr "" #: ../Doc/c-api/string.rst:193 msgid "" "The function accepts both string and Unicode objects as input. For Unicode " "objects it returns the default encoded version of the object. If *length* " "is *NULL*, the resulting buffer may not contain NUL characters; if it does, " "the function returns ``-1`` and a :exc:`TypeError` is raised." msgstr "" #: ../Doc/c-api/string.rst:198 msgid "" "The buffer refers to an internal string buffer of *obj*, not a copy. The " "data must not be modified in any way, unless the string was just created " "using ``PyString_FromStringAndSize(NULL, size)``. It must not be " "deallocated. If *string* is a Unicode object, this function computes the " "default encoding of *string* and operates on that. If *string* is not a " "string object at all, :c:func:`PyString_AsStringAndSize` returns ``-1`` and " "raises :exc:`TypeError`." msgstr "" #: ../Doc/c-api/string.rst:205 msgid "" "This function used an :c:type:`int *` type for *length*. This might require " "changes in your code for properly supporting 64-bit systems." msgstr "" #: ../Doc/c-api/string.rst:212 msgid "" "Create a new string object in *\\*string* containing the contents of " "*newpart* appended to *string*; the caller will own the new reference. The " "reference to the old value of *string* will be stolen. If the new string " "cannot be created, the old reference to *string* will still be discarded and " "the value of *\\*string* will be set to *NULL*; the appropriate exception " "will be set." msgstr "" #: ../Doc/c-api/string.rst:221 msgid "" "Create a new string object in *\\*string* containing the contents of " "*newpart* appended to *string*. This version decrements the reference count " "of *newpart*." msgstr "" #: ../Doc/c-api/string.rst:227 msgid "" "A way to resize a string object even though it is \"immutable\". Only use " "this to build up a brand new string object; don't use this if the string may " "already be known in other parts of the code. It is an error to call this " "function if the refcount on the input string object is not one. Pass the " "address of an existing string object as an lvalue (it may be written into), " "and the new size desired. On success, *\\*string* holds the resized string " "object and ``0`` is returned; the address in *\\*string* may differ from its " "input value. If the reallocation fails, the original string object at *" "\\*string* is deallocated, *\\*string* is set to *NULL*, a memory exception " "is set, and ``-1`` is returned." msgstr "" #: ../Doc/c-api/string.rst:237 msgid "" "This function used an :c:type:`int` type for *newsize*. This might require " "changes in your code for properly supporting 64-bit systems." msgstr "" #: ../Doc/c-api/string.rst:243 msgid "" "Return a new string object from *format* and *args*. Analogous to ``format % " "args``. The *args* argument must be a tuple or dict." msgstr "" #: ../Doc/c-api/string.rst:249 msgid "" "Intern the argument *\\*string* in place. The argument must be the address " "of a pointer variable pointing to a Python string object. If there is an " "existing interned string that is the same as *\\*string*, it sets *" "\\*string* to it (decrementing the reference count of the old string object " "and incrementing the reference count of the interned string object), " "otherwise it leaves *\\*string* alone and interns it (incrementing its " "reference count). (Clarification: even though there is a lot of talk about " "reference counts, think of this function as reference-count-neutral; you own " "the object after the call if and only if you owned it before the call.)" msgstr "" #: ../Doc/c-api/string.rst:261 ../Doc/c-api/string.rst:273 #: ../Doc/c-api/string.rst:286 ../Doc/c-api/string.rst:303 #: ../Doc/c-api/string.rst:316 ../Doc/c-api/string.rst:333 msgid "" "This function is not available in 3.x and does not have a PyBytes alias." msgstr "" #: ../Doc/c-api/string.rst:266 msgid "" "A combination of :c:func:`PyString_FromString` and :c:func:" "`PyString_InternInPlace`, returning either a new string object that has been " "interned, or a new (\"owned\") reference to an earlier interned string " "object with the same value." msgstr "" #: ../Doc/c-api/string.rst:278 msgid "" "Create an object by decoding *size* bytes of the encoded buffer *s* using " "the codec registered for *encoding*. *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/string.rst:288 ../Doc/c-api/string.rst:318 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/string.rst:295 msgid "" "Decode a string object by passing it to the codec registered for *encoding* " "and return the result as Python object. *encoding* and *errors* have the " "same meaning as the parameters of the same name in the string :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/string.rst:308 msgid "" "Encode the :c:type:`char` buffer of the given size by passing it to the " "codec registered for *encoding* and return a Python object. *encoding* and " "*errors* have the same meaning as the parameters of the same name in the " "string :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/string.rst:325 msgid "" "Encode a string object using the codec registered for *encoding* and return " "the result as Python object. *encoding* and *errors* have the same meaning " "as the parameters of the same name in the string :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 ""