unicode.po

# Copyright (C) 2001-2020, Python Software Foundation
# This file is distributed under the same license as the Python package.
# Maintained by the python-doc-es workteam.
# docs-es@python.org /
# https://mail.python.org/mailman3/lists/docs-es.python.org/
# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to
# get the list of volunteers
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-10-12 19:43+0200\n"
"PO-Revision-Date: 2022-11-03 03:56-0400\n"
"Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"
"Language: es\n"
"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
"python.org)\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.13.0\n"

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

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

#: ../Doc/c-api/unicode.rst:14
msgid ""
"Since the implementation of :pep:`393` in Python 3.3, Unicode objects "
"internally use a variety of representations, in order to allow handling the "
"complete range of Unicode characters while staying memory efficient.  There "
"are special cases for strings where all code points are below 128, 256, or "
"65536; otherwise, code points must be below 1114112 (which is the full "
"Unicode range)."
msgstr ""
"Desde la implementación del :pep:`393` en Python 3.3, los objetos Unicode "
"utilizan internamente una variedad de representaciones, para permitir el "
"manejo del rango completo de caracteres Unicode mientras se mantiene la "
"eficiencia de memoria. Hay casos especiales para cadenas de caracteres donde "
"todos los puntos de código están por debajo de 128, 256 o 65536; de lo "
"contrario, los puntos de código deben estar por debajo de 1114112 (que es el "
"rango completo de Unicode)."

#: ../Doc/c-api/unicode.rst:20
msgid ""
"UTF-8 representation is created on demand and cached in the Unicode object."
msgstr ""

#: ../Doc/c-api/unicode.rst:23
#, fuzzy
msgid ""
"The :c:type:`Py_UNICODE` representation has been removed since Python 3.12 "
"with deprecated APIs. See :pep:`623` for more information."
msgstr ""
"El objeto Unicode \"heredado\" se eliminará en Python 3.12 con APIs "
"obsoletas. Todos los objetos Unicode serán \"canónicos\" desde entonces. "
"Consulte :pep:`623` para obtener más información."

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

#: ../Doc/c-api/unicode.rst:31
msgid ""
"These are the basic Unicode object types used for the Unicode implementation "
"in Python:"
msgstr ""
"Estos son los tipos básicos de objetos Unicode utilizados para la "
"implementación de Unicode en Python:"

#: ../Doc/c-api/unicode.rst:38
msgid ""
"These types are typedefs for unsigned integer types wide enough to contain "
"characters of 32 bits, 16 bits and 8 bits, respectively.  When dealing with "
"single Unicode characters, use :c:type:`Py_UCS4`."
msgstr ""
"Estos tipos son definiciones de tipo (*typedefs*) para los tipos 'enteros "
"sin signo' (*unsigned int*) lo suficientemente anchos como para contener "
"caracteres de 32 bits, 16 bits y 8 bits, respectivamente. Cuando se trate "
"con caracteres Unicode individuales, use :c:type:`Py_UCS4`."

#: ../Doc/c-api/unicode.rst:47
#, fuzzy
msgid ""
"This is a typedef of :c:type:`wchar_t`, which is a 16-bit type or 32-bit "
"type depending on the platform."
msgstr ""
"Este es una definición de tipo (*typedef*) de :c:type:`wchar_t`, que es un "
"tipo de 16 bits o de 32 bits dependiendo de la plataforma."

#: ../Doc/c-api/unicode.rst:50
msgid ""
"In previous versions, this was a 16-bit type or a 32-bit type depending on "
"whether you selected a \"narrow\" or \"wide\" Unicode version of Python at "
"build time."
msgstr ""
"En versiones anteriores, este era un tipo de 16 bits o de 32 bits, "
"dependiendo de si seleccionó una versión Unicode \"estrecha\" o \"amplia\" "
"de Python en el momento de la compilación."

#: ../Doc/c-api/unicode.rst:60
msgid ""
"These subtypes of :c:type:`PyObject` represent a Python Unicode object.  In "
"almost all cases, they shouldn't be used directly, since all API functions "
"that deal with Unicode objects take and return :c:type:`PyObject` pointers."
msgstr ""
"Estos subtipos de :c:type:`PyObject` representan un objeto Python Unicode. "
"En casi todos los casos, no deben usarse directamente, ya que todas las "
"funciones API que se ocupan de objetos Unicode toman y retornan punteros :c:"
"type:`PyObject`."

#: ../Doc/c-api/unicode.rst:69
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python Unicode type.  "
"It is exposed to Python code as ``str``."
msgstr ""
"Esta instancia de :c:type:`PyTypeObject` representa el tipo Python Unicode. "
"Está expuesto al código de Python como ``str``."

