# 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: 2021-03-19 11:16+0100\n"

"PO-Revision-Date: 2021-08-07 16:58+0200\n"

"Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"

"Language: es\n"

"Language-Team: python-doc-es\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.8.0\n"

"X-Generator: Poedit 3.0\n"

#: ../Doc/library/ctypes.rst:2

msgid ":mod:`ctypes` --- A foreign function library for Python"

msgstr ":mod:`ctypes` --- Una biblioteca de funciones foráneas para Python"

#: ../Doc/library/ctypes.rst:11

msgid ""

":mod:`ctypes` is a foreign function library for Python. It provides C "

"compatible data types, and allows calling functions in DLLs or shared "

"libraries. It can be used to wrap these libraries in pure Python."

msgstr ""

":mod:`ctypes` es una biblioteca de funciones foráneas para Python. "

"Proporciona tipos de datos compatibles con C y permite llamar a funciones en "

"archivos DLL o bibliotecas compartidas. Se puede utilizar para envolver "

"estas bibliotecas en Python puro."

#: ../Doc/library/ctypes.rst:19

msgid "ctypes tutorial"

msgstr "tutorial de ctypes"

#: ../Doc/library/ctypes.rst:21

msgid ""

"Note: The code samples in this tutorial use :mod:`doctest` to make sure that "

"they actually work. Since some code samples behave differently under Linux, "

"Windows, or Mac OS X, they contain doctest directives in comments."

msgstr ""

"Nota: Los ejemplos de código de este tutorial utilizan :mod:`doctest` para "

"asegurarse de que realmente funcionan. Dado que algunos ejemplos de código "

"se comportan de manera diferente en Linux, Windows o Mac OS X, contienen "

"directivas de prueba en los comentarios."

#: ../Doc/library/ctypes.rst:25

msgid ""

"Note: Some code samples reference the ctypes :class:`c_int` type. On "

"platforms where ``sizeof(long) == sizeof(int)`` it is an alias to :class:"

"`c_long`. So, you should not be confused if :class:`c_long` is printed if "

"you would expect :class:`c_int` --- they are actually the same type."

msgstr ""

"Nota: Algunos ejemplos de código hacen referencia al tipo ctypes :class:"

"`c_int`. En las plataformas donde ``sizeof(long) == sizeof(int)`` es un "

"alias de :class:`c_long`. Por lo tanto, no debe confundirse si :class:"

"`c_long` se imprime si espera :class:`c_int` --- son en realidad del mismo "

"tipo."

#: ../Doc/library/ctypes.rst:33

msgid "Loading dynamic link libraries"

msgstr "Carga de bibliotecas de enlaces dinámicos"

#: ../Doc/library/ctypes.rst:35

msgid ""

":mod:`ctypes` exports the *cdll*, and on Windows *windll* and *oledll* "

"objects, for loading dynamic link libraries."

msgstr ""

":mod:`ctypes` exporta los objetos *cdll* y en Windows *windll* y *oledll*, "

"para cargar bibliotecas de enlaces dinámicos."

#: ../Doc/library/ctypes.rst:38

msgid ""

"You load libraries by accessing them as attributes of these objects. *cdll* "

"loads libraries which export functions using the standard ``cdecl`` calling "

"convention, while *windll* libraries call functions using the ``stdcall`` "

"calling convention. *oledll* also uses the ``stdcall`` calling convention, "

"and assumes the functions return a Windows :c:type:`HRESULT` error code. The "

"error code is used to automatically raise an :class:`OSError` exception when "

"the function call fails."

msgstr ""

"Las bibliotecas se cargan accediendo a ellas como atributos de estos "

"objetos. *cdll* carga bibliotecas que exportan funciones utilizando la "

"convención de llamada estándar ``cdecl``, mientras que las bibliotecas "

"*windll* llaman a funciones mediante la convención de llamada ``stdcall``. "

"*oledll* también utiliza la convención de llamada ``stdcall`` y asume que "

"las funciones retornan un código de error Windows :c:type:`HRESULT`. El "

"código de error se utiliza para generar automáticamente una excepción :class:"

"`OSError` cuando se produce un error en la llamada a la función."

#: ../Doc/library/ctypes.rst:46

msgid ""

"Windows errors used to raise :exc:`WindowsError`, which is now an alias of :"

"exc:`OSError`."

msgstr ""

"Los errores de Windows solían generar :exc:`WindowsError`, que ahora es un "

"alias de :exc:`OSError`."

#: ../Doc/library/ctypes.rst:51

msgid ""

"Here are some examples for Windows. Note that ``msvcrt`` is the MS standard "

"C library containing most standard C functions, and uses the cdecl calling "

"convention::"

msgstr ""

"Estos son algunos ejemplos para Windows. Tener en cuenta que ''msvcrt'' es "

"la biblioteca estándar de MS C que contiene la mayoría de las funciones C "

"estándar y utiliza la convención de llamada cdecl::"

#: ../Doc/library/ctypes.rst:63

msgid "Windows appends the usual ``.dll`` file suffix automatically."

msgstr "Windows agrega automáticamente la extensión común ``.dll``."

#: ../Doc/library/ctypes.rst:66

msgid ""

"Accessing the standard C library through ``cdll.msvcrt`` will use an "

"outdated version of the library that may be incompatible with the one being "

"used by Python. Where possible, use native Python functionality, or else "

"import and use the ``msvcrt`` module."

msgstr ""

"Acceder a la biblioteca estándar de C a través de ``cdll.msvcrt`` utilizará "

"una versión obsoleta de la biblioteca que puede ser incompatible con la "

