fputs, fputwsfputs, fputws

Escribe una cadena en un flujo.Writes a string to a stream.

SintaxisSyntax

int fputs(
   const char *str,
   FILE *stream
);
int fputws(
   const wchar_t *str,
   FILE *stream
);

ParámetrosParameters

strstr
Cadena de salidaOutput string.

misionesstream
Puntero a la estructura FILE.Pointer to FILE structure.

Valor devueltoReturn Value

Cada una de estas funciones devuelve un valor no negativo si se ejecuta correctamente.Each of these functions returns a nonnegative value if it is successful. En un error, fputs y fputws devuelven EOF.On an error, fputs and fputws return EOF. Si Str o Stream es un puntero nulo, estas funciones invocan el controlador de parámetros no válidos, tal y como se describe en validación de parámetros.If str or stream is a null pointer, these functions invoke the invalid parameter handler, as described in Parameter Validation. Si la ejecución puede continuar, estas funciones establecen errno en EINVAL y, a continuación, fputs devuelve EOF y fputws devuelve WEOF.If execution is allowed to continue, these functions set errno to EINVAL and then fputs returns EOF, and fputws returns WEOF.

Consulte _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros códigos de error.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

ObservacionesRemarks

Cada una de estas funciones copia Str en el flujo de salida en la posición actual.Each of these functions copies str to the output stream at the current position. fputws copia el argumento de caracteres anchos Str en Stream como una cadena de caracteres multibyte o una cadena de caracteres anchos según si la secuencia se abre en modo de texto o en modo binario, respectivamente.fputws copies the wide-character argument str to stream as a multibyte-character string or a wide-character string according to whether stream is opened in text mode or binary mode, respectively. Ninguna de las funciones copia el carácter de terminación NULL.Neither function copies the terminating null character.

Las dos funciones se comportan igual si el flujo se abre en modo ANSI.The two functions behave identically if the stream is opened in ANSI mode. fputs no admite actualmente la salida en un flujo Unicode.fputs does not currently support output into a UNICODE stream.

De forma predeterminada, el ámbito de este estado global de esta función es la aplicación.By default, this function's global state is scoped to the application. Para cambiar esto, vea estado global en CRT.To change this, see Global state in the CRT.

Asignaciones de rutina de texto genéricoGeneric-Text Routine Mappings

Rutina TCHAR.HTCHAR.H routine _UNICODE y _MBCS no definidos_UNICODE & _MBCS not defined _MBCS definido_MBCS defined _UNICODE definido_UNICODE defined
_fputts_fputts fputsfputs fputsfputs fputwsfputws

RequisitosRequirements

FunciónFunction Encabezado necesarioRequired header
fputsfputs <stdio.h>
fputwsfputws <stdio.h> o <wchar.h><stdio.h> or <wchar.h>

La consola no se admite en aplicaciones de Plataforma universal de Windows (UWP).The console is not supported in Universal Windows Platform (UWP) apps. Se deben redirigir los identificadores de flujo estándar 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 para UWP.The standard stream handles that are associated with the console—stdin, stdout, and stderr—must be redirected before C run-time functions can use them in UWP apps. Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

EjemploExample

// 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énSee also

E/S de secuenciaStream I/O
fgets, fgetwsfgets, fgetws
gets, _getwsgets, _getws
puts, _putwsputs, _putws