#: ../Doc/c-api/unicode.rst:73
#, fuzzy
msgid ""
"The following APIs are C macros and static inlined functions for fast checks "
"and access to internal read-only data of Unicode objects:"
msgstr ""
"Las siguientes API son realmente macros de C y se pueden utilizar para "
"realizar comprobaciones rápidas y acceder a datos internos de solo lectura "
"de objetos Unicode:"

#: ../Doc/c-api/unicode.rst:78
msgid ""
"Return true if the object *o* is a Unicode object or an instance of a "
"Unicode subtype.  This function always succeeds."
msgstr ""
"Retorna verdadero si el objeto *o* es un objeto Unicode o una instancia de "
"un subtipo Unicode."

#: ../Doc/c-api/unicode.rst:84
msgid ""
"Return true if the object *o* is a Unicode object, but not an instance of a "
"subtype.  This function always succeeds."
msgstr ""
"Retorna verdadero (*True*) si el objeto *o* es un objeto Unicode, pero no "
"una instancia de un subtipo."

#: ../Doc/c-api/unicode.rst:90
msgid "Returns ``0``. This API is kept only for backward compatibility."
msgstr ""

#: ../Doc/c-api/unicode.rst:94
#, fuzzy
msgid "This API does nothing since Python 3.12."
msgstr "Esta función no lanza excepciones."

#: ../Doc/c-api/unicode.rst:100
msgid ""
"Return the length of the Unicode string, in code points.  *o* has to be a "
"Unicode object in the \"canonical\" representation (not checked)."
msgstr ""
"Retorna la longitud de la cadena de caracteres Unicode, en puntos de código. "
"*o* tiene que ser un objeto Unicode en la representación \"canónica\" (no "
"marcada)."

#: ../Doc/c-api/unicode.rst:110
#, fuzzy
msgid ""
"Return a pointer to the canonical representation cast to UCS1, UCS2 or UCS4 "
"integer types for direct character access.  No checks are performed if the "
"canonical representation has the correct character size; use :c:func:"
"`PyUnicode_KIND` to select the right function."
msgstr ""
"Retorna un puntero a la representación canónica emitida a los tipos enteros "
"UCS1, UCS2 o UCS4 para el acceso directo a los caracteres. No se realizan "
"verificaciones si la representación canónica tiene el tamaño de carácter "
"correcto; use :c:func:`PyUnicode_KIND` para seleccionar el macro correcto. "
"Asegúrese de que se haya llamado a :c:func:`PyUnicode_READY` antes de "
"acceder a esto."

#: ../Doc/c-api/unicode.rst:122
msgid "Return values of the :c:func:`PyUnicode_KIND` macro."
msgstr "Retorna los valores de la macro :c:func:`PyUnicode_KIND`."

#: ../Doc/c-api/unicode.rst:126
#, fuzzy
msgid "``PyUnicode_WCHAR_KIND`` has been removed."
msgstr "``PyUnicode_WCHAR_KIND`` está deprecada."

#: ../Doc/c-api/unicode.rst:132
msgid ""
"Return one of the PyUnicode kind constants (see above) that indicate how "
"many bytes per character this Unicode object uses to store its data.  *o* "
"has to be a Unicode object in the \"canonical\" representation (not checked)."
msgstr ""
"Retorna una de las constantes de tipo ``PyUnicode`` (ver arriba) que indican "
"cuántos bytes por carácter utiliza este objeto Unicode para almacenar sus "
"datos. *o* tiene que ser un objeto Unicode en la representación "
"\"canónica\" (no verificada)."

#: ../Doc/c-api/unicode.rst:141
msgid ""
"Return a void pointer to the raw Unicode buffer.  *o* has to be a Unicode "
"object in the \"canonical\" representation (not checked)."
msgstr ""
"Retorna un puntero vacío al búfer Unicode sin formato. *o* tiene que ser un "
"objeto Unicode en la representación \"canónica\" (no marcada)."

#: ../Doc/c-api/unicode.rst:150
#, fuzzy
msgid ""
"Write into a canonical representation *data* (as obtained with :c:func:"
"`PyUnicode_DATA`).  This function performs no sanity checks, and is intended "
"for usage in loops.  The caller should cache the *kind* value and *data* "
"pointer as obtained from other calls.  *index* is the index in the string "
"(starts at 0) and *value* is the new code point value which should be "
"written to that location."
msgstr ""
"Escribe en una representación canónica *data* (como se obtiene con :c:func:"
"`PyUnicode_DATA`). Esta macro no realiza ninguna comprobación de cordura y "
"está diseñado para su uso en bucles. La persona que llama debe almacenar en "
"caché el valor *kind* y el puntero *data* como se obtiene de otras llamadas "
"de la macro. *index* es el índice en la cadena de caracteres (comienza en 0) "
"y *value* es el nuevo valor del punto de código que debe escribirse en esa "
"ubicación."

