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

Chapter 10: 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.

<`,CODE,'>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.

<`,CODE,'>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.

<`,CODE,'>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.

<`,CODE,'>osfcn.h

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

<`,CODE,'>libc.h

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

<`,CODE,'>math.h

A collection of prototypes for functions usually found in libm.a, plus some #defined 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.

<`,CODE,'>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.

<`,CODE,'>assert.h

C++ versions of assert macros.

<`,CODE,'>generic.h

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

<`,CODE,'>new.h

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