"utilizada por Python. Cuando sea posible, use la funcionalidad nativa de "

"Python, o bien importe y use el módulo ``msvcrt``."

#: ../Doc/library/ctypes.rst:71

msgid ""

"On Linux, it is required to specify the filename *including* the extension "

"to load a library, so attribute access can not be used to load libraries. "

"Either the :meth:`LoadLibrary` method of the dll loaders should be used, or "

"you should load the library by creating an instance of CDLL by calling the "

"constructor::"

msgstr ""

"En Linux, se requiere especificar el nombre de archivo *incluyendo* la "

"extensión para cargar una biblioteca, por lo que no se puede utilizar el "

"acceso por atributos para cargar las bibliotecas. Se debe usar el método :"

"meth:`LoadLibrary` de los cargadores de dll, o se debe cargar la biblioteca "

"creando una instancia de CDLL llamando al constructor::"

#: ../Doc/library/ctypes.rst:89

msgid "Accessing functions from loaded dlls"

msgstr "Acceder a las funciones de los dll cargados"

#: ../Doc/library/ctypes.rst:91

msgid "Functions are accessed as attributes of dll objects::"

msgstr "Las funciones se acceden como atributos de los objetos dll::"

#: ../Doc/library/ctypes.rst:106

msgid ""

"Note that win32 system dlls like ``kernel32`` and ``user32`` often export "

"ANSI as well as UNICODE versions of a function. The UNICODE version is "

"exported with an ``W`` appended to the name, while the ANSI version is "

"exported with an ``A`` appended to the name. The win32 ``GetModuleHandle`` "

"function, which returns a *module handle* for a given module name, has the "

"following C prototype, and a macro is used to expose one of them as "

"``GetModuleHandle`` depending on whether UNICODE is defined or not::"

msgstr ""

"Nótese que las dlls del sistema win32 como ``kernel32`` y ``user32`` a "

"menudo exportan versiones ANSI y UNICODE de una función. La versión UNICODE "

"se exporta con una ``W`` añadida al nombre, mientras que la versión ANSI se "

"exporta con una ``A`` añadida al nombre. La función ``GetModuleHandle`` de "

"win32, que retorna un *manejador de módulo* para un nombre de módulo dado, "

"tiene el siguiente prototipo de C, y se usa una macro para exponer uno de "

"ellos como ``GetModuleHandle`` dependiendo de si UNICODE está definido o no::"

#: ../Doc/library/ctypes.rst:119

msgid ""

"*windll* does not try to select one of them by magic, you must access the "

"version you need by specifying ``GetModuleHandleA`` or ``GetModuleHandleW`` "

"explicitly, and then call it with bytes or string objects respectively."

msgstr ""

"*windll* no intenta seleccionar una de ellas por arte de magia, se debe "

"acceder a la versión que se necesita especificando ``GetModuleHandleA`` o "

"``GetModuleHandleW`` explícitamente, y luego llamarlo con bytes u objetos de "

"cadena respectivamente."

#: ../Doc/library/ctypes.rst:123

msgid ""

"Sometimes, dlls export functions with names which aren't valid Python "

"identifiers, like ``\"??2@YAPAXI@Z\"``. In this case you have to use :func:"

"`getattr` to retrieve the function::"

msgstr ""

"A veces, las dlls exportan funciones con nombres que no son identificadores "

"válidos de Python, como ``\"??2@YAPAXI@Z\"``. En este caso tienes que usar :"

"func:`getattr` para recuperar la función::"

#: ../Doc/library/ctypes.rst:131

msgid ""

"On Windows, some dlls export functions not by name but by ordinal. These "

"functions can be accessed by indexing the dll object with the ordinal "

"number::"

msgstr ""

"En Windows, algunas dlls exportan funciones no por nombre sino por ordinal. "

"Se pueden acceder a estas funciones indexando el objeto dll con el número "

"ordinal::"

#: ../Doc/library/ctypes.rst:148

msgid "Calling functions"

msgstr "Funciones de llamada"

#: ../Doc/library/ctypes.rst:150

msgid ""

"You can call these functions like any other Python callable. This example "

"uses the ``time()`` function, which returns system time in seconds since the "

"Unix epoch, and the ``GetModuleHandleA()`` function, which returns a win32 "

"module handle."

msgstr ""

"Puedes llamar a estas funciones como cualquier otra función en Python. Este "

"ejemplo utiliza la función ``time()``, que retorna el tiempo del sistema en "

"segundos desde la época de Unix, y la función ``GetModuleHandleA()``, que "

"retorna un manejador de módulo de win32."

#: ../Doc/library/ctypes.rst:155

msgid ""

"This example calls both functions with a ``NULL`` pointer (``None`` should "

"be used as the ``NULL`` pointer)::"

msgstr ""

"Este ejemplo llama a ambas funciones con un puntero ``NULL`` (``None`` debe "

"ser usado como el puntero ``NULL``)::"

#: ../Doc/library/ctypes.rst:164

msgid ""

":exc:`ValueError` is raised when you call an ``stdcall`` function with the "

"``cdecl`` calling convention, or vice versa::"

msgstr ""

":exc:`ValueError` es lanzado cuando se llama a una función ``stdcall`` con "

"la convención de llamada ``cdecl``, o viceversa::"

#: ../Doc/library/ctypes.rst:179

msgid ""

"To find out the correct calling convention you have to look into the C "

"header file or the documentation for the function you want to call."

msgstr ""

"Para saber la convención de llamada correcta, hay que mirar en el archivo de "