#: ../Doc/c-api/unicode.rst:163
msgid ""
"Read a code point from a canonical representation *data* (as obtained with :"
"c:func:`PyUnicode_DATA`).  No checks or ready calls are performed."
msgstr ""
"Lee un punto de código de una representación canónica *data* (obtenido con :"
"c:func:`PyUnicode_DATA`). No se realizan verificaciones ni llamadas "
"preparadas."

#: ../Doc/c-api/unicode.rst:171
msgid ""
"Read a character from a Unicode object *o*, which must be in the "
"\"canonical\" representation.  This is less efficient than :c:func:"
"`PyUnicode_READ` if you do multiple consecutive reads."
msgstr ""
"Lee un carácter de un objeto Unicode *o*, que debe estar en la "
"representación \"canónica\". Esto es menos eficiente que :c:func:"
"`PyUnicode_READ` si realiza varias lecturas consecutivas."

#: ../Doc/c-api/unicode.rst:180
msgid ""
"Return the maximum code point that is suitable for creating another string "
"based on *o*, which must be in the \"canonical\" representation.  This is "
"always an approximation but more efficient than iterating over the string."
msgstr ""
"Retorna el punto de código máximo adecuado para crear otra cadena de "
"caracteres basada en *o*, que debe estar en la representación \"canónica\". "
"Esto siempre es una aproximación pero más eficiente que iterar sobre la "
"cadena."

#: ../Doc/c-api/unicode.rst:189
msgid ""
"Return ``1`` if the string is a valid identifier according to the language "
"definition, section :ref:`identifiers`. Return ``0`` otherwise."
msgstr ""
"Retorna ``1`` si la cadena de caracteres es un identificador válido de "
"acuerdo con la definición del lenguaje, sección :ref:`identifiers`. Retorna "
"``0`` de lo contrario."

#: ../Doc/c-api/unicode.rst:192
msgid ""
"The function does not call :c:func:`Py_FatalError` anymore if the string is "
"not ready."
msgstr ""
"La función ya no llama a :c:func:`Py_FatalError` si la cadena de caracteres "
"no está lista."

#: ../Doc/c-api/unicode.rst:198
msgid "Unicode Character Properties"
msgstr "Propiedades de caracteres Unicode"

#: ../Doc/c-api/unicode.rst:200
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 ""
"Unicode proporciona muchas propiedades de caracteres diferentes. Los que se "
"necesitan con mayor frecuencia están disponibles a través de estas macros "
"que se asignan a las funciones de C según la configuración de Python."

#: ../Doc/c-api/unicode.rst:207
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a whitespace character."
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter de espacio en "
"blanco."

#: ../Doc/c-api/unicode.rst:212
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a lowercase character."
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter en minúscula."

#: ../Doc/c-api/unicode.rst:217
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is an uppercase character."
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter en mayúscula."

#: ../Doc/c-api/unicode.rst:222
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a titlecase character."
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter en caso de "
"título (*titlecase*)."

#: ../Doc/c-api/unicode.rst:227
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a linebreak character."
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter de salto de "
"línea."

#: ../Doc/c-api/unicode.rst:232
msgid "Return ``1`` or ``0`` depending on whether *ch* is a decimal character."
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter decimal o no."

#: ../Doc/c-api/unicode.rst:237
msgid "Return ``1`` or ``0`` depending on whether *ch* is a digit character."
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter de dígitos."

#: ../Doc/c-api/unicode.rst:242
msgid "Return ``1`` or ``0`` depending on whether *ch* is a numeric character."
msgstr "Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter numérico."

#: ../Doc/c-api/unicode.rst:247
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is an alphabetic character."
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter alfabético."

#: ../Doc/c-api/unicode.rst:252
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is an alphanumeric character."
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter alfanumérico."

#: ../Doc/c-api/unicode.rst:257
msgid ""
"Return ``1`` or ``0`` depending on whether *ch* is a printable character. "
"Nonprintable characters are those characters defined in the Unicode "
"character database as \"Other\" or \"Separator\", excepting the ASCII space "
"(0x20) which is considered printable.  (Note that printable characters in "
"this context are those which should not be escaped when :func:`repr` is "
"invoked on a string. It has no bearing on the handling of strings written "
"to :data:`sys.stdout` or :data:`sys.stderr`.)"
msgstr ""
"Retorna ``1`` o ``0`` dependiendo de si *ch* es un carácter imprimible. Los "
"caracteres no imprimibles son aquellos definidos en la base de datos de "
"caracteres Unicode como \"Otro\" o \"Separador\", excepto el espacio ASCII "
"(0x20) que se considera imprimible. (Tenga en cuenta que los caracteres "
"imprimibles en este contexto son aquellos a los que no se debe escapar "
"cuando :func:`repr` se invoca en una cadena de caracteres. No tiene relación "
"con el manejo de cadenas de caracteres escritas en :data:`sys.stdout` o :"
"data:`sys.stderr`.)"

