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.

Consulte también

E/S de secuencia
fgets, fgetws
gets, _getws
puts, _putws