fputs, fputws
Escribe una cadena en un flujo.
Sintaxis
int fputs(
const char *str,
FILE *stream
);
int fputws(
const wchar_t *str,
FILE *stream
);
Parámetros
str
Cadena de salida
stream
Puntero a la estructura FILE .
Valor devuelto
Cada una de estas funciones devuelve un valor no negativo si se realiza correctamente. Si se produce un error, fputs y fputws devuelven EOF. Si str o stream es un puntero nulo, estas funciones invocan al controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones establecen errno en EINVALy devuelven EOF.
Para obtener más información sobre los códigos de error, vea errno, _doserrno, _sys_errlisty _sys_nerr.
Comentarios
Cada una de estas funciones copia str en la stream de salida en la posición actual. fputws copia el argumento str de caracteres anchos en stream como una cadena de caracteres multibyte o una cadena de caracteres anchos cuando stream se abre en modo de texto o en modo binario, respectivamente. Ninguna de las funciones copia el carácter de terminación NULL.
Las dos funciones se comportan igual si el flujo se abre en modo ANSI. fputs no admite actualmente la salida en un flujo UNICODE.
De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiarlo, consulte Estado global en CRT.
Asignaciones de rutinas de texto genérico
| Rutina TCHAR.H | _UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_fputts |
fputs |
fputs |
fputws |
Requisitos
| Función | Encabezado necesario |
|---|---|
fputs |
<stdio.h> |
fputws |
<stdio.h> o <wchar.h> |
La consola no se admite en las aplicaciones de la Plataforma universal de Windows (UWP). Los identificadores de flujo estándar asociados a la consola (stdin, stdout y stderr) se deben redirigir antes de que las funciones en tiempo de ejecución de C puedan usarlos en aplicaciones para UWP. Para obtener más información sobre compatibilidad, consulte Compatibilidad.
Ejemplo
// crt_fputs.c
// This program uses fputs to write
// a single line to the stdout stream.
#include <stdio.h>
int main( void )
{
fputs( "Hello world from fputs.\n", stdout );
}
Hello world from fputs.