"encabezado C o en la documentación de la función que se quiere llamar."

#: ../Doc/library/ctypes.rst:182

msgid ""

"On Windows, :mod:`ctypes` uses win32 structured exception handling to "

"prevent crashes from general protection faults when functions are called "

"with invalid argument values::"

msgstr ""

"En Windows, :mod:`ctypes` utiliza la gestión de excepciones estructurada de "

"win32 para evitar que se produzcan fallos de protección general cuando se "

"llaman funciones con valores de argumento inválidos::"

#: ../Doc/library/ctypes.rst:192

msgid ""

"There are, however, enough ways to crash Python with :mod:`ctypes`, so you "

"should be careful anyway. The :mod:`faulthandler` module can be helpful in "

"debugging crashes (e.g. from segmentation faults produced by erroneous C "

"library calls)."

msgstr ""

"Sin embargo, hay suficientes maneras de bloquear Python con :mod:`ctypes`, "

"así que debes tener cuidado de todos modos. El módulo :mod:`faulthandler` "

"puede ser útil para depurar bloqueos (por ejemplo, provenientes de fallos de "

"segmentación producidos por llamadas erróneas a la biblioteca C)."

#: ../Doc/library/ctypes.rst:197

msgid ""

"``None``, integers, bytes objects and (unicode) strings are the only native "

"Python objects that can directly be used as parameters in these function "

"calls. ``None`` is passed as a C ``NULL`` pointer, bytes objects and strings "

"are passed as pointer to the memory block that contains their data (:c:type:"

"`char *` or :c:type:`wchar_t *`). Python integers are passed as the "

"platforms default C :c:type:`int` type, their value is masked to fit into "

"the C type."

msgstr ""

"Los objetos ``None``, enteros, bytes y cadenas (unicode) son los únicos "

"objetos nativos de Python que pueden ser usados directamente como parámetros "

"en estas llamadas a funciones. ``None`` se pasa como puntero de C ``NULL``, "

"los objetos bytes y las cadenas se pasan como puntero al bloque de memoria "

"que contiene sus datos (:c:type:`char *` o :c:type:`wchar_t *`). Los enteros "

"de Python se pasan como por defecto en la plataforma como tipo :c:type:`int` "

"de C, su valor se enmascara para que encuadre en el tipo C."

#: ../Doc/library/ctypes.rst:204

msgid ""

"Before we move on calling functions with other parameter types, we have to "

"learn more about :mod:`ctypes` data types."

msgstr ""

"Antes de pasar a llamar funciones con otros tipos de parámetros, tenemos que "

"aprender más sobre los tipos de datos :mod:`ctypes`."

#: ../Doc/library/ctypes.rst:211 ../Doc/library/ctypes.rst:2143

msgid "Fundamental data types"

msgstr "Tipos de datos fundamentales"

#: ../Doc/library/ctypes.rst:213

msgid ":mod:`ctypes` defines a number of primitive C compatible data types:"

msgstr ""

":mod:`ctypes` define un número de tipos de datos primitivos compatibles con "

"C:"

#: ../Doc/library/ctypes.rst:216

msgid "ctypes type"

msgstr "tipo ctypes"

#: ../Doc/library/ctypes.rst:216

msgid "C type"

msgstr "Tipo C"

#: ../Doc/library/ctypes.rst:216

msgid "Python type"

msgstr "Tipo Python"

#: ../Doc/library/ctypes.rst:218

msgid ":class:`c_bool`"

msgstr ":class:`c_bool`"

#: ../Doc/library/ctypes.rst:218

msgid ":c:type:`_Bool`"

msgstr ":c:type:`_Bool`"

#: ../Doc/library/ctypes.rst:218

msgid "bool (1)"

msgstr "bool (1)"

#: ../Doc/library/ctypes.rst:220

msgid ":class:`c_char`"

msgstr ":class:`c_char`"

#: ../Doc/library/ctypes.rst:220 ../Doc/library/ctypes.rst:224

msgid ":c:type:`char`"

msgstr ":c:type:`char`"

#: ../Doc/library/ctypes.rst:220

msgid "1-character bytes object"

msgstr "Un objeto bytes de 1-caracter"

#: ../Doc/library/ctypes.rst:222

msgid ":class:`c_wchar`"

msgstr ":class:`c_wchar`"

#: ../Doc/library/ctypes.rst:222

msgid ":c:type:`wchar_t`"

msgstr ":c:type:`wchar_t`"

#: ../Doc/library/ctypes.rst:222

msgid "1-character string"

msgstr "Una cadena de 1-caracter"

#: ../Doc/library/ctypes.rst:224

msgid ":class:`c_byte`"

msgstr ":class:`c_byte`"

#: ../Doc/library/ctypes.rst:224 ../Doc/library/ctypes.rst:226

#: ../Doc/library/ctypes.rst:228 ../Doc/library/ctypes.rst:230

#: ../Doc/library/ctypes.rst:232 ../Doc/library/ctypes.rst:234

#: ../Doc/library/ctypes.rst:236 ../Doc/library/ctypes.rst:238

#: ../Doc/library/ctypes.rst:240 ../Doc/library/ctypes.rst:242

#: ../Doc/library/ctypes.rst:245 ../Doc/library/ctypes.rst:247

msgid "int"

msgstr "entero"

#: ../Doc/library/ctypes.rst:226

msgid ":class:`c_ubyte`"

msgstr ":class:`c_ubyte`"

#: ../Doc/library/ctypes.rst:226

msgid ":c:type:`unsigned char`"

msgstr ":c:type:`unsigned char`"