#: ../Doc/c-api/unicode.rst:266
msgid "These APIs can be used for fast direct character conversions:"
msgstr ""
"Estas API se pueden usar para conversiones caracteres rápidas y directos:"

#: ../Doc/c-api/unicode.rst:271
msgid "Return the character *ch* converted to lower case."
msgstr "Retorna el carácter *ch* convertido a minúsculas."

#: ../Doc/c-api/unicode.rst:273 ../Doc/c-api/unicode.rst:281
#: ../Doc/c-api/unicode.rst:289
msgid "This function uses simple case mappings."
msgstr "Esta función utiliza conversiones simples."

#: ../Doc/c-api/unicode.rst:279
msgid "Return the character *ch* converted to upper case."
msgstr "Retorna el carácter *ch* convertido a mayúsculas."

#: ../Doc/c-api/unicode.rst:287
msgid "Return the character *ch* converted to title case."
msgstr "Retorna el carácter *ch* convertido a formato de título (*titlecase*)."

#: ../Doc/c-api/unicode.rst:295
#, fuzzy
msgid ""
"Return the character *ch* converted to a decimal positive integer.  Return "
"``-1`` if this is not possible.  This function does not raise exceptions."
msgstr ""
"Retorna el carácter *ch* convertido a un entero positivo decimal. Retorna "
"``-1`` si esto no es posible. Esta macro no lanza excepciones."

#: ../Doc/c-api/unicode.rst:301
#, fuzzy
msgid ""
"Return the character *ch* converted to a single digit integer. Return ``-1`` "
"if this is not possible.  This function does not raise exceptions."
msgstr ""
"Retorna el carácter *ch* convertido a un entero de un solo dígito. Retorna "
"``-1`` si esto no es posible. Esta macro no lanza excepciones."

#: ../Doc/c-api/unicode.rst:307
#, fuzzy
msgid ""
"Return the character *ch* converted to a double. Return ``-1.0`` if this is "
"not possible.  This function does not raise exceptions."
msgstr ""
"Retorna el carácter *ch* convertido a doble. retorne ``-1.0`` si esto no es "
"posible. Esta macro no lanza excepciones."

#: ../Doc/c-api/unicode.rst:311
msgid "These APIs can be used to work with surrogates:"
msgstr "Estas API se pueden usar para trabajar con sustitutos:"

#: ../Doc/c-api/unicode.rst:315
msgid "Check if *ch* is a surrogate (``0xD800 <= ch <= 0xDFFF``)."
msgstr "Comprueba si *ch* es un sustituto (``0xD800 <= ch <= 0xDFFF``)."

#: ../Doc/c-api/unicode.rst:319
msgid "Check if *ch* is a high surrogate (``0xD800 <= ch <= 0xDBFF``)."
msgstr "Comprueba si *ch* es un sustituto alto (``0xD800 <= ch <= 0xDFFF``)."

#: ../Doc/c-api/unicode.rst:323
msgid "Check if *ch* is a low surrogate (``0xDC00 <= ch <= 0xDFFF``)."
msgstr "Comprueba si *ch* es un sustituto bajo (``0xD800 <= ch <= 0xDFFF``)."

#: ../Doc/c-api/unicode.rst:327
#, fuzzy
msgid ""
"Join two surrogate characters and return a single :c:type:`Py_UCS4` value. "
"*high* and *low* are respectively the leading and trailing surrogates in a "
"surrogate pair. *high* must be in the range [0xD800; 0xDBFF] and *low* must "
"be in the range [0xDC00; 0xDFFF]."
msgstr ""
"Une dos caracteres sustitutos y retorna un solo valor Py_UCS4. *high* y "
"*low* son respectivamente los sustitutos iniciales y finales en un par "
"sustituto."

#: ../Doc/c-api/unicode.rst:334
msgid "Creating and accessing Unicode strings"
msgstr "Creando y accediendo a cadenas de caracteres Unicode"

#: ../Doc/c-api/unicode.rst:336
msgid ""
"To create Unicode objects and access their basic sequence properties, use "
"these APIs:"
msgstr ""
"Para crear objetos Unicode y acceder a sus propiedades de secuencia básicas, "
"use estas API:"

#: ../Doc/c-api/unicode.rst:341
msgid ""
"Create a new Unicode object.  *maxchar* should be the true maximum code "
"point to be placed in the string.  As an approximation, it can be rounded up "
"to the nearest value in the sequence 127, 255, 65535, 1114111."
msgstr ""
"Crea un nuevo objeto Unicode. *maxchar* debe ser el punto de código máximo "
"que se colocará en la cadena de caracteres. Como una aproximación, se puede "
"redondear al valor más cercano en la secuencia 127, 255, 65535, 1114111."

