blob: c7314c46710185362bed29b80fa28b34e3eaae33 (
plain) (
tree)
|
|
NAME
slibc - the Stockholm C Standard Library
DESCRIPTION
slibc is a POSIX C standard library. It aims to support
ISO C99, and newer versions of ISO C, other versions of C
are ignored except for proper feature-test macros. Ignores
all languages other than C, this means that slibc cannot be
used in C++ by merely including the header files.
In addition to POSIX, slibc aims to support common
extensions, especially those in the GNU C Library because of
its predominance on GNU systems. slibc also aims to fill the
lacunæ in the C standard library specification, and make
programming in C even easier by adding functions that would
be generally useful are impossible to implement efficiently
in other libraries.
FEATURE-TEST MACROS
slibc defines a few slibc-specified feature-test macros:
_SLIBC_SOURCE
Enable slibc extensions. These extensions are
often extensions introduced in other C libraries,
but are considered good extensions.
slibc provides some slibc-specific extensions that
do not require _SLIBC_SOURCE. (They are however
disabled if _PORTABLE_SOURCE or _LIBRARY_HEADER are
defined.) These extensions are defined in header
files whose name starts with 'slibc-'. Headers
starting with 'slibc/' are not extensions, those are
internals that may change at any time.
_SLIBC_SUPPRESS_WARNINGS
Suppress all #warning and other warnings, this is
primarily intended to be used when compiling slibc.
_PORTABLE_SOURCE
Unconditionally disable all non-POSIX extensions, and
otherwise help ensure that the source is portable.
_LIBRARY_HEADER
Alternative to _PORTABLE_SOURCE that should be used in
header files for libraries. This allows you to be sure
that your library is portable between libc:s, and that
sources using your library does not been to be compiled
with the same libc. It is important to use this instead
of _PORTABLE_SOURCE in library header files, otherwise
the user of the library cannot fully utilise
_PORTABLE_SOURCE.
COMMENTS
Writing a C standard library is a massive task. As I only have
x86_64 hardware, I will require help write the assembly code
for other hardware. I also need help writing the texinfo manual
and example code for functions, help figuring out the correct
feature-test macros for all functions, their etymology, and in
which libc implementions they appear. Help optimising all
functions would also be appreciated.
FUTURE DIRECTIONS
The macro _SMALL_BINARY shall whenever available, create
macros that make the program use implementions of the functions
that optimised for size rather than performance. It should
be compile-time selectable whether this macro has any effect,
or if it is always in effect. _FAST_BINARY could also be added
to make the program use fast implementions when the library
is compiled to use the size optimised implementations.
RATIONALE
slibc is written as a learning exercise, and for fun.
SEE ALSO
<https://en.wikipedia.org/wiki/C_standard_library>
Full documentation available locally via: info '(slibc)'
|