#: ../Doc/library/ctypes.rst:228

msgid ":class:`c_short`"

msgstr ":class:`c_short`"

#: ../Doc/library/ctypes.rst:228

msgid ":c:type:`short`"

msgstr ":c:type:`short`"

#: ../Doc/library/ctypes.rst:230

msgid ":class:`c_ushort`"

msgstr ":class:`c_ushort`"

#: ../Doc/library/ctypes.rst:230

msgid ":c:type:`unsigned short`"

msgstr ":c:type:`unsigned short`"

#: ../Doc/library/ctypes.rst:232

msgid ":class:`c_int`"

msgstr ":class:`c_int`"

#: ../Doc/library/ctypes.rst:232

msgid ":c:type:`int`"

msgstr ":c:type:`int`"

#: ../Doc/library/ctypes.rst:234

msgid ":class:`c_uint`"

msgstr ":class:`c_uint`"

#: ../Doc/library/ctypes.rst:234

msgid ":c:type:`unsigned int`"

msgstr ":c:type:`unsigned int`"

#: ../Doc/library/ctypes.rst:236

msgid ":class:`c_long`"

msgstr ":class:`c_long`"

#: ../Doc/library/ctypes.rst:236

msgid ":c:type:`long`"

msgstr ":c:type:`long`"

#: ../Doc/library/ctypes.rst:238

msgid ":class:`c_ulong`"

msgstr ":class:`c_ulong`"

#: ../Doc/library/ctypes.rst:238

msgid ":c:type:`unsigned long`"

msgstr ":c:type:`unsigned long`"

#: ../Doc/library/ctypes.rst:240

msgid ":class:`c_longlong`"

msgstr ":class:`c_longlong`"

#: ../Doc/library/ctypes.rst:240

msgid ":c:type:`__int64` or :c:type:`long long`"

msgstr ":c:type:`__int64` o :c:type:`long long`"

#: ../Doc/library/ctypes.rst:242

msgid ":class:`c_ulonglong`"

msgstr ":class:`c_ulonglong`"

#: ../Doc/library/ctypes.rst:242

msgid ":c:type:`unsigned __int64` or :c:type:`unsigned long long`"

msgstr ":c:type:`unsigned __int64` o :c:type:`unsigned long long`"

#: ../Doc/library/ctypes.rst:245

msgid ":class:`c_size_t`"

msgstr ":class:`c_size_t`"

#: ../Doc/library/ctypes.rst:245

msgid ":c:type:`size_t`"

msgstr ":c:type:`size_t`"

#: ../Doc/library/ctypes.rst:247

msgid ":class:`c_ssize_t`"

msgstr ":class:`c_ssize_t`"

#: ../Doc/library/ctypes.rst:247

msgid ":c:type:`ssize_t` or :c:type:`Py_ssize_t`"

msgstr ":c:type:`ssize_t` o :c:type:`Py_ssize_t`"

#: ../Doc/library/ctypes.rst:250

msgid ":class:`c_float`"

msgstr ":class:`c_float`"

#: ../Doc/library/ctypes.rst:250

msgid ":c:type:`float`"

msgstr ":c:type:`float`"

#: ../Doc/library/ctypes.rst:250 ../Doc/library/ctypes.rst:252

#: ../Doc/library/ctypes.rst:254

msgid "float"

msgstr "flotante"

#: ../Doc/library/ctypes.rst:252

msgid ":class:`c_double`"

msgstr ":class:`c_double`"

#: ../Doc/library/ctypes.rst:252

msgid ":c:type:`double`"

msgstr ":c:type:`double`"

#: ../Doc/library/ctypes.rst:254

msgid ":class:`c_longdouble`"

msgstr ":class:`c_longdouble`"

#: ../Doc/library/ctypes.rst:254

msgid ":c:type:`long double`"

msgstr ":c:type:`long double`"

#: ../Doc/library/ctypes.rst:256

msgid ":class:`c_char_p`"

msgstr ":class:`c_char_p`"

#: ../Doc/library/ctypes.rst:256

msgid ":c:type:`char *` (NUL terminated)"

msgstr ":c:type:`char *` (NUL terminated)"

#: ../Doc/library/ctypes.rst:256

msgid "bytes object or ``None``"

msgstr "objecto de bytes o ``None``"

#: ../Doc/library/ctypes.rst:258

msgid ":class:`c_wchar_p`"

msgstr ":class:`c_wchar_p`"

#: ../Doc/library/ctypes.rst:258

msgid ":c:type:`wchar_t *` (NUL terminated)"

msgstr ":c:type:`wchar_t *` (NUL terminated)"

#: ../Doc/library/ctypes.rst:258

msgid "string or ``None``"

msgstr "cadena o ``None``"

#: ../Doc/library/ctypes.rst:260

msgid ":class:`c_void_p`"

msgstr ":class:`c_void_p`"

#: ../Doc/library/ctypes.rst:260

msgid ":c:type:`void *`"

msgstr ":c:type:`void *`"

#: ../Doc/library/ctypes.rst:260

msgid "int or ``None``"

msgstr "entero o ``None``"

#: ../Doc/library/ctypes.rst:264

msgid "The constructor accepts any object with a truth value."

msgstr "El constructor acepta cualquier objeto con valor verdadero."

#: ../Doc/library/ctypes.rst:266

msgid ""

"All these types can be created by calling them with an optional initializer "

"of the correct type and value::"

msgstr ""

"Todos estos tipos pueden ser creados llamándolos con un inicializador "

"opcional del tipo y valor correctos::"