#: ../Doc/c-api/unicode.rst:345
msgid ""
"This is the recommended way to allocate a new Unicode object.  Objects "
"created using this function are not resizable."
msgstr ""
"Esta es la forma recomendada de asignar un nuevo objeto Unicode. Los objetos "
"creados con esta función no se pueden redimensionar."

#: ../Doc/c-api/unicode.rst:354
msgid ""
"Create a new Unicode object with the given *kind* (possible values are :c:"
"macro:`PyUnicode_1BYTE_KIND` etc., as returned by :c:func:"
"`PyUnicode_KIND`).  The *buffer* must point to an array of *size* units of "
"1, 2 or 4 bytes per character, as given by the kind."
msgstr ""
"Crea un nuevo objeto Unicode con el tipo *kind* dado (los valores posibles "
"son :c:macro:`PyUnicode_1BYTE_KIND` etc., según lo retornado por :c:func:"
"`PyUnicode_KIND`). El *búfer* debe apuntar a un vector (*array*) de *tamaño* "
"unidades de 1, 2 o 4 bytes por carácter, según el tipo."

#: ../Doc/c-api/unicode.rst:359
msgid ""
"If necessary, the input *buffer* is copied and transformed into the "
"canonical representation.  For example, if the *buffer* is a UCS4 string (:c:"
"macro:`PyUnicode_4BYTE_KIND`) and it consists only of codepoints in the UCS1 "
"range, it will be transformed into UCS1 (:c:macro:`PyUnicode_1BYTE_KIND`)."
msgstr ""
"Si es necesario, la entrada *buffer* se copia y se transforma en la "
"representación canónica. Por ejemplo, si el *buffer* es una cadena de "
"caracteres UCS4 (:c:macro:`PyUnicode_4BYTE_KIND`) y consta solo de puntos de "
"código en el rango UCS1, se transformará en UCS1 (:c:macro:"
"`PyUnicode_1BYTE_KIND`)."

#: ../Doc/c-api/unicode.rst:370
#, fuzzy
msgid ""
"Create a Unicode object from the char buffer *u*.  The bytes will be "
"interpreted as being UTF-8 encoded.  The buffer is copied into the new "
"object. The return value might be a shared object, i.e. modification of the "
"data is not allowed."
msgstr ""
"Crea un objeto Unicode desde el búfer de caracteres *u*. Los bytes se "
"interpretarán como codificados en UTF-8. El búfer se copia en el nuevo "
"objeto. Si el búfer no es ``NULL``, el valor de retorno podría ser un objeto "
"compartido, es decir, no se permite la modificación de los datos."

#: ../Doc/c-api/unicode.rst:376
#, fuzzy
msgid "This function raises :exc:`SystemError` when:"
msgstr "Esta función no lanza excepciones."

#: ../Doc/c-api/unicode.rst:378
msgid "*size* < 0,"
msgstr ""

#: ../Doc/c-api/unicode.rst:379
msgid "*u* is ``NULL`` and *size* > 0"
msgstr ""

#: ../Doc/c-api/unicode.rst:381
msgid "*u* == ``NULL`` with *size* > 0 is not allowed anymore."
msgstr ""

#: ../Doc/c-api/unicode.rst:387
msgid ""
"Create a Unicode object from a UTF-8 encoded null-terminated char buffer *u*."
msgstr ""
"Crea un objeto Unicode a partir de un búfer *u* de caracteres terminado en "
"nulo y codificado en UTF-8."

#: ../Doc/c-api/unicode.rst:393
#, fuzzy
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* ASCII-encoded string."
msgstr ""
"Toma una cadena de caracteres *format* con el estilo de :c:func:`printf` en "
"C y un número variable de argumentos, calcula el tamaño de la cadena Python "
"Unicode resultante y retorna una cadena de caracteres con los valores "
"formateados. Los argumentos variables deben ser tipos de C y deben "
"corresponder exactamente a los caracteres de formato en la cadena de "
"caracteres *format* codificada en ASCII. Se permiten los siguientes "
"caracteres de formato:"

#: ../Doc/c-api/unicode.rst:399
msgid ""
"A conversion specifier contains two or more characters and has the following "
"components, which must occur in this order:"
msgstr ""

#: ../Doc/c-api/unicode.rst:402
msgid "The ``'%'`` character, which marks the start of the specifier."
msgstr ""

#: ../Doc/c-api/unicode.rst:404
msgid ""
"Conversion flags (optional), which affect the result of some conversion "
"types."
msgstr ""

#: ../Doc/c-api/unicode.rst:407
msgid ""
"Minimum field width (optional). If specified as an ``'*'`` (asterisk), the "
"actual width is given in the next argument, which must be of type :c:expr:"
"`int`, and the object to convert comes after the minimum field width and "
"optional precision."
msgstr ""

