kc3-lang/gnulib/doc/posix-headers/stdbool.texi

• Show log

  Commit

• Hash : 2f858e5e
  Author :
  Date : 2022-09-10T11:41:32
  

  Rely on new stdbool behavior
  
  Prefer the C23 style to the C99 style,
  since the stdbool module now supports C23.
  * lib/acl-internal.h, lib/acl.h, lib/argmatch.c, lib/argmatch.h:
  * lib/argp-help.c, lib/argv-iter.h, lib/asyncsafe-spin.c:
  * lib/backup-internal.h, lib/backupfile.c, lib/base32.h:
  * lib/base64.h, lib/basename-lgpl.c, lib/bitset/base.h:
  * lib/c-ctype.h, lib/c-strcasestr.c, lib/canonicalize-lgpl.c:
  * lib/canonicalize.c, lib/chdir-long.c, lib/chown.c:
  * lib/classpath.h, lib/clean-temp-private.h:
  * lib/clean-temp-simple.c, lib/clean-temp-simple.h:
  * lib/clean-temp.c, lib/clean-temp.h, lib/cloexec.h:
  * lib/close-stream.c, lib/closein.c, lib/closeout.c, lib/closeout.h:
  * lib/csharpcomp.h, lib/csharpexec.h, lib/cycle-check.c:
  * lib/cycle-check.h, lib/des.h, lib/dfa.h, lib/diffseq.h:
  * lib/dirname.h, lib/exclude.c, lib/exclude.h, lib/execute.c:
  * lib/execute.h, lib/execvpe.c, lib/fatal-signal.c, lib/fchdir.c:
  * lib/file-set.h, lib/filevercmp.c, lib/findprog-in.c:
  * lib/findprog.c, lib/findprog.h, lib/fma.c, lib/fnmatch.c:
  * lib/fopen.c, lib/freadable.h, lib/freading.h, lib/freopen-safer.c:
  * lib/fstrcmp.c, lib/fsusage.h, lib/fts.c, lib/fwritable.h:
  * lib/fwriteerror.c, lib/fwriting.h, lib/gen-uni-tables.c:
  * lib/getaddrinfo.c, lib/getcwd.c, lib/getloadavg.c:
  * lib/getndelim2.c, lib/getpass.c, lib/getrandom.c:
  * lib/git-merge-changelog.c, lib/gl_list.h, lib/gl_map.h:
  * lib/gl_omap.h, lib/gl_oset.h, lib/gl_set.h, lib/glob.c:
  * lib/glthread/cond.h, lib/hamt.h, lib/hard-locale.h:
  * lib/hash-triple.h, lib/hash.h, lib/human.h, lib/i-ring.h:
  * lib/isapipe.c, lib/javacomp.h, lib/javaexec.h, lib/javaversion.c:
  * lib/lchown.c, lib/localeinfo.h, lib/localename.c:
  * lib/long-options.h, lib/malloc/dynarray.h, lib/mbchar.h:
  * lib/mbfile.h, lib/mbiter.h, lib/mbmemcasecoll.h, lib/mbscasestr.c:
  * lib/mbsstr.c, lib/mbuiter.h, lib/mkdir-p.h, lib/modechange.h:
  * lib/mountlist.h, lib/nanosleep.c, lib/nonblocking.h:
  * lib/nstrftime.c, lib/openat.c, lib/openat.h, lib/os2-spawn.c:
  * lib/parse-datetime.h, lib/pipe-filter-aux.c, lib/pipe-filter-gi.c:
  * lib/pipe-filter-ii.c, lib/pipe-filter.h, lib/posixtm.h:
  * lib/priv-set.c, lib/progreloc.c, lib/propername.c:
  * lib/pthread-spin.c, lib/quotearg.c, lib/readtokens.c:
  * lib/readtokens0.h, lib/readutmp.c, lib/regex-quote.h:
  * lib/regex_internal.h, lib/relocwrapper.c, lib/rename.c:
  * lib/renameatu.c, lib/rpmatch.c, lib/same.c, lib/same.h:
  * lib/save-cwd.c, lib/savewd.c, lib/savewd.h, lib/spawn-pipe.h:
  * lib/spawni.c, lib/stack.h, lib/stat.c, lib/stdckdint.in.h:
  * lib/strcasestr.c, lib/strfmon_l.c, lib/striconveh.c:
  * lib/striconveha.h, lib/string-buffer.h, lib/strptime.c:
  * lib/strstr.c, lib/strtod.c, lib/supersede.h, lib/system-quote.c:
  * lib/tempname.c, lib/term-style-control.c:
  * lib/term-style-control.h, lib/textstyle.in.h, lib/time_rz.c:
  * lib/tmpdir.c, lib/tmpdir.h, lib/tmpfile.c, lib/unicase.in.h:
  * lib/unicase/caseprop.h, lib/unicase/invariant.h:
  * lib/unicase/u16-casemap.c, lib/unicase/u16-ct-totitle.c:
  * lib/unicase/u16-is-invariant.c, lib/unicase/u32-casemap.c:
  * lib/unicase/u32-ct-totitle.c, lib/unicase/u32-is-invariant.c:
  * lib/unicase/u8-casemap.c, lib/unicase/u8-ct-totitle.c:
  * lib/unicase/u8-is-invariant.c, lib/unictype.in.h:
  * lib/unigbrk.in.h, lib/unigbrk/u16-grapheme-breaks.c:
  * lib/unigbrk/u32-grapheme-breaks.c:
  * lib/unigbrk/u8-grapheme-breaks.c:
  * lib/unigbrk/uc-grapheme-breaks.c, lib/uniname/uniname.c:
  * lib/unistr.in.h, lib/unlinkdir.h, lib/userspec.h, lib/utime.c:
  * lib/utimecmp.c, lib/utimens.c, lib/wait-process.h:
  * lib/windows-cond.c, lib/windows-spawn.c, lib/windows-spawn.h:
  * lib/windows-timedrwlock.c, lib/write-any-file.h, lib/xbinary-io.c:
  * lib/xstrtod.h, lib/yesno.h:
  * tests/nap.h, tests/qemu.h, tests/test-areadlink-with-size.c:
  * tests/test-areadlink.c, tests/test-areadlinkat-with-size.c:
  * tests/test-areadlinkat.c, tests/test-base32.c:
  * tests/test-base64.c, tests/test-ceil2.c, tests/test-ceilf2.c:
  * tests/test-chown.c, tests/test-dirname.c, tests/test-dup-safer.c:
  * tests/test-dup3.c, tests/test-exclude.c:
  * tests/test-execute-child.c, tests/test-execute-main.c:
  * tests/test-execute-script.c, tests/test-explicit_bzero.c:
  * tests/test-fchownat.c, tests/test-fcntl-safer.c:
  * tests/test-fcntl.c, tests/test-fdutimensat.c:
  * tests/test-filenamecat.c, tests/test-floor2.c:
  * tests/test-floorf2.c, tests/test-fstatat.c, tests/test-fstrcmp.c:
  * tests/test-futimens.c, tests/test-getlogin.h, tests/test-getopt.h:
  * tests/test-hard-locale.c, tests/test-hash.c:
  * tests/test-idpriv-drop.c, tests/test-idpriv-droptemp.c:
  * tests/test-immutable.c, tests/test-intprops.c:
  * tests/test-lchown.c, tests/test-link.c, tests/test-linkat.c:
  * tests/test-lstat.c, tests/test-mbmemcasecmp.c:
  * tests/test-mbmemcasecoll.c, tests/test-mkdir.c:
  * tests/test-mkdirat.c, tests/test-mkfifo.c, tests/test-mkfifoat.c:
  * tests/test-mknod.c, tests/test-nonblocking-pipe-child.c:
  * tests/test-nonblocking-pipe-main.c:
  * tests/test-nonblocking-socket-child.c:
  * tests/test-nonblocking-socket-main.c, tests/test-open.c:
  * tests/test-openat.c, tests/test-pipe.c, tests/test-pipe2.c:
  * tests/test-poll.c, tests/test-posix_spawn-chdir.c:
  * tests/test-posix_spawn-dup2-stdin.c:
  * tests/test-posix_spawn-dup2-stdout.c:
  * tests/test-posix_spawn-fchdir.c, tests/test-posix_spawn-open1.c:
  * tests/test-posix_spawn-open2.c, tests/test-quotearg-simple.c:
  * tests/test-quotearg.c, tests/test-readlink.c:
  * tests/test-readlinkat.c, tests/test-readtokens.c:
  * tests/test-rename.c, tests/test-renameat.c:
  * tests/test-renameatu.c, tests/test-rmdir.c, tests/test-round2.c:
  * tests/test-select.h, tests/test-spawn-pipe-child.c:
  * tests/test-spawn-pipe-main.c, tests/test-spawn-pipe-script.c:
  * tests/test-stack.c, tests/test-stat.c, tests/test-supersede.c:
  * tests/test-symlink.c, tests/test-symlinkat.c:
  * tests/test-system-quote-main.c:
  * tests/test-term-style-control-hello.c:
  * tests/test-term-style-control-yes.c, tests/test-timespec.c:
  * tests/test-trunc2.c, tests/test-truncf2.c, tests/test-unlink.c:
  * tests/test-unlinkat.c, tests/test-userspec.c, tests/test-utime.c:
  * tests/test-utimens.c, tests/test-utimensat.c:
  * tests/unictype/test-categ_byname.c:
  * tests/unigbrk/test-uc-is-grapheme-break.c:
  Don’t include stdbool.h.
  * modules/acl, modules/xgetcwd:
  Don’t depend on stdbool, as these modules don’t use bool.
  * modules/argp, modules/bitset, modules/diffseq, modules/file-has-acl:
  * modules/gen-uni-tables, modules/getrandom:
  * modules/hash-triple-simple, modules/posix_spawn-internal:
  * modules/strcasestr, modules/supersede, modules/system-quote:
  * modules/uniconv/base, modules/uniname/uniname, modules/utime:
  * modules/windows-timedrwlock:
  Depend on stdbool, as these modules use bool.
  