#: ../Doc/library/ctypes.rst:277

msgid ""

"Since these types are mutable, their value can also be changed afterwards::"

msgstr ""

"Dado que estos tipos son mutables, su valor también puede ser cambiado "

"después::"

#: ../Doc/library/ctypes.rst:289

msgid ""

"Assigning a new value to instances of the pointer types :class:`c_char_p`, :"

"class:`c_wchar_p`, and :class:`c_void_p` changes the *memory location* they "

"point to, *not the contents* of the memory block (of course not, because "

"Python bytes objects are immutable)::"

msgstr ""

"Asignando un nuevo valor a las instancias de los tipos de punteros :class:"

"`c_char_p`, :class:`c_wchar_p`, y :class:`c_void_p` cambia el *lugar de "

"memoria* al que apuntan, *no el contenido* del bloque de memoria (por "

"supuesto que no, porque los objetos de bytes de Python son inmutables)::"

#: ../Doc/library/ctypes.rst:309

msgid ""

"You should be careful, however, not to pass them to functions expecting "

"pointers to mutable memory. If you need mutable memory blocks, ctypes has a :"

"func:`create_string_buffer` function which creates these in various ways. "

"The current memory block contents can be accessed (or changed) with the "

"``raw`` property; if you want to access it as NUL terminated string, use the "

"``value`` property::"

msgstr ""

"Sin embargo, debe tener cuidado de no pasarlos a funciones que esperan "

"punteros a la memoria mutable. Si necesitas bloques de memoria mutables, "

"ctypes tiene una función :func:`create_string_buffer` que los crea de varias "

"maneras. El contenido actual del bloque de memoria puede ser accedido (o "

"cambiado) con la propiedad ``raw``; si quieres acceder a él como cadena "

"terminada NUL, usa la propiedad ``value``::"

#: ../Doc/library/ctypes.rst:333

msgid ""

"The :func:`create_string_buffer` function replaces the :func:`c_buffer` "

"function (which is still available as an alias), as well as the :func:"

"`c_string` function from earlier ctypes releases. To create a mutable "

"memory block containing unicode characters of the C type :c:type:`wchar_t` "

"use the :func:`create_unicode_buffer` function."

msgstr ""

"La función :func:`create_string_buffer` reemplaza a la función :func:"

"`c_buffer` (que todavía está disponible como un alias), así como a la "

"función :func:`c_string` de versiones anteriores de ctypes. Para crear un "

"bloque de memoria mutable que contenga caracteres unicode del tipo C :c:type:"

"`wchar_t` utilice la función :func:`create_unicode_buffer`."

#: ../Doc/library/ctypes.rst:343

msgid "Calling functions, continued"

msgstr "Funciones de llamada, continuación"

#: ../Doc/library/ctypes.rst:345

msgid ""

"Note that printf prints to the real standard output channel, *not* to :data:"

"`sys.stdout`, so these examples will only work at the console prompt, not "

"from within *IDLE* or *PythonWin*::"

msgstr ""

"Note que printf imprime al canal de salida estándar real, *no* a :data:`sys."

"stdout`, por lo que estos ejemplos sólo funcionarán en el prompt de la "

"consola, no desde dentro de *IDLE* o *PythonWin*::"

#: ../Doc/library/ctypes.rst:365

msgid ""

"As has been mentioned before, all Python types except integers, strings, and "

"bytes objects have to be wrapped in their corresponding :mod:`ctypes` type, "

"so that they can be converted to the required C data type::"

msgstr ""

"Como se ha mencionado antes, todos los tipos de Python, excepto los enteros, "

"cadenas y objetos bytes, tienen que ser envueltos en su correspondiente "

"tipo :mod:`ctypes`, para que puedan ser convertidos al tipo de datos C "

"requerido::"

#: ../Doc/library/ctypes.rst:378

msgid "Calling functions with your own custom data types"

msgstr "Funciones de llamada con sus propios tipos de datos personalizados"

#: ../Doc/library/ctypes.rst:380

msgid ""

"You can also customize :mod:`ctypes` argument conversion to allow instances "

"of your own classes be used as function arguments. :mod:`ctypes` looks for "

"an :attr:`_as_parameter_` attribute and uses this as the function argument. "

"Of course, it must be one of integer, string, or bytes::"

msgstr ""

"También puedes personalizar la conversión de argumentos de :mod:`ctypes` "

"para permitir que las instancias de tus propias clases se usen como "

"argumentos de función. :mod:`ctypes` busca un atributo :attr:"

"`_as_parameter_` y lo usa como argumento de función. Por supuesto, debe ser "

"uno de entero, cadena o bytes::"

#: ../Doc/library/ctypes.rst:395

msgid ""

"If you don't want to store the instance's data in the :attr:`_as_parameter_` "

"instance variable, you could define a :class:`property` which makes the "

"attribute available on request."

msgstr ""

"Si no quieres almacenar los datos de la instancia en la variable de "

"instancia :attr:`_as_parameter_`, puedes definir una :class:`property` que "

"haga que el atributo esté disponible a petición."

#: ../Doc/library/ctypes.rst:403

msgid "Specifying the required argument types (function prototypes)"

msgstr ""

"Especificar los tipos de argumentos requeridos (prototipos de funciones)"

#: ../Doc/library/ctypes.rst:405

msgid ""

"It is possible to specify the required argument types of functions exported "

"from DLLs by setting the :attr:`argtypes` attribute."

msgstr ""

"Es posible especificar los tipos de argumentos necesarios de las funciones "

"exportadas desde las DLL estableciendo el atributo :attr:`argtypes`."

