User's Guide to the GNU C++ Class Library - Headers

Header files for interfacing C++ to C

The following files are provided so that C++ programmers may invoke common C library and system calls. The names and contents of these files are subject to change in order to be compatible with the forthcoming GNU C library. Other files, not listed here, are simply C++-compatible interfaces to corresponding C library files.

`values.h'

A collection of constants defining the numbers of bits in builtin types, minimum and maximum values, and the like. Most names are the same as those found in `values.h' found on Sun systems.

`std.h'

A collection of common system calls and `libc.a' functions. Only those functions that can be declared without introducing new type definitions (socket structures, for example) are provided. Common char* functions (like strcmp ) are among the declarations. All functions are declared along with their library names, so that they may be safely overloaded.

`string.h'

This file merely includes `<std.h>', where string function prototypes are declared. This is a workaround for the fact that system `string.h' and `strings.h' files often differ in contents.

`osfcn.h'

This file merely includes `<std.h>', where system function prototypes are declared.

`libc.h'

This file merely includes `<std.h>', where C library function prototypes are declared.

`math.h'

A collection of prototypes for functions usually found in libm.a, plus some #define d constants that appear to be consistent with those provided in the AT&T version. The value of HUGE should be checked before using. Declarations of all common math functions are preceded with overload declarations, since these are commonly overloaded.

`stdio.h'

Declaration of FILE (_iobuf ), common macros (like getc ), and function prototypes for `libc.a' functions that operate on FILE* 's. The value BUFSIZ and the declaration of _iobuf should be checked before using.

`assert.h'

C++ versions of assert macros.

`generic.h'

String concatenation macros useful in creating generic classes. They are similar in function to the AT&T CC versions.

`new.h'

Declarations of the default global operator new, the two-argument placement version, and associated error handlers.