fputs, fputws

Artículo
04/10/2013

Escriba una cadena en una secuencia.

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 de FILE.

Valor devuelto

Cada una de estas funciones devuelve un valor no negativo si es correcto.En un error, fputs vuelve EOF, y fputws vuelve WEOF.Si str o stream es un puntero NULL, estas funciones se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, este errno establecido funciones a EINVAL y EOF return o WEOF.

Vea _doserrno, errno, _sys_errlist, y _sys_nerr para obtener más información al respecto, y otro, códigos de error.

Comentarios

Cada una de estas funciones copias str a la salida stream en la posición actual.fputws copia el argumento str de caracteres anchos a stream como una cadena de multibyte- carácter o cadena de caracteres como si stream está abierta en modo de texto o modo binario, respectivamente.Cualquier funcionan copian el carácter null de terminación.

Las dos funciones se comportan exactamente igual si la secuencia se abre en el modo de ANSI.fputs no admite actualmente la salida en una secuencia de UNICODE.

Asignaciones de la rutina de Genérico- texto

Rutina de 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.Los identificadores estándar de la secuencia asociados a la consola, stdin, stdout, y stderr, deben redirigir antes de que las funciones en tiempo de ejecución de C pueden utilizarlos en las aplicaciones de Tienda Windows.Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

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 );
}