#: ../Doc/library/ctypes.rst:408

msgid ""

":attr:`argtypes` must be a sequence of C data types (the ``printf`` function "

"is probably not a good example here, because it takes a variable number and "

"different types of parameters depending on the format string, on the other "

"hand this is quite handy to experiment with this feature)::"

msgstr ""

":attr:`argtypes` debe ser una secuencia de tipos de datos de C (la función "

"``printf`` probablemente no es un buen ejemplo aquí, porque toma un número "

"variable y diferentes tipos de parámetros dependiendo del formato de la "

"cadena, por otro lado esto es bastante útil para experimentar con esta "

"característica)::"

#: ../Doc/library/ctypes.rst:419

msgid ""

"Specifying a format protects against incompatible argument types (just as a "

"prototype for a C function), and tries to convert the arguments to valid "

"types::"

msgstr ""

"La especificación de un formato protege contra los tipos de argumentos "

"incompatibles (al igual que un prototipo para una función C), e intenta "

"convertir los argumentos en tipos válidos::"

#: ../Doc/library/ctypes.rst:431

msgid ""

"If you have defined your own classes which you pass to function calls, you "

"have to implement a :meth:`from_param` class method for them to be able to "

"use them in the :attr:`argtypes` sequence. The :meth:`from_param` class "

"method receives the Python object passed to the function call, it should do "

"a typecheck or whatever is needed to make sure this object is acceptable, "

"and then return the object itself, its :attr:`_as_parameter_` attribute, or "

"whatever you want to pass as the C function argument in this case. Again, "

"the result should be an integer, string, bytes, a :mod:`ctypes` instance, or "

"an object with an :attr:`_as_parameter_` attribute."

msgstr ""

"Si has definido tus propias clases las cuales pasas a las llamadas a "

"funciones, tienes que implementar un método de clase :meth:`from_param` para "

"que puedan ser usadas en la secuencia :attr:`argtypes`. El método de clase :"

"meth:`from_param` recibe el objeto Python que se le pasa a la llamada a "

"función, debería hacer una comprobación de tipo o lo que sea necesario para "

"asegurarse de que este objeto es aceptable, y luego retornar el objeto en "

"sí, su atributo :attr:`_as_parameter_`, o lo que se quiera pasar como "

"argumento de la función C en este caso. De nuevo, el resultado debe ser un "

"entero, una cadena, unos bytes, una instancia :mod:`ctypes`, o un objeto con "

"el atributo :attr:`_as_parameter_`."

#: ../Doc/library/ctypes.rst:445

msgid "Return types"

msgstr "Tipos de retorno"

#: ../Doc/library/ctypes.rst:447

msgid ""

"By default functions are assumed to return the C :c:type:`int` type. Other "

"return types can be specified by setting the :attr:`restype` attribute of "

"the function object."

msgstr ""

"Por defecto, se supone que las funciones retornan el tipo C :c:type:`int`. "

"Se pueden especificar otros tipos de retorno estableciendo el atributo :attr:"

"`restype` del objeto de la función."

#: ../Doc/library/ctypes.rst:451

msgid ""

"Here is a more advanced example, it uses the ``strchr`` function, which "

"expects a string pointer and a char, and returns a pointer to a string::"

msgstr ""

"Aquí hay un ejemplo más avanzado, utiliza la función ``strchr``, que espera "

"un puntero de cadena y un carácter, y retorna un puntero a una cadena::"

#: ../Doc/library/ctypes.rst:464

msgid ""

"If you want to avoid the ``ord(\"x\")`` calls above, you can set the :attr:"

"`argtypes` attribute, and the second argument will be converted from a "

"single character Python bytes object into a C char::"

msgstr ""

"Si quieres evitar las llamadas ``ord(\"x\")`` de arriba, puedes establecer "

"el atributo :attr:`argtypes`, y el segundo argumento se convertirá de un "

"objeto de un solo carácter de bytes de Python a un char::"

#: ../Doc/library/ctypes.rst:482

msgid ""

"You can also use a callable Python object (a function or a class for "

"example) as the :attr:`restype` attribute, if the foreign function returns "

"an integer. The callable will be called with the *integer* the C function "

"returns, and the result of this call will be used as the result of your "

"function call. This is useful to check for error return values and "

"automatically raise an exception::"

msgstr ""

"También puedes usar un objeto Python invocable (una función o una clase, por "

"ejemplo) como el atributo :attr:`restype`, si la función foránea retorna un "

"número entero. El objeto invocable será llamado con el *entero* que la "

"función C retorna, y el resultado de esta llamada será utilizado como "

"resultado de la llamada a la función. Esto es útil para comprobar si hay "

"valores de retorno de error y plantear automáticamente una excepción::"

#: ../Doc/library/ctypes.rst:505

msgid ""

"``WinError`` is a function which will call Windows ``FormatMessage()`` api "

"to get the string representation of an error code, and *returns* an "

"exception. ``WinError`` takes an optional error code parameter, if no one is "

"used, it calls :func:`GetLastError` to retrieve it."

msgstr ""

"``WinError`` es una función que llamará a la api Windows ``FormatMessage`` "

"para obtener la representación de la cadena de un código de error, y "

"retornará una excepción. ``WinError`` toma un parámetro de código de error "

"opcional, si no se usa ninguno, llama a :func:`GetLastError`` para "

"recuperarlo."

#: ../Doc/library/ctypes.rst:510

msgid ""

"Please note that a much more powerful error checking mechanism is available "

"through the :attr:`errcheck` attribute; see the reference manual for details."

