# `msvcrt` — Useful routines from the MS VC++ runtime

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.

  Raises an auditing event `msvcrt.locking` with arguments `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.

  Raises an auditing event `msvcrt.open_osfhandle` with arguments `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.

  Raises an auditing event `msvcrt.get_osfhandle` with argument `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 ``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()

  Force the `malloc()` heap to clean itself up and return unused blocks to the operating system. On failure, this raises `OSError`.

msvcrt.CRT_ASSEMBLY_VERSION

  The CRT Assembly version, from the `crtassem.h` header file.

msvcrt.VC_ASSEMBLY_PUBLICKEYTOKEN

  The VC Assembly public key token, from the `crtassem.h` header file.

msvcrt.LIBRARIES_ASSEMBLY_NAME_PREFIX

  The Libraries Assembly name prefix, from the `crtassem.h` header file.