#: ../Doc/c-api/unicode.rst:412
msgid ""
"Precision (optional), given as a ``'.'`` (dot) followed by the precision. If "
"specified as ``'*'`` (an asterisk), the actual precision is given in the "
"next argument, which must be of type :c:expr:`int`, and the value to convert "
"comes after the precision."
msgstr ""

#: ../Doc/c-api/unicode.rst:417
msgid "Length modifier (optional)."
msgstr ""

#: ../Doc/c-api/unicode.rst:419
msgid "Conversion type."
msgstr ""

#: ../Doc/c-api/unicode.rst:421
msgid "The conversion flag characters are:"
msgstr ""

#: ../Doc/c-api/unicode.rst:426
msgid "Flag"
msgstr ""

#: ../Doc/c-api/unicode.rst:426
msgid "Meaning"
msgstr ""

#: ../Doc/c-api/unicode.rst:428
msgid "``0``"
msgstr ""

#: ../Doc/c-api/unicode.rst:428
msgid "The conversion will be zero padded for numeric values."
msgstr ""

#: ../Doc/c-api/unicode.rst:430
msgid "``-``"
msgstr ""

#: ../Doc/c-api/unicode.rst:430
msgid ""
"The converted value is left adjusted (overrides the ``0`` flag if both are "
"given)."
msgstr ""

#: ../Doc/c-api/unicode.rst:434
msgid ""
"The length modifiers for following integer conversions (``d``, ``i``, ``o``, "
"``u``, ``x``, or ``X``) specify the type of the argument (:c:expr:`int` by "
"default):"
msgstr ""

#: ../Doc/c-api/unicode.rst:441
msgid "Modifier"
msgstr ""

#: ../Doc/c-api/unicode.rst:441
#, fuzzy
msgid "Types"
msgstr "Tipo"

#: ../Doc/c-api/unicode.rst:443
msgid "``l``"
msgstr ""

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

#: ../Doc/c-api/unicode.rst:445
msgid "``ll``"
msgstr ""

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

#: ../Doc/c-api/unicode.rst:447
msgid "``j``"
msgstr ""

#: ../Doc/c-api/unicode.rst:447
msgid ":c:type:`intmax_t` or :c:type:`uintmax_t`"
msgstr ""

#: ../Doc/c-api/unicode.rst:449
msgid "``z``"
msgstr ""

#: ../Doc/c-api/unicode.rst:449
#, fuzzy
msgid ":c:type:`size_t` or :c:type:`ssize_t`"
msgstr ":c:type:`\\ Py_ssize_t`"

#: ../Doc/c-api/unicode.rst:451
msgid "``t``"
msgstr ""

#: ../Doc/c-api/unicode.rst:451
#, fuzzy
msgid ":c:type:`ptrdiff_t`"
msgstr ":c:type:`\\ Py_ssize_t`"

#: ../Doc/c-api/unicode.rst:454
msgid ""
"The length modifier ``l`` for following conversions ``s`` or ``V`` specify "
"that the type of the argument is :c:expr:`const wchar_t*`."
msgstr ""

#: ../Doc/c-api/unicode.rst:457
msgid "The conversion specifiers are:"
msgstr ""

#: ../Doc/c-api/unicode.rst:463
msgid "Conversion Specifier"
msgstr ""

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

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

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

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

#: ../Doc/c-api/unicode.rst:469
#, fuzzy, python-format
msgid "The literal ``%`` character."
msgstr "El carácter literal %."

#: ../Doc/c-api/unicode.rst:471
msgid "``d``, ``i``"
msgstr ""

#: ../Doc/c-api/unicode.rst:472 ../Doc/c-api/unicode.rst:476
#: ../Doc/c-api/unicode.rst:480 ../Doc/c-api/unicode.rst:484
#: ../Doc/c-api/unicode.rst:488
msgid "Specified by the length modifier"
msgstr ""

#: ../Doc/c-api/unicode.rst:473
msgid "The decimal representation of a signed C integer."
msgstr ""

#: ../Doc/c-api/unicode.rst:475
msgid "``u``"
msgstr ""

#: ../Doc/c-api/unicode.rst:477
msgid "The decimal representation of an unsigned C integer."
msgstr ""

#: ../Doc/c-api/unicode.rst:479
msgid "``o``"
msgstr ""

#: ../Doc/c-api/unicode.rst:481
msgid "The octal representation of an unsigned C integer."
msgstr ""

#: ../Doc/c-api/unicode.rst:483
msgid "``x``"
msgstr ""

#: ../Doc/c-api/unicode.rst:485
msgid "The hexadecimal representation of an unsigned C integer (lowercase)."
msgstr ""

#: ../Doc/c-api/unicode.rst:487
msgid "``X``"
msgstr ""

#: ../Doc/c-api/unicode.rst:489
msgid "The hexadecimal representation of an unsigned C integer (uppercase)."
msgstr ""

#: ../Doc/c-api/unicode.rst:491
msgid "``c``"
msgstr ""