msgstr ""

"Tenga en cuenta que un mecanismo de comprobación de errores mucho más "

"potente está disponible a través del atributo :attr:`errcheck`; consulte el "

"manual de referencia para obtener más detalles."

#: ../Doc/library/ctypes.rst:517

msgid "Passing pointers (or: passing parameters by reference)"

msgstr "Pasar los punteros (o: pasar los parámetros por referencia)"

#: ../Doc/library/ctypes.rst:519

msgid ""

"Sometimes a C api function expects a *pointer* to a data type as parameter, "

"probably to write into the corresponding location, or if the data is too "

"large to be passed by value. This is also known as *passing parameters by "

"reference*."

msgstr ""

"A veces una función api C espera un *puntero* a un tipo de datos como "

"parámetro, probablemente para escribir en el lugar correspondiente, o si los "

"datos son demasiado grandes para ser pasados por valor. Esto también se "

"conoce cómo *pasar parámetros por referencia*."

#: ../Doc/library/ctypes.rst:523

msgid ""

":mod:`ctypes` exports the :func:`byref` function which is used to pass "

"parameters by reference. The same effect can be achieved with the :func:"

"`pointer` function, although :func:`pointer` does a lot more work since it "

"constructs a real pointer object, so it is faster to use :func:`byref` if "

"you don't need the pointer object in Python itself::"

msgstr ""

":mod:`ctypes` exporta la función :func:`byref` que se utiliza para pasar "

"parámetros por referencia. El mismo efecto se puede conseguir con la "

"función :func:`pointer`, aunque :func:`pointer` hace mucho más trabajo ya "

"que construye un objeto puntero real, por lo que es más rápido usar :func:"

"`byref` si no se necesita el objeto puntero en el propio Python::"

#: ../Doc/library/ctypes.rst:545

msgid "Structures and unions"

msgstr "Estructuras y uniones"

#: ../Doc/library/ctypes.rst:547

msgid ""

"Structures and unions must derive from the :class:`Structure` and :class:"

"`Union` base classes which are defined in the :mod:`ctypes` module. Each "

"subclass must define a :attr:`_fields_` attribute. :attr:`_fields_` must be "

"a list of *2-tuples*, containing a *field name* and a *field type*."

msgstr ""

"Las estructuras y uniones deben derivar de las clases base :class:"

"`Structure` y :class:`Union` que se definen en el módulo :mod:`ctypes`. Cada "

"subclase debe definir un atributo :attr:`_fields_`. :attr:`_fields_` debe "

"ser una lista de *2-tuplas*, que contenga un *nombre de campo* y un *tipo de "

"campo*."

#: ../Doc/library/ctypes.rst:552

msgid ""

"The field type must be a :mod:`ctypes` type like :class:`c_int`, or any "

"other derived :mod:`ctypes` type: structure, union, array, pointer."

msgstr ""

"El tipo de campo debe ser un tipo :mod:`ctypes` como :class:`c_int`, o "

"cualquier otro tipo :mod:`ctypes` derivado: estructura, unión, matriz, "

"puntero."

#: ../Doc/library/ctypes.rst:555

msgid ""

"Here is a simple example of a POINT structure, which contains two integers "

"named *x* and *y*, and also shows how to initialize a structure in the "

"constructor::"

msgstr ""

"Aquí hay un ejemplo simple de una estructura POINT, que contiene dos enteros "

"llamados *x* y *y*, y también muestra cómo inicializar una estructura en el "

"constructor::"

#: ../Doc/library/ctypes.rst:575

msgid ""

"You can, however, build much more complicated structures. A structure can "

"itself contain other structures by using a structure as a field type."

msgstr ""

"Sin embargo, se pueden construir estructuras mucho más complicadas. Una "

"estructura puede contener por sí misma otras estructuras usando una "

"estructura como tipo de campo."

#: ../Doc/library/ctypes.rst:578

msgid ""

"Here is a RECT structure which contains two POINTs named *upperleft* and "

"*lowerright*::"

msgstr ""

"Aquí hay una estructura RECT que contiene dos POINTs llamados *upperleft* "

"(superior izquierda)y *lowerright* (abajo a la derecha)::"

#: ../Doc/library/ctypes.rst:592

msgid ""

"Nested structures can also be initialized in the constructor in several "

"ways::"

msgstr ""

"Las estructuras anidadas también pueden ser inicializadas en el constructor "

"de varias maneras::"

#: ../Doc/library/ctypes.rst:597

msgid ""

"Field :term:`descriptor`\\s can be retrieved from the *class*, they are "

"useful for debugging because they can provide useful information::"

msgstr ""

"El campo :term:`descriptor` puede ser recuperado de la *class*, son útiles "

"para la depuración porque pueden proporcionar información útil::"

#: ../Doc/library/ctypes.rst:611

msgid ""

":mod:`ctypes` does not support passing unions or structures with bit-fields "

"to functions by value. While this may work on 32-bit x86, it's not "

"guaranteed by the library to work in the general case. Unions and "

"structures with bit-fields should always be passed to functions by pointer."

msgstr ""

":mod:`ctypes` no soporta el paso de uniones o estructuras con campos de bits "

"a funciones por valor. Aunque esto puede funcionar en 32-bit x86, la "

"biblioteca no garantiza que funcione en el caso general. Las uniones y "

"estructuras con campos de bits siempre deben pasarse a las funciones por "

"puntero."

#: ../Doc/library/ctypes.rst:617

msgid "Structure/union alignment and byte order"

msgstr "Alineación de estructura/unión y orden de bytes"

