diff options
author | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-05 23:03:38 +0200 |
---|---|---|
committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-05 23:03:47 +0200 |
commit | 70ac1c4785fc1e158ab2349a962dba2526bf4fbc (patch) | |
tree | bff270e2496dd284bccfc1271b43946f5d225224 /man3const | |
parent | 5423a6f86b2b920a5f3e8cf8d759b513050f2d33 (diff) |
src.mk, All pages: Move man* to man/
The root of the repository is becoming a bit overpopulated and
unorganized, due to the recent addition of more mandirs, and more
informative and configuration files too. Let's create a specific
mandir <man/> that contains the mandirs <man[1-8]*>.
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Diffstat (limited to 'man3const')
-rw-r--r-- | man3const/NULL.3const | 74 |
1 files changed, 0 insertions, 74 deletions
diff --git a/man3const/NULL.3const b/man3const/NULL.3const deleted file mode 100644 index 68bc7839d..000000000 --- a/man3const/NULL.3const +++ /dev/null @@ -1,74 +0,0 @@ -.\" Copyright (c) 2022 by Alejandro Colomar <colomar.6.4.3@gmail.com> -.\" -.\" SPDX-License-Identifier: Linux-man-pages-copyleft -.\" -.\" -.TH NULL 3const 2022-07-22 "Linux man-pages (unreleased)" -.SH NAME -NULL \- null pointer constant -.SH LIBRARY -Standard C library -.RI ( libc ) -.SH SYNOPSIS -.nf -.B #include <stddef.h> -.PP -.B "#define NULL ((void *) 0)" -.fi -.SH DESCRIPTION -.B NULL -represents a null pointer constant, -that is, a pointer that does not point to anything. -.SH CONFORMING TO -C99 and later; -POSIX.1-2001 and later. -.SH NOTES -The following headers also provide -.BR NULL : -.IR <locale.h> , -.IR <stdio.h> , -.IR <stdlib.h> , -.IR <string.h> , -.IR <time.h> , -.IR <unistd.h> , -and -.IR <wchar.h> . -.SH CAVEATS -It is undefined behavior to dereference a null pointer, -and that usually causes a segmentation fault in practice. -.PP -It is also undefined behavior to perform pointer arithmetic on it. -.PP -.I NULL \- NULL -is undefined behavior, according to ISO C, but is defined to be 0 in C++. -.PP -To avoid confusing human readers of the code, -do not compare pointer variables to -.BR 0 , -and do not assign -.B 0 -to them. -Instead, always use -.BR NULL . -.PP -.B NULL -shouldn't be confused with -.BR NUL , -which is an -.BR ascii (7) -character, -represented in C as -.BR \(aq\e0\(aq . -.SH BUGS -When it is necessary to set a pointer variable to a null pointer, -it is not enough to use -.BR memset (3) -to zero the pointer -(this is usually done when zeroing a struct that contains pointers), -since ISO C and POSIX don't guarantee that a bit pattern of all 0s -represent a null pointer. -See the EXAMPLES section in -.BR getaddrinfo (3) -for an example program that does this correctly. -.SH SEE ALSO -.BR void (3type) |