fputs, fputws

Artículo
06/09/2015

Escribe una cadena en un flujo.

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 ejecuta correctamente. Si se produce un error, fputs y fputws devuelven EOF. Si str o stream es un puntero nulo, estas funciones invocan el 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 EINVAL; a continuación, fputs devuelve EOF y fputws devuelve WEOF.

Vea _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros códigos de error.

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 en función de que stream se haya abierto en modo de texto o 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 a un flujo UNICODE.

Asignaciones de rutina 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 Tienda Windows. Se deben redirigir los identificadores estándar de flujo que están asociados a la consola, stdin, stdout y stderr, antes de que las funciones en tiempo de ejecución de C puedan usarlos en aplicaciones de Tienda Windows. Para obtener más información sobre compatibilidad, vea 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 );
}