puts, _putws

Schreibt eine Zeichenfolge in stdout.

Syntax

int puts(
   const char *str
);
int _putws(
   const wchar_t *str
);

Parameter

str
Ausgabezeichenfolge.

Rückgabewert

Gibt bei Erfolg einen nicht negativen Wert zurück. Wenn puts ein Fehler auftritt, wird er zurückgegeben EOF; wenn _putws ein Fehler auftritt, wird er zurückgegeben WEOF. Wenn str es sich um einen Nullzeiger handelt, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die Ausführung fortgesetzt werden darf, werden die funktionen auf errnoEINVAL und zurückgeben oder zurückgeben.WEOFEOF

Informationen zu diesen und anderen Fehlercodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno

Hinweise

Die puts Funktion schreibt str in den Standardausgabedatenstrom stdout, wobei das endende Nullzeichen ('\0') der Zeichenfolge durch ein Zeilenumbruchzeichen ('\n') im Ausgabedatenstrom ersetzt wird.

_putws ist die Breitzeichenversion von puts; die zwei Funktionen verhalten sich identisch, wenn der Stream im ANSI-Modus geöffnet ist. puts unterstützt derzeit die Ausgabe in einen UNICODE-Stream nicht.

_putwch schreibt Unicode-Zeichen mithilfe der aktuellen CONSOLE LOCALE-Einstellung.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

TCHAR.H-Routine	_UNICODE und _MBCS nicht definiert	_MBCS Definiert	_UNICODE Definiert
_putts	puts	puts	_putws

Anforderungen

Routine	Erforderlicher Header
puts	<stdio.h>
_putws	<stdio.h>

Die Konsole wird in Universelle Windows-Plattform -Apps (UWP) nicht unterstützt. Die Standardstreamhandles, die der Konsole zugeordnet sind, stdinstdoutund stderrmüssen umgeleitet werden, bevor C-Laufzeitfunktionen sie in UWP-Apps verwenden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Bibliotheken

Alle Versionen der C-Laufzeitbibliotheken.

Beispiel

// crt_puts.c
// This program uses puts to write a string to stdout.

#include <stdio.h>

int main( void )
{
   puts( "Hello world from puts!" );
}

Ausgabe

Hello world from puts!

Siehe auch

Stream-E/A
fputs, fputws
fgets, fgetws