Download

• doc/posix-headers/stdbool.texi

• @node stdbool.h
  @section @file{stdbool.h}
  
  POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/stdbool.h.html}
  
  Gnulib module: stdbool-c99
  
  The @code{stdbool-c99} module is present only for programs that
  formerly used the old @code{stdbool} module for C99 compatibility,
  and that for some reason cannot use the current @code{stdbool} module
  for C23 compatibility.
  
  Portability problems fixed by Gnulib:
  @itemize
  @item
  This header file is missing on some platforms:
  AIX 5.1, HP-UX 11, IRIX 6.5.
  @item
  This header file is not usable in C++ mode with the vendor compiler
  on Solaris 10.
  @item
  Some compilers have bugs relating to @samp{bool}.
  @item
  This header file defines @code{true} incorrectly on some platforms:
  OpenBSD 4.7 with gcc 2.95.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @item
  @samp{_Bool} cannot be used before @code{<stdbool.h>} is included, or if
  the program is intended to be compiled by a C++ compiler.
  (With the advent of C23, @samp{_Bool} is obsolescent anyway.)
  @item
  You cannot assume that @code{_Bool} is a typedef; it might be a macro.
  For example, C23 allows @code{_Bool} to be a macro.
  @item
  Bit-fields of type @samp{bool} are not supported.  Portable code
  should use @samp{unsigned int foo : 1;} rather than @samp{bool foo : 1;}.
  @item
  Casts and automatic conversions to @samp{bool} don't test against the
  zero value or the null pointer, as they should.  Such casts should only
  be used if the value is known to be equal to 0 or 1.
  @item
  You cannot assume that casting a floating point literal to @samp{bool} will
  result in a constant expression.
  @end itemize
  

Download