#: ../Doc/c-api/unicode.rst:492
msgid ":c:expr:`int`"
msgstr ""

#: ../Doc/c-api/unicode.rst:493
#, fuzzy
msgid "A single character."
msgstr "Un solo carácter, representado como un entero (*int*) de C."

#: ../Doc/c-api/unicode.rst:495
msgid "``s``"
msgstr ""

#: ../Doc/c-api/unicode.rst:496
msgid ":c:expr:`const char*` or :c:expr:`const wchar_t*`"
msgstr ""

#: ../Doc/c-api/unicode.rst:497
msgid "A null-terminated C character array."
msgstr "Un arreglo de caracteres de C terminada en nulo."

#: ../Doc/c-api/unicode.rst:499
msgid "``p``"
msgstr ""

#: ../Doc/c-api/unicode.rst:500
#, fuzzy
msgid ":c:expr:`const void*`"
msgstr "const void\\*"

#: ../Doc/c-api/unicode.rst:501
#, fuzzy
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 ""
"La representación hexadecimal de un puntero en C. Principalmente equivalente "
"a ``printf(\"%p\")`` excepto que se garantiza que comience con el literal "
"``0x``, independiente de lo que produzca el ``printf`` de la plataforma."

#: ../Doc/c-api/unicode.rst:506
msgid "``A``"
msgstr ""

#: ../Doc/c-api/unicode.rst:507 ../Doc/c-api/unicode.rst:511
#: ../Doc/c-api/unicode.rst:521 ../Doc/c-api/unicode.rst:525
#, fuzzy
msgid ":c:expr:`PyObject*`"
msgstr "PyObject\\*"

#: ../Doc/c-api/unicode.rst:508
msgid "The result of calling :func:`ascii`."
msgstr "El resultado de llamar :func:`ascii`."

#: ../Doc/c-api/unicode.rst:510
msgid "``U``"
msgstr ""

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

#: ../Doc/c-api/unicode.rst:514
msgid "``V``"
msgstr ""

#: ../Doc/c-api/unicode.rst:515
msgid ":c:expr:`PyObject*`, :c:expr:`const char*` or :c:expr:`const wchar_t*`"
msgstr ""

#: ../Doc/c-api/unicode.rst:516
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 ""
"Un objeto Unicode (que puede ser ``NULL``) y un arreglo de caracteres de C "
"terminada en nulo como segundo parámetro (que se utilizará, si el primer "
"parámetro es ``NULL``)."

#: ../Doc/c-api/unicode.rst:520
msgid "``S``"
msgstr ""

#: ../Doc/c-api/unicode.rst:522
msgid "The result of calling :c:func:`PyObject_Str`."
msgstr "El resultado de llamar :c:func:`PyObject_Str`."

#: ../Doc/c-api/unicode.rst:524
msgid "``R``"
msgstr ""

#: ../Doc/c-api/unicode.rst:526
msgid "The result of calling :c:func:`PyObject_Repr`."
msgstr "El resultado de llamar :c:func:`PyObject_Repr`."

#: ../Doc/c-api/unicode.rst:529
#, fuzzy, python-format
msgid ""
"The width formatter unit is number of characters rather than bytes. The "
"precision formatter unit is number of bytes or :c:type:`wchar_t` items (if "
"the length modifier ``l`` is used) for ``\"%s\"`` and ``\"%V\"`` (if the "
"``PyObject*`` argument is ``NULL``), and a number of characters for "
"``\"%A\"``, ``\"%U\"``, ``\"%S\"``, ``\"%R\"`` and ``\"%V\"`` (if the "
"``PyObject*`` argument is not ``NULL``)."
msgstr ""
"La unidad del formateador de ancho es el número de caracteres en lugar de "
"bytes. La unidad del formateador de precisión es la cantidad de bytes para "
"``\"%s\"`` y ``\"%V\"`` (si el argumento ``PyObject*`` es ``NULL``), y una "
"cantidad de caracteres para ``\"%A\"``, ``\"%U\"``, ``\"%S\"``, ``\"%R\"`` y "
"``\"%V\"`` (si el argumento ``PyObject*`` no es ``NULL``)."

#: ../Doc/c-api/unicode.rst:537
msgid ""
"Unlike to C :c:func:`printf` the ``0`` flag has effect even when a precision "
"is given for integer conversions (``d``, ``i``, ``u``, ``o``, ``x``, or "
"``X``)."
msgstr ""

#: ../Doc/c-api/unicode.rst:541
msgid "Support for ``\"%lld\"`` and ``\"%llu\"`` added."
msgstr "Soporte agregado para ``\"%lld\"`` y ``\"%llu\"``."

#: ../Doc/c-api/unicode.rst:544
#, python-format
msgid "Support for ``\"%li\"``, ``\"%lli\"`` and ``\"%zi\"`` added."
msgstr "Soporte agregado para ``\"%li\"``, ``\"%lli\"`` y ``\"%zi\"``."

