puts
, _putws
に文字列を書き込みます stdout
。
構文
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
パラメーター
str
出力する文字列。
戻り値
正常に終了した場合は、0 以上の値を返します。 失敗した場合puts
は;を返しEOF
、失敗した場合_putws
は .WEOF
null ポインターの場合str
、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行を続行できる場合、関数は次の値に設定errno
され、戻りEOF
値または WEOF
.EINVAL
これらのエラー コードおよびその他のエラー コードの詳細については、「errno
、_doserrno
、_sys_errlist
、_sys_nerr
」を参照してください。
解説
この関数はputs
標準出力ストリームstdout
に書き込str
み、文字列の終端の null 文字 ('\0') を出力ストリームの改行文字 ('\n') に置き換えます。
_putws
は puts
のワイド文字バージョンであり、ストリームが ANSI モードで開いている場合、この 2 つの関数の動作は同じです。 puts
では、UNICODE ストリームへの出力はサポートされていません。
_putwch
は、現在の CONSOLE LOCALE 設定を使用して Unicode 文字を書き込みます。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
---|---|---|---|
_putts |
puts |
puts |
_putws |
必要条件
ルーチンによって返される値 | 必須ヘッダー |
---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
ユニバーサル Windows プラットフォーム (UWP) アプリではコンソールがサポートされていません。 コンソール (stdin
、stdout
、stderr
) に関連付けられている標準ストリームのハンドルは、C ランタイム関数によって UWP アプリで使用される前に、リダイレクトする必要があります。 互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
例
// crt_puts.c
// This program uses puts to write a string to stdout.
#include <stdio.h>
int main( void )
{
puts( "Hello world from puts!" );
}
出力
Hello world from puts!
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示