GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FCLOSE (3)

NAME

fclose, fdclose, fcloseall - close a stream

CONTENTS

Library
Synopsis
Description
Return Values
Errors
Notes
See Also
Standards
History

LIBRARY


.Lb libc

SYNOPSIS


.In stdio.h int fclose FILE *stream int fdclose FILE *stream int *fdp void fcloseall void

DESCRIPTION

The fclose function dissociates the named stream from its underlying file or set of functions. If the stream was being used for output, any buffered data is written first, using fflush(3).

The fdclose function is equivalent to fclose except that it does not close the underlying file descriptor. If fdp is not NULL, the file descriptor will be written to it. If the fdp argument will be different then NULL the file descriptor will be returned in it, If the stream does not have an associated file descriptor, fdp will be set to -1. This type of stream is created with functions such as fmemopen(3), funopen(3), or open_memstream(3).

The fcloseall function calls fclose on all open streams.

RETURN VALUES

fcloseall does not return a value.

Upon successful completion the fclose and fdclose functions return 0. Otherwise, EOF is returned and the global variable errno is set to indicate the error.

ERRORS

fdclose fails if:
[EOPNOTSUPP]
  The stream does not have an associated file descriptor.

The fclose and fdclose functions may also fail and set errno for any of the errors specified for fflush(3).

The fclose function may also fail and set errno for any of the errors specified for close(2).

NOTES

The fclose and fdclose functions do not handle NULL arguments in the stream variable; this will result in a segmentation violation. This is intentional. It makes it easier to make sure programs written under
.Fx are bug free. This behaviour is an implementation detail, and programs should not rely upon it.

SEE ALSO

close(2), fflush(3), fopen(3), setbuf(3)

STANDARDS

The fclose function conforms to -isoC.

HISTORY

The fcloseall function first appeared in
.Fx 7.0 .

The fdclose function first appeared in
.Fx 11.0 .

Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.