mirror of
https://sourceware.org/git/glibc.git
synced 2024-11-22 13:00:06 +00:00
f65fd747b4
Sun Dec 8 06:56:49 1996 Ulrich Drepper <drepper@cygnus.com> * io/getwd.c: Use PATH_MAX not LOCAL_PATH_MAX. Fix typo in comment. * stdlib/canonicalize.c: Correct bugs in last change. Patch by HJ Lu. * libio/Makefile (routines): Remove ioprims. (aux): Remove cleanup. Add IO_DEBUG option for .o files. * libio/cleanups.c: Removed. * libio/ioprims.c: Removed. * libio/filedoalloc.c: More updates from libg++-2.8b5. * libio/fileops.c: Likewise. * libio/genops.c: Likewise. * libio/iolibio.h: Likewise. * libio/iopopen.c: Likewise. * libio/iovsprintf.c: Likewise. * libio/iovsscanf.c: Likewise. * libio/libio.h: Likewise. * libio/libioP.h: Likewise. * libio/memstream.c: Likewise. * libio/strfile.h: Likewise. * libio/vasprintf.c: Likewise. * libio/vsnprintf.c: Likewise. * libio/stdio.h: Define P_tmpdir only is __USE_SVID. * manual/arith.texi: Change references to ANSI C to ISO C. * manual/conf.texi: Likewise. * manual/creature.texi: Likewise. * manual/ctype.texi: Likewise. * manual/errno.texi: Likewise. * manual/filesys.texi: Likewise. * manual/intro.texi. Likewise. * manual/io.texi: Likewise. * manual/lang.texi: Likewise. * manual/libc.texinfo: Likewise. * manual/locale.texi: Likewise. * manual/maint.texi: Likewise. * manual/mbyte.texi: Likewise. * manual/memory.texi: Likewise. * manual/process.texi: Likewise. * manual/process.texi: Likewise. * manual/search.texi: Likewise. * manual/setjmp.texi: Likewise. * manual/signal.texi: Likewise. * manual/startup.texi: Likewise. * manual/stdio.texi: Likewise. * manual/string.texi: Likewise. * manual/time.texi: Likewise. * manual/locale.texi: Remove description of LC_RESPONSE and add LC_MESSAGES. * Makefile (subdirs): Change malloc in $(malloc). * config.make.in: Add variable malloc which is initialized from @malloc@. * configure.in: Add new option --enable-new-malloc to use new malloc. This is the default on Linux. * sysdeps/unix/sysv/linux/configure.in: Define malloc to new-malloc by default. * new-malloc/Makefile: New file. Improved malloc implementation. * new-malloc/malloc.c: Likewise. * new-malloc/malloc.h: Likewise. * new-malloc/mallocbug.c: Likewise. * new-malloc/obstack.c: Likewise. * new-malloc/obstack.h: Likewise. * new-malloc/thread-m.h: Likewise. * time/Makefile: Compile ap.c with NO_MCHECK flag for now. * time/ap.c: Don't call mcheck if NO_MCHECK is defined. * resolv/Makefile: Add rule to rebuiild libresolv.so when libc.so changed. * stdio/feof.c: Update copyright. * stdio/stdio.h: Add field for lock to FILE structure. Add cast to *MAGIC constants to prevent warnings. * stdio-common/bug7.c: Correct test. Stream must not be closed twice. * stdlib/Makefile (routines): Add secure-getenv. * stdlib/secure-getenv.c: New file. __secure_getenv function moved to here from sysdeps/generic/getenv.c. Otherwise an application cannot replace the getenv function in the libc. * sysdeps/generic/getenv.c: Remove __secure_getenv function. * sysdeps/stub/getenv.c: Remove __secure_getenv alias. * sysdeps/mach/libc-lock.h: Define__libc_mutex_lock to __mutex_lock. * sysdeps/posix/fdopen.c: Update copyright. Don't use EXFUN. * time/test-tz.c: Comment fifth test out. PROBLEM. * time/tzset.c: De-ANSI-declfy. (__tzset): Don't increment pointer tz when no DST information is given. Sat Dec 7 23:47:54 1996 Ulrich Drepper <drepper@cygnus.com> * sysdeps/mach/libc-lock.h [_LIBC]: Add definition of __libc_mutex_lock. Patch by Thomas Bushnell. * sysdeps/unix/sysv/linux/timebits.h: Load <asm/param.h> only if __USE_MISC. * sysdeps/unix/sysv/linux/Dist: Add llseek.c. Sat Dec 7 12:18:56 1996 Ulrich Drepper <drepper@cygnus.com> * time/strftime (%c format): Remove %Z from default string. Reported by Paul Eggert * io/getwd.c: Don't apply getcwd on user supplied buffer.
82 lines
3.6 KiB
Plaintext
82 lines
3.6 KiB
Plaintext
@node Common Definitions, Memory Allocation, Error Reporting, Top
|
|
@chapter Common Definitions
|
|
|
|
There are some miscellaneous data types and macros that are not part of
|
|
the C language kernel but are nonetheless almost universally used, such
|
|
as the macro @code{NULL}. In order to use these type and macro
|
|
definitions, your program should include the header file
|
|
@file{stddef.h}.
|
|
@pindex stddef.h
|
|
|
|
@comment stddef.h
|
|
@comment ISO
|
|
@deftp {Data Type} ptrdiff_t
|
|
This is the signed integer type of the result of subtracting two
|
|
pointers. For example, with the declaration @code{char *p1, *p2;}, the
|
|
expression @code{p2 - p1} is of type @code{ptrdiff_t}. This will
|
|
probably be one of the standard signed integer types (@code{short int},
|
|
@code{int} or @code{long int}), but might be a nonstandard type that
|
|
exists only for this purpose.
|
|
@end deftp
|
|
|
|
@comment stddef.h
|
|
@comment ISO
|
|
@deftp {Data Type} size_t
|
|
This is an unsigned integer type used to represent the sizes of objects.
|
|
The result of the @code{sizeof} operator is of this type, and functions
|
|
such as @code{malloc} (@pxref{Unconstrained Allocation}) and
|
|
@code{memcpy} (@pxref{Copying and Concatenation}) that manipulate
|
|
objects of arbitrary sizes accept arguments of this type to specify
|
|
object sizes.
|
|
@end deftp
|
|
|
|
In the GNU system @code{size_t} is equivalent to one of the types
|
|
@code{unsigned int} and @code{unsigned long int}. These types have
|
|
identical properties on the GNU system, and for most purposes, you
|
|
can use them interchangeably. However, they are distinct types,
|
|
and in certain contexts, you may not treat them as identical. For
|
|
example, when you specify the type of a function argument in a
|
|
function prototype, it makes a difference which one you use. If
|
|
the system header files declare @code{malloc} with an argument
|
|
of type @code{size_t} and you declare @code{malloc} with an argument
|
|
of type @code{unsigned int}, you will get a compilation error if
|
|
@code{size_t} happens to be @code{unsigned long int} on your system.
|
|
To avoid any possibility of error, when a function argument is
|
|
supposed to have type @code{size_t}, always write the type as
|
|
@code{size_t}, and make no assumptions about what that type might
|
|
actually be.
|
|
|
|
@strong{Compatibility Note:} Types such as @code{size_t} are new
|
|
features of @w{ISO C}. Older, pre-ANSI C implementations have
|
|
traditionally used @code{unsigned int} for representing object sizes
|
|
and @code{int} for pointer subtraction results.
|
|
|
|
@comment stddef.h
|
|
@comment ISO
|
|
@deftypevr Macro {void *} NULL
|
|
@cindex null pointer
|
|
This is a null pointer constant. It can be assigned to any pointer
|
|
variable since it has type @code{void *}, and is guaranteed not to
|
|
point to any real object. This macro is the best way to get a null
|
|
pointer value. You can also use @code{0} or @code{(void *)0} as a null
|
|
pointer constant, but using @code{NULL} makes the purpose of the
|
|
constant more evident.
|
|
|
|
When passing a null pointer as an argument to a function for which there
|
|
is no prototype declaration in scope, you should explicitly cast
|
|
@code{NULL} or @code{0} into a pointer of the appropriate type. Again,
|
|
this is because the default argument promotions may not do the right
|
|
thing.
|
|
@end deftypevr
|
|
|
|
@comment stddef.h
|
|
@comment ISO
|
|
@deftypefn {Macro} size_t offsetof (@var{type}, @var{member})
|
|
This expands to a integer constant expression that is the offset of the
|
|
structure member named @var{member} in a @code{struct} of type
|
|
@var{type}. For example, @code{offsetof (struct s, elem)} is the
|
|
offset, in bytes, of the member @code{elem} in a @code{struct s}. This
|
|
macro won't work if @var{member} is a bit field; you get an error from
|
|
the C compiler in that case.
|
|
@end deftypefn
|