#: ../Doc/library/ctypes.rst:619

msgid ""

"By default, Structure and Union fields are aligned in the same way the C "

"compiler does it. It is possible to override this behavior by specifying a :"

"attr:`_pack_` class attribute in the subclass definition. This must be set "

"to a positive integer and specifies the maximum alignment for the fields. "

"This is what ``#pragma pack(n)`` also does in MSVC."

msgstr ""

"Por defecto, los campos de Estructura y Unión están alineados de la misma "

"manera que lo hace el compilador C. Es posible anular este comportamiento "

"especificando un atributo de clase :attr:`_pack_` en la definición de la "

"subclase. Este debe ser establecido como un entero positivo y especifica la "

"alineación máxima de los campos. Esto es lo que ``#pragma pack(n)`` también "

"hace en MSVC."

#: ../Doc/library/ctypes.rst:625

msgid ""

":mod:`ctypes` uses the native byte order for Structures and Unions. To "

"build structures with non-native byte order, you can use one of the :class:"

"`BigEndianStructure`, :class:`LittleEndianStructure`, :class:"

"`BigEndianUnion`, and :class:`LittleEndianUnion` base classes. These "

"classes cannot contain pointer fields."

msgstr ""

":mod:`ctypes` utiliza el orden de bytes nativos para las Estructuras y "

"Uniones. Para construir estructuras con un orden de bytes no nativo, puedes "

"usar una de las clases base :class:`BigEndianStructure`, :class:"

"`LittleEndianStructure`, :class:`BigEndianUnion`, y :class:"

"`LittleEndianUnion`. Estas clases no pueden contener campos puntero."

#: ../Doc/library/ctypes.rst:635

msgid "Bit fields in structures and unions"

msgstr "Campos de bits en estructuras y uniones"

#: ../Doc/library/ctypes.rst:637

msgid ""

"It is possible to create structures and unions containing bit fields. Bit "

"fields are only possible for integer fields, the bit width is specified as "

"the third item in the :attr:`_fields_` tuples::"

msgstr ""

"Es posible crear estructuras y uniones que contengan campos de bits. Los "

"campos de bits sólo son posibles para campos enteros, el ancho de bit se "

"especifica como el tercer ítem en las tuplas :attr:`_fields_`::"

#: ../Doc/library/ctypes.rst:655

msgid "Arrays"

msgstr "Arreglos"

#: ../Doc/library/ctypes.rst:657

msgid ""

"Arrays are sequences, containing a fixed number of instances of the same "

"type."

msgstr ""

"Los arreglos son secuencias, que contienen un número fijo de instancias del "

"mismo tipo."

#: ../Doc/library/ctypes.rst:659

msgid ""

"The recommended way to create array types is by multiplying a data type with "

"a positive integer::"

msgstr ""

"La forma recomendada de crear tipos de arreglos es multiplicando un tipo de "

"dato por un entero positivo::"

#: ../Doc/library/ctypes.rst:664

msgid ""

"Here is an example of a somewhat artificial data type, a structure "

"containing 4 POINTs among other stuff::"

msgstr ""

"Aquí hay un ejemplo de un tipo de datos algo artificial, una estructura que "

"contiene 4 POINTs entre otras cosas::"

#: ../Doc/library/ctypes.rst:680

msgid "Instances are created in the usual way, by calling the class::"

msgstr "Las instancias se crean de la manera habitual, llamando a la clase::"

#: ../Doc/library/ctypes.rst:686

msgid ""

"The above code print a series of ``0 0`` lines, because the array contents "

"is initialized to zeros."

msgstr ""

"El código anterior imprime una serie de líneas ``0 0``, porque el contenido "

"del arreglos se inicializa con ceros."

#: ../Doc/library/ctypes.rst:689

msgid "Initializers of the correct type can also be specified::"

msgstr "También se pueden especificar inicializadores del tipo correcto::"

#: ../Doc/library/ctypes.rst:705

msgid "Pointers"

msgstr "Punteros"

#: ../Doc/library/ctypes.rst:707

msgid ""

"Pointer instances are created by calling the :func:`pointer` function on a :"

"mod:`ctypes` type::"

msgstr ""

"Las instancias de puntero se crean llamando a la función :func:`pointer` en "

"un tipo :mod:`ctypes`::"

#: ../Doc/library/ctypes.rst:715

msgid ""

"Pointer instances have a :attr:`~_Pointer.contents` attribute which returns "

"the object to which the pointer points, the ``i`` object above::"

msgstr ""

"Las instancias del puntero tienen un atributo :attr:`~_Pointer.contents` que "

"retorna el objeto al que apunta el puntero, el objeto ``i`` arriba::"

#: ../Doc/library/ctypes.rst:722

msgid ""

"Note that :mod:`ctypes` does not have OOR (original object return), it "

"constructs a new, equivalent object each time you retrieve an attribute::"

msgstr ""

"Ten en cuenta que :mod:`ctypes` no tiene OOR (original object return), "

"construye un nuevo objeto equivalente cada vez que recuperas un atributo::"

#: ../Doc/library/ctypes.rst:731

msgid ""

"Assigning another :class:`c_int` instance to the pointer's contents "

"attribute would cause the pointer to point to the memory location where this "

"is stored::"

msgstr ""

"Asignar otra instancia :class:`c_int` al atributo de contenido del puntero "

"causaría que el puntero apunte al lugar de memoria donde se almacena::"

#: ../Doc/library/ctypes.rst:743

msgid "Pointer instances can also be indexed with integers::"

msgstr ""