_close_close

ファイルを閉じます。Closes a file.

構文Syntax

int _close(
   int fd
);

パラメーターParameters

fdfd
開いているファイルを参照するファイル記述子。File descriptor referring to the open file.

戻り値Return Value

ファイルが正常に閉じられた場合、 _closeは0を返します。_close returns 0 if the file was successfully closed. 戻り値-1 はエラーを示します。A return value of -1 indicates an error.

RemarksRemarks

_Close関数は、 fdに関連付けられているファイルを閉じます。The _close function closes the file associated with fd.

ファイル記述子と基になる OS ファイル ハンドルは閉じられます。The file descriptor and the underlying OS file handle are closed. したがって、ファイルが最初に Win32 関数CreateFileを使用して開かれ、 _open_osfhandleを使用してファイル記述子に変換された場合、 CloseHandleを呼び出す必要はありません。Thus, it is not necessary to call CloseHandle if the file was originally opened using the Win32 function CreateFile and converted to a file descriptor using _open_osfhandle.

この関数は、パラメーターを検証します。This function validates its parameters. Fdが無効なファイル記述子である場合は、「パラメーターの検証」で説明されているように、無効なパラメーターハンドラーが呼び出されます。If fd is a bad file descriptor, the invalid parameter handler is invoked, as described in Parameter Validation. 実行の継続が許可された場合、これらの関数は-1 を返し、 errnoEBADFに設定されます。If execution is allowed to continue, the functions returns -1 and errno is set to EBADF.

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header オプション ヘッダーOptional header
_close_close <io.h><io.h> <errno.h><errno.h>

互換性の詳細については、「 互換性」を参照してください。For more compatibility information, see Compatibility.

Example

_open の例を参照してください。See the example for _open.

関連項目See also

下位入出力Low-Level I/O
_chsize_chsize
_creat、_wcreat_creat, _wcreat
_dup、_dup2_dup, _dup2
_open、_wopen_open, _wopen
_unlink、_wunlink_unlink, _wunlink