#: ../Doc/c-api/unicode.rst:547
#, python-format
msgid ""
"Support width and precision formatter for ``\"%s\"``, ``\"%A\"``, "
"``\"%U\"``, ``\"%V\"``, ``\"%S\"``, ``\"%R\"`` added."
msgstr ""
"Soporte agregado para formateadores de anchura y precisión para ``\"%s\"``, "
"``\"%A\"``, ``\"%U\"``, ``\"%V\"``, ``\"%S\"``, ``\"%R\"``."

#: ../Doc/c-api/unicode.rst:551
msgid ""
"Support for conversion specifiers ``o`` and ``X``. Support for length "
"modifiers ``j`` and ``t``. Length modifiers are now applied to all integer "
"conversions. Length modifier ``l`` is now applied to conversion specifiers "
"``s`` and ``V``. Support for variable width and precision ``*``. Support for "
"flag ``-``."
msgstr ""

#: ../Doc/c-api/unicode.rst:559
#, fuzzy
msgid ""
"An unrecognized format character now sets a :exc:`SystemError`. In previous "
"versions it caused all the rest of the format string to be copied as-is to "
"the result string, and any extra arguments discarded."
msgstr ""
"Un carácter de formato no reconocido hace que todo el resto de la cadena de "
"formato se copie tal cual a la cadena de resultado y se descartan los "
"argumentos adicionales."

#: ../Doc/c-api/unicode.rst:566
msgid ""
"Identical to :c:func:`PyUnicode_FromFormat` except that it takes exactly two "
"arguments."
msgstr ""
"Idéntico a :c:func:`PyUnicode_FromFormat` excepto que toma exactamente dos "
"argumentos."

#: ../Doc/c-api/unicode.rst:572
#, fuzzy
msgid ""
"Copy an instance of a Unicode subtype to a new true Unicode object if "
"necessary. If *obj* is already a true Unicode object (not a subtype), return "
"a new :term:`strong reference` to the object."
msgstr ""
"Copia una instancia de un subtipo Unicode a un nuevo objeto Unicode "
"verdadero si es necesario. Si *obj* ya es un verdadero objeto Unicode (no un "
"subtipo), retorna la referencia con un recuento incrementado."

#: ../Doc/c-api/unicode.rst:576
msgid ""
"Objects other than Unicode or its subtypes will cause a :exc:`TypeError`."
msgstr ""
"Los objetos que no sean Unicode o sus subtipos causarán un :exc:`TypeError`."

#: ../Doc/c-api/unicode.rst:582
msgid "Decode an encoded object *obj* to a Unicode object."
msgstr "Decodifica un objeto codificado *obj* en un objeto Unicode."

#: ../Doc/c-api/unicode.rst:584
msgid ""
":class:`bytes`, :class:`bytearray` and other :term:`bytes-like objects "
"<bytes-like object>` 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 :ref:`builtincodecs` for details)."
msgstr ""
":class:`bytes`, :class:`bytearray` y otros :term:`los objetos similares a "
"bytes <bytes-like object>` se decodifican de acuerdo con el *encoding* dado "
"y utilizan el manejo de errores definido por *errors*. Ambos pueden ser "
"``NULL`` para que la interfaz use los valores predeterminados (ver :ref:"
"`builtincodecs` para más detalles)."

#: ../Doc/c-api/unicode.rst:590
msgid ""
"All other objects, including Unicode objects, cause a :exc:`TypeError` to be "
"set."
msgstr ""
"Todos los demás objetos, incluidos los objetos Unicode, hacen que se "
"establezca un :exc:`TypeError`."

#: ../Doc/c-api/unicode.rst:593
msgid ""
"The API returns ``NULL`` if there was an error.  The caller is responsible "
"for decref'ing the returned objects."
msgstr ""
"La API retorna ``NULL`` si hubo un error. La entidad que hace la llamadas es "
"la responsable de desreferenciar los objetos retornados."

#: ../Doc/c-api/unicode.rst:599
msgid "Return the length of the Unicode object, in code points."
msgstr "Retorna la longitud del objeto Unicode, en puntos de código."

#: ../Doc/c-api/unicode.rst:610
#, fuzzy
msgid ""
"Copy characters from one Unicode object into another.  This function "
"performs character conversion when necessary and falls back to :c:func:`!"
"memcpy` if possible.  Returns ``-1`` and sets an exception on error, "
"otherwise returns the number of copied characters."
msgstr ""
"Copia caracteres de un objeto Unicode en otro. Esta función realiza la "
"conversión de caracteres cuando es necesario y recurre a :c:func:`memcpy` si "
"es posible. Retorna ``-1`` y establece una excepción en caso de error; de lo "
"contrario, retorna el número de caracteres copiados."