"msvcrt" --- Rutinas útiles del entorno de ejecución MS VC++
************************************************************

======================================================================

Estas funciones dan acceso a ciertas capacidades útiles en plataformas
Windows. Algunos módulos de más alto nivel usan estas funciones para
crear las implementaciones en Windows de sus servicios. Por ejemplo,
el módulo "getpass" usa esto en la implementación de la función
"getpass()".

Más información sobre estas funciones se pueden encontrar en la
documentación de la API de la plataforma.

El módulo implementa las variantes tanto de caracteres normales como
amplios de la API E/S de la consola (se codifican en más de 8 bits,
pudiendo llegar hasta 32). La API normal se ocupa solamente de
caracteres ASCII y es de uso limitado a aplicaciones internacionales.
La API para caracteres amplios se recomienda usar siempre que sea
posible.

Distinto en la versión 3.3: Las operaciones en este módulo lanzan
ahora "OSError" donde antes se lanzaba "IOError".


Operaciones con archivos
========================

msvcrt.locking(fd, mode, nbytes)

   Bloquea parte de un archivo basado en el descriptor del archivo
   *fd* del entorno de ejecución C. Lanza una excepción "OSError" si
   falla. La región que ha sido bloqueada se extiende desde la
   posición del archivo actual hasta *nbytes* bytes y puede que
   continúe aún habiendo llegado al final del archivo. *mode* tiene
   que ser una de las constantes "LK_*" que están enumeradas más
   abajo. Se pueden bloquear varias regiones de un mismo archivo pero
   no se pueden superponer. Las regiones adyacentes no se combinan;
   tienen que ser desbloqueadas manualmente.

   Lanza un evento de auditoría "msvcrt.locking" con los argumentos
   "fd", "mode", "nbytes".

msvcrt.LK_LOCK
msvcrt.LK_RLCK

   Bloquea los bytes especificados. Si no se pueden bloquear, el
   programa lo intenta de nuevo tras 1 segundo. Si, tras 10 intentos,
   no puede bloquear los bytes, se lanza una excepción "OSError".

msvcrt.LK_NBLCK
msvcrt.LK_NBRLCK

   Bloquea los bytes especificados. Si no se pueden bloquear, lanza
   una excepción "OSError".

msvcrt.LK_UNLCK

   Desbloquea los bytes especificados que han sido previamente
   bloqueados.

msvcrt.setmode(fd, flags)

   Establece el modo traducción del final de línea del descriptor de
   un archivo *fd*. Si se establece como modo texto, *flags* debería
   ser "os.O_TEXT"; para establecerlo como modo binario, debería ser
   "os.O_BINARY".

msvcrt.open_osfhandle(handle, flags)

   Crea un descriptor de archivo en el entorno de ejecución de C desde
   el manejador de archivo *handle*.  El parámetro *flags* debe ser un
   OR bit a bit de "os.O_APPEND", "os.O_RDONLY", y "os.O_TEXT". El
   descriptor de archivo retornado se puede utilizar como parámetro
   para "os.fdopen()" para crear un objeto archivo.

   Lanza un evento de auditoría "msvcrt.open_osfhandle" con los
   argumentos "handle", "flags".

msvcrt.get_osfhandle(fd)

   Retorna el manejador de archivo para un descriptor de archivo *fd*.
   Lanza una excepción "OSError" si *fd* no se reconoce.

   Lanza un evento de auditoría "msvcrt.get_osfhandle" con el
   argumento "fd".


Consola E/S
===========

msvcrt.kbhit()

   Retorna "True" si hay una pulsación de tecla está esperando para
   ser leída.

msvcrt.getch()

   Lee una pulsación de la tecla  y retorna el carácter resultante
   como una cadena de caracteres de bytes. Nada se muestra en la
   consola. Esta llamada se bloqueará si una pulsación de la tecla aún
   no está disponible, pero no esperará a que se presione "Enter". Si
   la tecla pulsada era una tecla de función especial, esto retornará
   "'\000'" o "'xe0'"; la siguiente llamada retornará el código de la
   tecla pulsada. La pulsación de la tecla :kbd:'Control-C' no se
   puede leer con esta función.

msvcrt.getwch()

   Variante de carácter amplio de "getch()", retornando un valor
   Unicode.

msvcrt.getche()

   Similar a la función "getch()", pero la pulsación de la tecla se
   imprime si representa un carácter imprimible.

msvcrt.getwche()

   Variante de carácter amplio de "getche()", retornando un valor
   Unicode.

msvcrt.putch(char)

   Imprime la cadena de caracteres de bytes *char* a la consola sin
   almacenamiento en buffer.

msvcrt.putwch(unicode_char)

   Variante de carácter amplio de "putch()", admitiendo un valor
   Unicode.

msvcrt.ungetch(char)

   Provoca que la cadena de caracteres de bytes *char* sea "colocada
   de nuevo" en el buffer de la consola, será el siguiente carácter
   que lea la función "getch()" o "getche()".

msvcrt.ungetwch(unicode_char)

   Variante de carácter amplio de "ungetch()", admitiendo un valor
   Unicode.


Otras funciones
===============

msvcrt.heapmin()

   Fuerza a la pila "malloc()" a que se limpie y retorne los bloques
   sin usar al sistema operativo. En el caso de que ocurriera algún
   fallo, se lanzaría una excepción "OSError".
