d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

usr.bin/bc: update to version 5.3.1

Browse Source 
This version adds support for command line editing and history using
the libedit or readline libraries in addition to the line editing
features available in previous versions.

The version in the base system is configured to use libedit.

This allows to choose between emacs and vi line editing commands and
to use command overrides via a ~/.editrc file.

Merge commit 'bd54318046bfee055b140705a5cfd4148e78da07'

PR:		264010

MFC after:	2 weeks
This commit is contained in:
Stefan Eßer 2022-06-11 13:03:06 +02:00
commit 78bc019d22
93 changed files with 9113 additions and 4636 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
contrib/bc/Makefile.in
View File

@ -147,6 +147,7 @@ BC_ENABLE_EXTRA_MATH_NAME = BC_ENABLE_EXTRA_MATH
BC_ENABLE_EXTRA_MATH = %%EXTRA_MATH%%
BC_ENABLE_NLS = %%NLS%%
BC_LONG_BIT = %%LONG_BIT%%
BC_EXCLUDE_EXTRA_MATH = %%EXCLUDE_EXTRA_MATH%%
BC_ENABLE_AFL = %%FUZZ%%
BC_ENABLE_MEMCHECK = %%MEMCHECK%%
@ -201,14 +202,14 @@ DC_DEFS = $(DC_DEFS1) $(DC_DEFS2) $(DC_DEFS3) $(DC_DEFS4)
CPPFLAGS1 = -D$(BC_ENABLED_NAME)=$(BC_ENABLED) -D$(DC_ENABLED_NAME)=$(DC_ENABLED)
CPPFLAGS2 = $(CPPFLAGS1) -I$(INCDIR)/ -DBUILD_TYPE=$(BC_BUILD_TYPE) %%LONG_BIT_DEFINE%%
CPPFLAGS3 = $(CPPFLAGS2) -DEXECPREFIX=$(EXEC_PREFIX) -DMAINEXEC=$(MAIN_EXEC)
CPPFLAGS4 = $(CPPFLAGS3) -D_POSIX_C_SOURCE=200809L -D_XOPEN_SOURCE=700 %%BSD%%
CPPFLAGS4 = $(CPPFLAGS3) %%BSD%%
CPPFLAGS5 = $(CPPFLAGS4) -DBC_NUM_KARATSUBA_LEN=$(BC_NUM_KARATSUBA_LEN)
CPPFLAGS6 = $(CPPFLAGS5) -DBC_ENABLE_NLS=$(BC_ENABLE_NLS)
CPPFLAGS7 = $(CPPFLAGS6) -D$(BC_ENABLE_EXTRA_MATH_NAME)=$(BC_ENABLE_EXTRA_MATH)
CPPFLAGS8 = $(CPPFLAGS7) -DBC_ENABLE_HISTORY=$(BC_ENABLE_HISTORY) -DBC_ENABLE_LIBRARY=$(BC_ENABLE_LIBRARY)
CPPFLAGS = $(CPPFLAGS8) -DBC_ENABLE_MEMCHECK=$(BC_ENABLE_MEMCHECK) -DBC_ENABLE_AFL=$(BC_ENABLE_AFL)
CFLAGS = $(CPPFLAGS) $(BC_DEFS) $(DC_DEFS) %%CPPFLAGS%% %%CFLAGS%%
LDFLAGS = %%LDFLAGS%%
CFLAGS = $(CPPFLAGS) $(BC_DEFS) $(DC_DEFS) %%CPPFLAGS%% %%CFLAGS%% -I$(INCLUDEDIR)
LDFLAGS = %%LDFLAGS%% -L$(LIBDIR)
HOSTCFLAGS = %%HOSTCFLAGS%%
@ -235,25 +236,25 @@ $(GEN_EXEC): $(GEN_DIR)
%%GEN_EXEC_TARGET%%
$(BC_LIB_C): $(GEN_EXEC) $(BC_LIB)
$(GEN_EMU) $(GEN_EXEC) $(BC_LIB) $(BC_LIB_C) $(BC_LIB_C_ARGS)
$(GEN_EMU) $(GEN_EXEC) $(BC_LIB) $(BC_LIB_C) $(BC_EXCLUDE_EXTRA_MATH) $(BC_LIB_C_ARGS)
$(BC_LIB_O): $(BC_LIB_C)
$(CC) $(CFLAGS) -o $@ -c $<
$(BC_LIB2_C): $(GEN_EXEC) $(BC_LIB2)
$(GEN_EMU) $(GEN_EXEC) $(BC_LIB2) $(BC_LIB2_C) $(BC_LIB2_C_ARGS)
$(GEN_EMU) $(GEN_EXEC) $(BC_LIB2) $(BC_LIB2_C) $(BC_EXCLUDE_EXTRA_MATH) $(BC_LIB2_C_ARGS)
$(BC_LIB2_O): $(BC_LIB2_C)
$(CC) $(CFLAGS) -o $@ -c $<
$(BC_HELP_C): $(GEN_EXEC) $(BC_HELP)
$(GEN_EMU) $(GEN_EXEC) $(BC_HELP) $(BC_HELP_C) bc_help "" $(BC_ENABLED_NAME)
$(GEN_EMU) $(GEN_EXEC) $(BC_HELP) $(BC_HELP_C) $(BC_EXCLUDE_EXTRA_MATH) bc_help "" $(BC_ENABLED_NAME)
$(BC_HELP_O): $(BC_HELP_C)
$(CC) $(CFLAGS) -o $@ -c $<
$(DC_HELP_C): $(GEN_EXEC) $(DC_HELP)
$(GEN_EMU) $(GEN_EXEC) $(DC_HELP) $(DC_HELP_C) dc_help "" $(DC_ENABLED_NAME)
$(GEN_EMU) $(GEN_EXEC) $(DC_HELP) $(DC_HELP_C) $(BC_EXCLUDE_EXTRA_MATH) dc_help "" $(DC_ENABLED_NAME)
$(DC_HELP_O): $(DC_HELP_C)
$(CC) $(CFLAGS) -o $@ -c $<

23
contrib/bc/NEWS.md
View File

@ -1,5 +1,28 @@
# News
## 5.3.1
This is a production release that fixes a build problem in the FreeBSD base
system, as well as a problem in the `en_US` locale. If you don't have problems
with either, you do not need to upgrade.
## 5.3.0
This is a production release that adds features and has a few bug fixes.
First, support for editline and readline history has been added. To use
editline, pass `-e` to `configure.sh`, and to use readline, pass `-r`.
Second, history support for Windows has been fixed and re-enabled.
Third, command-line options to set `scale`, `ibase`, `obase`, and `seed` were
added. This was requested long ago, and I originally disagreed with the idea.
Fourth, the manuals had typos and were missing information. That has been fixed.
Fifth, the manuals received different formatting to be more readable as
manpages.
## 5.2.5
This is a production release that fixes this `bc`'s behavior on `^D` to match

34
contrib/bc/README.md
View File

@ -1,5 +1,10 @@
# `bc`
***WARNING: New user registration for https://git.yzena.com/ is disabled because
of spam. If you need to report a bug with `bc`, email gavin at this site minus
the `git.` part for an account, and I will create one for you. Or you can report
an issue at [GitHub][29].***
***WARNING: This project has moved to [https://git.yzena.com/][20] for [these
reasons][21], though GitHub will remain a mirror.***
@ -71,8 +76,8 @@ Also, if building with MSBuild, the MSBuild bundled with Visual Studio is
required.
**Note**: Unlike the POSIX-compatible platforms, only one build configuration is
supported on Windows: extra math and prompt enabled, history and NLS (locale
support) disabled, with both calculators built.
supported on Windows: extra math and history enabled, NLS (locale support)
disabled, with both calculators built.
#### `bc`
@ -179,9 +184,6 @@ see the [build manual][5].
The library API can be found in [`manuals/bcl.3.md`][26] or `man bcl` once the
library is installed.
The library is built as `bin/libbcl.a` on POSIX-compatible systems or as
`Release/bcl/bcl.lib` on Windows.
#### Package and Distro Maintainers
This section is for package and distro maintainers.
@ -289,8 +291,7 @@ with POSIX `bc`. The math has been tested with 40+ million random problems, so
it is as correct as I can make it.
This `bc` can be used as a drop-in replacement for any existing `bc`. This `bc`
is also compatible with MinGW toolchains, though history is not supported on
Windows.
is also compatible with MinGW toolchains.
In addition, this `bc` is considered complete; i.e., there will be no more
releases with additional features. However, it *is* actively maintained, so if
@ -405,18 +406,18 @@ Files:
Makefile.in The Makefile template.
NEWS.md The changelog.
NOTICE.md List of contributors and copyright owners.
RELEASE.md A checklist for making a release (maintainer use only).
Folders:
gen The bc math library, help texts, and code to generate C source.
include All header files.
locales Locale files, in .msg format. Patches welcome for translations.
manuals Manuals for both programs.
src All source code.
scripts A bunch of shell scripts to help with development and building.
tests All tests.
vs Files needed for the build on Windows.
benchmarks A folder of benchmarks for various aspects of bc performance.
gen The bc math library, help texts, and code to generate C source.
include All header files.
locales Locale files, in .msg format. Patches welcome for translations.
manuals Manuals for both programs.
src All source code.
scripts A bunch of shell scripts to help with development and building.
tests All tests.
vs Files needed for the build on Windows.
[1]: https://www.gnu.org/software/bc/
[4]: ./LICENSE.md
@ -439,3 +440,4 @@ Folders:
[26]: ./manuals/bcl.3.md
[27]: https://en.wikipedia.org/wiki/Bus_factor
[28]: ./manuals/development.md
[29]: https://github.com/gavinhoward/bc

87
contrib/bc/configure.sh
View File

@ -52,12 +52,13 @@ usage() {
printf 'usage:\n'
printf ' %s -h\n' "$script"
printf ' %s --help\n' "$script"
printf ' %s [-a|-bD|-dB|-c] [-CEfgGHlmMNtTvz] [-O OPT_LEVEL] [-k KARATSUBA_LEN]\\\n' "$script"
printf ' %s [-a|-bD|-dB|-c] [-CeEfgGHlmMNrtTvz] [-O OPT_LEVEL] [-k KARATSUBA_LEN]\\\n' "$script"
printf ' [-s SETTING] [-S SETTING]\n'
printf ' %s \\\n' "$script"
printf ' [--library|--bc-only --disable-dc|--dc-only --disable-bc|--coverage] \\\n'
printf ' [--force --debug --disable-extra-math --disable-generated-tests] \\\n'
printf ' [--disable-history --disable-man-pages --disable-nls --disable-strip] \\\n'
printf ' [--enable-editline] [--enable-readline] \\\n'
printf ' [--install-all-locales] [--opt=OPT_LEVEL] \\\n'
printf ' [--karatsuba-len=KARATSUBA_LEN] \\\n'
printf ' [--set-default-on=SETTING] [--set-default-off=SETTING] \\\n'
@ -87,6 +88,11 @@ usage() {
printf ' -D, --disable-dc\n'
printf ' Disable dc. It is an error if "-d", "--dc-only", "-B", or "--disable-bc"\n'
printf ' are specified too.\n'
printf ' -e, --enable-editline\n'
printf ' Enable the use of libedit/editline. This is meant for those users that\n'
printf ' want vi-like or Emacs-like behavior in history.This option is ignored if\n'
printf ' history is disabled. It is an error if this option is enabled when the\n'
printf ' -r/--enable-readline option is enabled.\n'
printf ' -E, --disable-extra-math\n'
printf ' Disable extra math. This includes: "$" operator (truncate to integer),\n'
printf ' "@" operator (set number of decimal places), and r(x, p) (rounding\n'
@ -125,6 +131,11 @@ usage() {
printf ' Set the optimization level. This can also be included in the CFLAGS,\n'
printf ' but it is provided, so maintainers can build optimized debug builds.\n'
printf ' This is passed through to the compiler, so it must be supported.\n'
printf ' -r, --enable-readline\n'
printf ' Enable the use of libreadline/readline. This is meant for those users\n'
printf ' that want vi-like or Emacs-like behavior in history.This option is\n'
printf ' ignored if history is disabled. It is an error if this option is\n'
printf ' enabled when the -e/--enable-editline option is enabled.\n'
printf ' -s SETTING, --set-default-on SETTING\n'
printf ' Set the default named by SETTING to on. See below for possible values\n'
printf ' for SETTING. For multiple instances of the -s or -S for the the same\n'
@ -233,11 +244,10 @@ usage() {
printf ' "$HOSTCC" and run on the host machine. Using `gen/strgen.sh`\n'
printf ' removes the need to compile and run an executable on the host\n'
printf ' machine since `gen/strgen.sh` is a POSIX shell script. However,\n'
printf ' `gen/lib2.bc` is perilously close to 4095 characters, the max\n'
printf ' supported length of a string literal in C99 (and it could be\n'
printf ' added to in the future), and `gen/strgen.sh` generates a string\n'
printf ' literal instead of an array, as `gen/strgen.c` does. For most\n'
printf ' production-ready compilers, this limit probably is not\n'
printf ' `gen/lib2.bc` is over 4095 characters, the max supported length\n'
printf ' of a string literal in C99, and `gen/strgen.sh` generates a\n'
printf ' string literal instead of an array, as `gen/strgen.c` does. For\n'
printf ' most production-ready compilers, this limit probably is not\n'
printf ' enforced, but it could be. Both options are still available for\n'
printf ' this reason. If you are sure your compiler does not have the\n'
printf ' limit and do not want to compile and run a binary on the host\n'
@ -667,6 +677,8 @@ coverage=0
karatsuba_len=32
debug=0
hist=1
editline=0
readline=0
extra_math=1
optimization=""
generate_tests=1
@ -697,7 +709,7 @@ dc_default_expr_exit=1
# getopts is a POSIX utility, but it cannot handle long options. Thus, the
# handling of long options is done by hand, and that's the reason that short and
# long options cannot be mixed.
while getopts "abBcdDEfgGhHk:lMmNO:S:s:tTvz-" opt; do
while getopts "abBcdDeEfgGhHk:lMmNO:rS:s:tTvz-" opt; do
case "$opt" in
a) library=1 ;;
@ -707,6 +719,7 @@ while getopts "abBcdDEfgGhHk:lMmNO:S:s:tTvz-" opt; do
C) clean=0 ;;
d) dc_only=1 ;;
D) bc_only=1 ;;
e) editline=1 ;;
E) extra_math=0 ;;
f) force=1 ;;
g) debug=1 ;;
@ -719,6 +732,7 @@ while getopts "abBcdDEfgGhHk:lMmNO:S:s:tTvz-" opt; do
M) install_manpages=0 ;;
N) nls=0 ;;
O) optimization="$OPTARG" ;;
r) readline=1 ;;
S) set_default 0 "$OPTARG" ;;
s) set_default 1 "$OPTARG" ;;
t) time_tests=1 ;;
@ -844,6 +858,8 @@ while getopts "abBcdDEfgGhHk:lMmNO:S:s:tTvz-" opt; do
disable-man-pages) install_manpages=0 ;;
disable-nls) nls=0 ;;
disable-strip) strip_bin=0 ;;
enable-editline) editline=1 ;;
enable-readline) readline=1 ;;
enable-test-timing) time_tests=1 ;;
enable-valgrind) vg=1 ;;
enable-fuzz-mode) fuzz=1 ;;
@ -863,6 +879,8 @@ while getopts "abBcdDEfgGhHk:lMmNO:S:s:tTvz-" opt; do
usage "No arg allowed for --$arg option" ;;
enable-memcheck* | install-all-locales*)
usage "No arg allowed for --$arg option" ;;
enable-editline* | enable-readline*)
usage "No arg allowed for --$arg option" ;;
'') break ;; # "--" terminates argument processing
* ) usage "Invalid option $LONG_OPTARG" ;;
esac
@ -1333,12 +1351,17 @@ fi
# Like the above tested locale support, this tests history.
if [ "$hist" -eq 1 ]; then
if [ "$editline" -ne 0 ] && [ "$readline" -ne 0 ]; then
usage "Must only enable one of readline or editline"
fi
set +e
printf 'Testing history...\n'
flags="-DBC_ENABLE_HISTORY=1 -DBC_ENABLED=$bc -DDC_ENABLED=$dc"
flags="$flags -DBC_ENABLE_NLS=$nls -DBC_ENABLE_LIBRARY=0 -DBC_ENABLE_AFL=0"
flags="$flags -DBC_ENABLE_EDITLINE=$editline -DBC_ENABLE_READLINE=$readline"
flags="$flags -DBC_ENABLE_EXTRA_MATH=$extra_math -I$scriptdir/include/"
flags="$flags -D_POSIX_C_SOURCE=200809L -D_XOPEN_SOURCE=700"
@ -1366,13 +1389,56 @@ if [ "$hist" -eq 1 ]; then
fi
# We have to disable the history tests if it is disabled or valgrind is on.
# We have to disable the history tests if it is disabled or valgrind is on. Or
# if we are using editline or readline.
if [ "$hist" -eq 0 ] || [ "$vg" -ne 0 ]; then
test_bc_history_prereqs=" test_bc_history_skip"
test_dc_history_prereqs=" test_dc_history_skip"
history_tests="@printf 'Skipping history tests...\\\\n'"
CFLAGS="$CFLAGS -DBC_ENABLE_EDITLINE=0 -DBC_ENABLE_READLINE=0"
else
history_tests="@printf '\$(TEST_STARS)\\\\n\\\\nRunning history tests...\\\\n\\\\n' \&\& \$(TESTSDIR)/history.sh bc -a \&\& \$(TESTSDIR)/history.sh dc -a \&\& printf '\\\\nAll history tests passed.\\\\n\\\\n\$(TEST_STARS)\\\\n'"
if [ "$editline" -eq 0 ] && [ "$readline" -eq 0 ]; then
history_tests="@printf '\$(TEST_STARS)\\\\n\\\\nRunning history tests...\\\\n\\\\n'"
history_tests="$history_tests \&\& \$(TESTSDIR)/history.sh bc -a \&\&"
history_tests="$history_tests \$(TESTSDIR)/history.sh dc -a \&\& printf"
history_tests="$history_tests '\\\\nAll history tests passed.\\\\n\\\\n\$(TEST_STARS)\\\\n'"
else
test_bc_history_prereqs=" test_bc_history_skip"
test_dc_history_prereqs=" test_dc_history_skip"
history_tests="@printf 'Skipping history tests...\\\\n'"
fi
# We are also setting the CFLAGS and LDFLAGS here.
if [ "$editline" -ne 0 ]; then
LDFLAGS="$LDFLAGS -ledit"
CFLAGS="$CFLAGS -DBC_ENABLE_EDITLINE=1 -DBC_ENABLE_READLINE=0"
elif [ "$readline" -ne 0 ]; then
LDFLAGS="$LDFLAGS -lreadline"
CFLAGS="$CFLAGS -DBC_ENABLE_EDITLINE=0 -DBC_ENABLE_READLINE=1"
else
CFLAGS="$CFLAGS -DBC_ENABLE_EDITLINE=0 -DBC_ENABLE_READLINE=0"
fi
fi
# Test FreeBSD. This is not in an if statement because regardless of whatever
# the user says, we need to know if we are on FreeBSD. If we are, we cannot set
# _POSIX_C_SOURCE and _XOPEN_SOURCE. The FreeBSD headers turn *off* stuff when
# that is done.
set +e
printf 'Testing for FreeBSD...\n'
flags="-DBC_TEST_FREEBSD -DBC_ENABLE_AFL=0"
"$CC" $CPPFLAGS $CFLAGS $flags "-I$scriptdir/include" -E "$scriptdir/include/status.h" > /dev/null 2>&1
err="$?"
if [ "$err" -ne 0 ]; then
printf 'On FreeBSD. Not using _POSIX_C_SOURCE and _XOPEN_SOURCE.\n\n'
else
printf 'Not on FreeBSD. Using _POSIX_C_SOURCE and _XOPEN_SOURCE.\n\n'
CPPFLAGS="$CPPFLAGS -D_POSIX_C_SOURCE=200809L -D_XOPEN_SOURCE=700"
fi
# Test OpenBSD. This is not in an if statement because regardless of whatever
@ -1431,9 +1497,11 @@ headers="\$(HEADERS)"
# This series of if statements figure out what source files are *not* needed.
if [ "$extra_math" -eq 0 ]; then
exclude_extra_math=1
manpage_args="E"
unneeded="$unneeded rand.c"
else
exclude_extra_math=0
headers="$headers \$(EXTRA_MATH_HEADERS)"
fi
@ -1645,6 +1713,7 @@ contents=$(replace "$contents" "DC_ERROR_TESTS" "$dc_err_tests")
contents=$(replace "$contents" "DC_TEST_EXEC" "$dc_test_exec")
contents=$(replace "$contents" "BUILD_TYPE" "$manpage_args")
contents=$(replace "$contents" "EXCLUDE_EXTRA_MATH" "$exclude_extra_math")
contents=$(replace "$contents" "LIBRARY" "$library")
contents=$(replace "$contents" "HISTORY" "$hist")

26
contrib/bc/gen/bc_help.txt
View File

@ -62,6 +62,14 @@ This bc has three differences to the GNU bc:
This bc also implements the dot (.) extension of the BSD bc.
Options:
{{ A H N HN }}
-E seed --seed=seed
Sets the builtin variable seed to the given value assuming that the given
value is in base 10. It is a fatal error if the given value is not a valid
number.
{{ end }}
-e expr --expression=expr
@ -82,6 +90,12 @@ Options:
Print this usage message and exit.
-I ibase --ibase=ibase
Sets the builtin variable ibase to the given value assuming that the given
value is in base 10. It is a fatal error if the given value is not a valid
number.
-i --interactive
Force interactive mode.
@ -104,6 +118,12 @@ Options:
This bc may load more functions with these options. See the manpage or
online documentation for details.
-O obase --obase=obase
Sets the builtin variable obase to the given value assuming that the given
value is in base 10. It is a fatal error if the given value is not a valid
number.
-P --no-prompt
Disable the prompts in interactive mode.
@ -127,6 +147,12 @@ Options:
Don't print version and copyright.
-S scale --scale=scale
Sets the builtin variable scale to the given value assuming that the given
value is in base 10. It is a fatal error if the given value is not a valid
number.
-s --standard
Error if any non-POSIX extensions are used.

26
contrib/bc/gen/dc_help.txt
View File

@ -71,6 +71,14 @@ This dc has a few differences from the two above:
that requires a register name is taken as the register name.
Options:
{{ A H N HN }}
-E seed --seed=seed
Sets the builtin variable seed to the given value assuming that the given
value is in base 10. It is a fatal error if the given value is not a valid
number.
{{ end }}
-e expr --expression=expr
@ -85,6 +93,12 @@ Options:
Print this usage message and exit.
-I ibase --ibase=ibase
Sets the builtin variable ibase to the given value assuming that the given
value is in base 10. It is a fatal error if the given value is not a valid
number.
-i --interactive
Put dc into interactive mode. See the man page for more details.
@ -93,6 +107,12 @@ Options:
Disable line length checking.
-O obase --obase=obase
Sets the builtin variable obase to the given value assuming that the given
value is in base 10. It is a fatal error if the given value is not a valid
number.
-P --no-prompt
Disable the prompts in interactive mode.
@ -101,6 +121,12 @@ Options:
Disable the read prompt in interactive mode.
-S scale --scale=scale
Sets the builtin variable scale to the given value assuming that the given
value is in base 10. It is a fatal error if the given value is not a valid
number.
-V --version
Print version and copyright and exit.

306
contrib/bc/gen/strgen.c
View File

@ -33,6 +33,7 @@
*
*/
#include <assert.h>
#include <stdbool.h>
#include <stdio.h>
#include <stdlib.h>
@ -40,17 +41,39 @@
#include <errno.h>
// For some reason, Windows needs this header.
#include <fcntl.h>
#include <sys/stat.h>
#ifndef _WIN32
#include <unistd.h>
#endif // _WIN32
// For some reason, Windows can't have this header.
#ifndef _WIN32
#include <libgen.h>
#endif // _WIN32
// This pulls in cross-platform stuff.
#include "../include/bcl.h"
#define BC_ERR(v) (v)
// clang-format off
// The usage help.
static const char* const bc_gen_usage =
"usage: %s input output exclude name [label [define [remove_tabs]]]\n";
static const char* const bc_gen_ex_start = "{{ A H N HN }}";
static const char* const bc_gen_ex_end = "{{ end }}";
// This is exactly what it looks like. It just slaps a simple license header on
// the generated C source file.
static const char* const bc_gen_header =
"// Copyright (c) 2018-2021 Gavin D. Howard and contributors.\n"
"// Licensed under the 2-clause BSD license.\n"
"// *** AUTOMATICALLY GENERATED FROM %s. DO NOT MODIFY. ***\n\n";
// clang-format on
// These are just format strings used to generate the C source.
static const char* const bc_gen_label = "const char *%s = \"%s\";\n\n";
@ -77,8 +100,9 @@ static const char* const bc_gen_name_extern = "extern const char %s[];\n\n";
* @param filename The name of the file.
* @param mode The mode to open the file in.
*/
static void open_file(FILE** f, const char* filename, const char* mode) {
static void
open_file(FILE** f, const char* filename, const char* mode)
{
#ifndef _WIN32
*f = fopen(filename, mode);
@ -93,6 +117,108 @@ static void open_file(FILE** f, const char* filename, const char* mode) {
#endif // _WIN32
}
/**
* A portability file open function. This is copied from src/read.c. Make sure
* to update that if this changes.
* @param path The path to the file to open.
* @param mode The mode to open in.
*/
static int
bc_read_open(const char* path, int mode)
{
int fd;
#ifndef _WIN32
fd = open(path, mode);
#else // _WIN32
fd = -1;
open(&fd, path, mode);
#endif
return fd;
}
/**
* Reads a file and returns the file as a string. This has been copied from
* src/read.c. Make sure to change that if this changes.
* @param path The path to the file.
* @return The contents of the file as a string.
*/
static char*
bc_read_file(const char* path)
{
int e = IO_ERR;
size_t size, to_read;
struct stat pstat;
int fd;
char* buf;
char* buf2;
// This has been copied from src/read.c. Make sure to change that if this
// changes.
assert(path != NULL);
#ifndef NDEBUG
// Need this to quiet MSan.
// NOLINTNEXTLINE
memset(&pstat, 0, sizeof(struct stat));
#endif // NDEBUG
fd = bc_read_open(path, O_RDONLY);
// If we can't read a file, we just barf.
if (BC_ERR(fd < 0))
{
fprintf(stderr, "Could not open file: %s\n", path);
exit(INVALID_INPUT_FILE);
}
// The reason we call fstat is to eliminate TOCTOU race conditions. This
// way, we have an open file, so it's not going anywhere.
if (BC_ERR(fstat(fd, &pstat) == -1))
{
fprintf(stderr, "Could not stat file: %s\n", path);
exit(INVALID_INPUT_FILE);
}
// Make sure it's not a directory.
if (BC_ERR(S_ISDIR(pstat.st_mode)))
{
fprintf(stderr, "Path is directory: %s\n", path);
exit(INVALID_INPUT_FILE);
}
// Get the size of the file and allocate that much.
size = (size_t) pstat.st_size;
buf = (char*) malloc(size + 1);
if (buf == NULL)
{
fprintf(stderr, "Could not malloc\n");
exit(INVALID_INPUT_FILE);
}
buf2 = buf;
to_read = size;
do
{
// Read the file. We just bail if a signal interrupts. This is so that
// users can interrupt the reading of big files if they want.
ssize_t r = read(fd, buf2, to_read);
if (BC_ERR(r < 0)) exit(e);
to_read -= (size_t) r;
buf2 += (size_t) r;
}
while (to_read);
// Got to have a nul byte.
buf[size] = '\0';
close(fd);
return buf;
}
/**
* Outputs a label, which is a string literal that the code can use as a name
* for the file that is being turned into a string. This is important for the
@ -112,8 +238,9 @@ static void open_file(FILE** f, const char* filename, const char* mode) {
* @param name The actual label text, which is a filename.
* @return Positive if no error, negative on error, just like *printf().
*/
static int output_label(FILE* out, const char* label, const char* name) {
static int
output_label(FILE* out, const char* label, const char* name)
{
#ifndef _WIN32
return fprintf(out, bc_gen_label, label, name);
@ -125,7 +252,10 @@ static int output_label(FILE* out, const char* label, const char* name) {
int ret;
// This loop counts how many backslashes there are in the label.
for (i = 0; i < len; ++i) count += (name[i] == '\\');
for (i = 0; i < len; ++i)
{
count += (name[i] == '\\');
}
buf = (char*) malloc(len + 1 + count);
if (buf == NULL) return -1;
@ -136,11 +266,12 @@ static int output_label(FILE* out, const char* label, const char* name) {
// label byte-for-byte, unless it encounters a backslash, in which case, it
// copies the backslash twice to have it escaped properly in the string
// literal.
for (i = 0; i < len; ++i) {
for (i = 0; i < len; ++i)
{
buf[i + count] = name[i];
if (name[i] == '\\') {
if (name[i] == '\\')
{
count += 1;
buf[i + count] = name[i];
}
@ -178,9 +309,10 @@ static int output_label(FILE* out, const char* label, const char* name) {
*
* The required command-line parameters are:
*
* input Input filename.
* output Output filename.
* name The name of the char array.
* input Input filename.
* output Output filename.
* exclude Whether to exclude extra math-only stuff.
* name The name of the char array.
*
* The optional parameters are:
*
@ -202,34 +334,41 @@ static int output_label(FILE* out, const char* label, const char* name) {
* All text files that are transformed have license comments. This program finds
* the end of that comment and strips it out as well.
*/
int main(int argc, char *argv[]) {
int
main(int argc, char* argv[])
{
char* in;
FILE* out;
const char* label;
const char* define;
char* name;
unsigned int count, slashes, err = IO_ERR;
bool has_label, has_define, remove_tabs, exclude_extra_math;
size_t i;
FILE *in, *out;
char *label, *define, *name;
int c, count, slashes, err = IO_ERR;
bool has_label, has_define, remove_tabs;
if (argc < 4) {
printf("usage: %s input output name [label [define [remove_tabs]]]\n",
argv[0]);
if (argc < 5)
{
printf(bc_gen_usage, argv[0]);
return INVALID_PARAMS;
}
name = argv[3];
exclude_extra_math = (strtoul(argv[3], NULL, 10) != 0);
has_label = (argc > 4 && strcmp("", argv[4]) != 0);
label = has_label ? argv[4] : "";
name = argv[4];
has_define = (argc > 5 && strcmp("", argv[5]) != 0);
define = has_define ? argv[5] : "";
has_label = (argc > 5 && strcmp("", argv[5]) != 0);
label = has_label ? argv[5] : "";
remove_tabs = (argc > 6);
has_define = (argc > 6 && strcmp("", argv[6]) != 0);
define = has_define ? argv[6] : "";
open_file(&in, argv[1], "r");
if (!in) return INVALID_INPUT_FILE;
remove_tabs = (argc > 7);
in = bc_read_file(argv[1]);
if (in == NULL) return INVALID_INPUT_FILE;
open_file(&out, argv[2], "w");
if (!out) goto out_err;
if (out == NULL) goto out_err;
if (fprintf(out, bc_gen_header, argv[1]) < 0) goto err;
if (has_label && fprintf(out, bc_gen_label_extern, label) < 0) goto err;
@ -238,46 +377,121 @@ int main(int argc, char *argv[]) {
if (has_label && output_label(out, label, argv[1]) < 0) goto err;
if (fprintf(out, bc_gen_name, name) < 0) goto err;
c = count = slashes = 0;
i = count = slashes = 0;
// This is where the end of the license comment is found.
while (slashes < 2 && (c = fgetc(in)) >= 0) {
slashes += (slashes == 1 && c == '/' && fgetc(in) == '\n');
slashes += (!slashes && c == '/' && fgetc(in) == '*');
while (slashes < 2 && in[i] > 0)
{
if (slashes == 1 && in[i] == '*' && in[i + 1] == '/' &&
(in[i + 2] == '\n' || in[i + 2] == '\r'))
{
slashes += 1;
i += 2;
}
else if (!slashes && in[i] == '/' && in[i + 1] == '*')
{
slashes += 1;
i += 1;
}
i += 1;
}
// The file is invalid if the end of the license comment could not be found.
if (c < 0) {
if (in[i] == 0)
{
fprintf(stderr, "Could not find end of license comment\n");
err = INVALID_INPUT_FILE;
goto err;
}
i += 1;
// Do not put extra newlines at the beginning of the char array.
while ((c = fgetc(in)) == '\n');
while (in[i] == '\n' || in[i] == '\r')
{
i += 1;
}
// This loop is what generates the actual char array. It counts how many
// chars it has printed per line in order to insert newlines at appropriate
// places. It also skips tabs if they should be removed.
while (c >= 0) {
while (in[i] != 0)
{
int val;
if (!remove_tabs || c != '\t') {
if (in[i] == '\r')
{
i += 1;
continue;
}
if (!remove_tabs || in[i] != '\t')
{
// Check for excluding something for extra math.
if (in[i] == '{')
{
// If we found the start...
if (!strncmp(in + i, bc_gen_ex_start, strlen(bc_gen_ex_start)))
{
if (exclude_extra_math)
{
// Get past the braces.
i += 2;
// Find the end of the end.
while (in[i] != '{' && strncmp(in + i, bc_gen_ex_end,
strlen(bc_gen_ex_end)))
{
i += 1;
}
i += strlen(bc_gen_ex_end);
// Skip the last newline.
if (in[i] == '\r') i += 1;
i += 1;
continue;
}
else
{
i += strlen(bc_gen_ex_start);
// Skip the last newline.
if (in[i] == '\r') i += 1;
i += 1;
continue;
}
}
else if (!exclude_extra_math &&
!strncmp(in + i, bc_gen_ex_end, strlen(bc_gen_ex_end)))
{
i += strlen(bc_gen_ex_end);
// Skip the last newline.
if (in[i] == '\r') i += 1;
i += 1;
continue;
}
}
// Print a tab if we are at the beginning of a line.
if (!count && fputc('\t', out) == EOF) goto err;
val = fprintf(out, "%d,", c);
// Print the character.
val = fprintf(out, "%d,", in[i]);
if (val < 0) goto err;
count += val;
if (count > MAX_WIDTH) {
// Adjust the count.
count += (unsigned int) val;
if (count > MAX_WIDTH)
{
count = 0;
if (fputc('\n', out) == EOF) goto err;
}
}
c = fgetc(in);
i += 1;
}
// Make sure the end looks nice and insert the NUL byte at the end.
@ -289,6 +503,6 @@ int main(int argc, char *argv[]) {
err:
fclose(out);
out_err:
fclose(in);
return err;
free(in);
return (int) err;
}

31
contrib/bc/gen/strgen.sh
View File

@ -32,24 +32,39 @@ export LC_CTYPE=C
progname=${0##*/}
script="$0"
scriptdir=$(dirname "$script")
. "$scriptdir/../scripts/functions.sh"
# See strgen.c comment on main() for what these mean. Note, however, that this
# script generates a string literal, not a char array. To understand the
# consequences of that, see manuals/development.md#strgenc.
if [ $# -lt 3 ]; then
echo "usage: $progname input output name [label [define [remove_tabs]]]"
echo "usage: $progname input output exclude name [label [define [remove_tabs]]]"
exit 1
fi
input="$1"
output="$2"
name="$3"
label="$4"
define="$5"
remove_tabs="$6"
exclude="$3"
name="$4"
label="$5"
define="$6"
remove_tabs="$7"
exec < "$input"
tmpinput=$(mktemp -t "${input##*/}")
if [ "$exclude" -ne 0 ]; then
filter_text "$input" "$tmpinput" "E"
else
filter_text "$input" "$tmpinput" "A"
fi
exec < "$tmpinput"
exec > "$output"
rm -f "$tmpinput"
if [ -n "$label" ]; then
nameline="const char *${label} = \"${input}\";"
labelexternline="extern const char *${label};"
@ -83,3 +98,7 @@ $(sed -e "$remtabsexpr " -e '1,/^$/d; s:\\n:\\\\n:g; s:":\\":g; s:^:":; s:$:\\n"
;
${condend}
EOF
#if [ "$exclude" -ne 0 ]; then
#rm -rf "$input"
#fi

4
contrib/bc/include/args.h
View File

@ -46,8 +46,10 @@
* @param argv The array of arguments.
* @param exit_exprs True if bc/dc should exit when there are expressions,
* false otherwise.
* @param scale The current scale.
*/
void bc_args(int argc, char *argv[], bool exit_exprs);
void
bc_args(int argc, char* argv[], bool exit_exprs, BcBigDig scale);
// A reference to the list of long options.
extern const BcOptLong bc_args_lopt[];

65
contrib/bc/include/bc.h
View File

@ -49,7 +49,8 @@
* The main function for bc. It just sets variables and passes its arguments
* through to @a bc_vm_boot().
*/
void bc_main(int argc, char *argv[]);
void
bc_main(int argc, char* argv[]);
// These are references to the help text, the library text, and the "filename"
// for the library.
@ -66,8 +67,8 @@ extern const char* bc_lib2_name;
/**
* A struct containing information about a bc keyword.
*/
typedef struct BcLexKeyword {
typedef struct BcLexKeyword
{
/// Holds the length of the keyword along with a bit that, if set, means the
/// keyword is used in POSIX bc.
uchar data;
@ -87,8 +88,10 @@ typedef struct BcLexKeyword {
#define BC_LEX_KW_LEN(kw) ((size_t) ((kw)->data & ~(BC_LEX_CHAR_MSB(1))))
/// A macro to easily build a keyword entry. See bc_lex_kws in src/data.c.
#define BC_LEX_KW_ENTRY(a, b, c) \
{ .data = ((b) & ~(BC_LEX_CHAR_MSB(1))) | BC_LEX_CHAR_MSB(c), .name = a }
#define BC_LEX_KW_ENTRY(a, b, c) \
{ \
.data = ((b) & ~(BC_LEX_CHAR_MSB(1))) | BC_LEX_CHAR_MSB(c), .name = a \
}
#if BC_ENABLE_EXTRA_MATH
@ -113,7 +116,8 @@ extern const size_t bc_lex_kws_len;
* @a BcLexNext.)
* @param l The lexer.
*/
void bc_lex_token(BcLex *l);
void
bc_lex_token(BcLex* l);
// The following section is for flags needed when parsing bc code. These flags
// are complicated, but necessary. Why you ask? Because bc's standard is awful.
@ -144,49 +148,49 @@ void bc_lex_token(BcLex *l);
// flag stack. All `p` arguments are pointers to a BcParse.
// This flag is set if the parser has seen a left brace.
#define BC_PARSE_FLAG_BRACE (UINTMAX_C(1)<<0)
#define BC_PARSE_FLAG_BRACE (UINTMAX_C(1) << 0)
#define BC_PARSE_BRACE(p) (BC_PARSE_TOP_FLAG(p) & BC_PARSE_FLAG_BRACE)
// This flag is set if the parser is parsing inside of the braces of a function
// body.
#define BC_PARSE_FLAG_FUNC_INNER (UINTMAX_C(1)<<1)
#define BC_PARSE_FLAG_FUNC_INNER (UINTMAX_C(1) << 1)
#define BC_PARSE_FUNC_INNER(p) (BC_PARSE_TOP_FLAG(p) & BC_PARSE_FLAG_FUNC_INNER)
// This flag is set if the parser is parsing a function. It is different from
// the one above because it is set if it is parsing a function body *or* header,
// not just if it's parsing a function body.
#define BC_PARSE_FLAG_FUNC (UINTMAX_C(1)<<2)
#define BC_PARSE_FLAG_FUNC (UINTMAX_C(1) << 2)
#define BC_PARSE_FUNC(p) (BC_PARSE_TOP_FLAG(p) & BC_PARSE_FLAG_FUNC)
// This flag is set if the parser is expecting to parse a body, whether of a
// function, an if statement, or a loop.
#define BC_PARSE_FLAG_BODY (UINTMAX_C(1)<<3)
#define BC_PARSE_FLAG_BODY (UINTMAX_C(1) << 3)
#define BC_PARSE_BODY(p) (BC_PARSE_TOP_FLAG(p) & BC_PARSE_FLAG_BODY)
// This flag is set if bc is parsing a loop. This is important because the break
// and continue keywords are only valid inside of a loop.
#define BC_PARSE_FLAG_LOOP (UINTMAX_C(1)<<4)
#define BC_PARSE_FLAG_LOOP (UINTMAX_C(1) << 4)
#define BC_PARSE_LOOP(p) (BC_PARSE_TOP_FLAG(p) & BC_PARSE_FLAG_LOOP)
// This flag is set if bc is parsing the body of a loop. It is different from
// the one above the same way @a BC_PARSE_FLAG_FUNC_INNER is different from
// @a BC_PARSE_FLAG_FUNC.
#define BC_PARSE_FLAG_LOOP_INNER (UINTMAX_C(1)<<5)
#define BC_PARSE_FLAG_LOOP_INNER (UINTMAX_C(1) << 5)
#define BC_PARSE_LOOP_INNER(p) (BC_PARSE_TOP_FLAG(p) & BC_PARSE_FLAG_LOOP_INNER)
// This flag is set if bc is parsing an if statement.
#define BC_PARSE_FLAG_IF (UINTMAX_C(1)<<6)
#define BC_PARSE_FLAG_IF (UINTMAX_C(1) << 6)
#define BC_PARSE_IF(p) (BC_PARSE_TOP_FLAG(p) & BC_PARSE_FLAG_IF)
// This flag is set if bc is parsing an else statement. This is important
// because of "else if" constructions, among other things.
#define BC_PARSE_FLAG_ELSE (UINTMAX_C(1)<<7)
#define BC_PARSE_FLAG_ELSE (UINTMAX_C(1) << 7)
#define BC_PARSE_ELSE(p) (BC_PARSE_TOP_FLAG(p) & BC_PARSE_FLAG_ELSE)
// This flag is set if bc just finished parsing an if statement and its body.
// It tells the parser that it can probably expect an else statement next. This
// flag is, thus, one of the most subtle.
#define BC_PARSE_FLAG_IF_END (UINTMAX_C(1)<<8)
#define BC_PARSE_FLAG_IF_END (UINTMAX_C(1) << 8)
#define BC_PARSE_IF_END(p) (BC_PARSE_TOP_FLAG(p) & BC_PARSE_FLAG_IF_END)
/**
@ -230,7 +234,7 @@ void bc_lex_token(BcLex *l);
* @param t The token to return operator data for.
* @return The operator data for @a t.
*/
#define BC_PARSE_OP_DATA(t) bc_parse_ops[((t) - BC_LEX_OP_INC)]
#define BC_PARSE_OP_DATA(t) bc_parse_ops[((t) -BC_LEX_OP_INC)]
/**
* Returns non-zero if operator @a op is left associative, zero otherwise.
@ -261,7 +265,7 @@ void bc_lex_token(BcLex *l);
* @param e8 The eighth bit.
* @return An expression entry for bc_parse_exprs[].
*/
#define BC_PARSE_EXPR_ENTRY(e1, e2, e3, e4, e5, e6, e7, e8) \
#define BC_PARSE_EXPR_ENTRY(e1, e2, e3, e4, e5, e6, e7, e8) \
((UINTMAX_C(e1) << 7) | (UINTMAX_C(e2) << 6) | (UINTMAX_C(e3) << 5) | \
(UINTMAX_C(e4) << 4) | (UINTMAX_C(e5) << 3) | (UINTMAX_C(e6) << 2) | \
(UINTMAX_C(e7) << 1) | (UINTMAX_C(e8) << 0))
@ -272,7 +276,7 @@ void bc_lex_token(BcLex *l);
* @return True if i is an expression token, false otherwise.
*/
#define BC_PARSE_EXPR(i) \
(bc_parse_exprs[(((i) & (uchar) ~(0x07)) >> 3)] & (1 << (7 - ((i) & 0x07))))
(bc_parse_exprs[(((i) & (uchar) ~(0x07)) >> 3)] & (1 << (7 - ((i) &0x07))))
/**
* Returns the operator (by lex token) that is at the top of the operator
@ -337,7 +341,7 @@ void bc_lex_token(BcLex *l);
* @param t The token to turn into an instruction.
* @return The token as an instruction.
*/
#define BC_PARSE_TOKEN_INST(t) ((uchar) ((t) - BC_LEX_NEG + BC_INST_NEG))
#define BC_PARSE_TOKEN_INST(t) ((uchar) ((t) -BC_LEX_NEG + BC_INST_NEG))
/**
* Returns true if the token is a bc keyword.
@ -353,8 +357,8 @@ void bc_lex_token(BcLex *l);
///
/// Obviously, @a len is the number of tokens in the @a tokens array. If more
/// than 4 is needed in the future, @a tokens will have to be changed.
typedef struct BcParseNext {
typedef struct BcParseNext
{
/// The number of tokens in the tokens array.
uchar len;
@ -368,13 +372,15 @@ typedef struct BcParseNext {
/// A macro to generate a BcParseNext literal from BcParseNext data. See
/// src/data.c for examples.
#define BC_PARSE_NEXT(a, ...) \
{ .len = (uchar) (a), BC_PARSE_NEXT_TOKENS(__VA_ARGS__) }
#define BC_PARSE_NEXT(a, ...) \
{ \
.len = (uchar) (a), BC_PARSE_NEXT_TOKENS(__VA_ARGS__) \
}
/// A status returned by @a bc_parse_expr_err(). It can either return success or
/// an error indicating an empty expression.
typedef enum BcParseStatus {
typedef enum BcParseStatus
{
BC_PARSE_STATUS_SUCCESS,
BC_PARSE_STATUS_EMPTY_EXPR,
@ -387,14 +393,16 @@ typedef enum BcParseStatus {
* @param flags Flags that define the requirements that the parsed code must
* meet or an error will result. See @a BcParseExpr for more info.
*/
void bc_parse_expr(BcParse *p, uint8_t flags);
void
bc_parse_expr(BcParse* p, uint8_t flags);
/**
* The @a BcParseParse function for bc. (See include/parse.h for a definition of
* @a BcParseParse.)
* @param p The parser.
*/
void bc_parse_parse(BcParse *p);
void
bc_parse_parse(BcParse* p);
/**
* Ends a series of if statements. This is to ensure that full parses happen
@ -403,7 +411,8 @@ void bc_parse_parse(BcParse *p);
* function definition, we know we can add an empty else clause.
* @param p The parser.
*/
void bc_parse_endif(BcParse *p);
void
bc_parse_endif(BcParse* p);
/// References to the signal message and its length.
extern const char bc_sig_msg[];

224
contrib/bc/include/bcl.h
View File

@ -73,7 +73,7 @@
#define STDOUT_FILENO _fileno(stdout)
#define STDERR_FILENO _fileno(stderr)
#define ssize_t SSIZE_T
#define S_ISDIR(m) ((m) & _S_IFDIR)
#define S_ISDIR(m) ((m) & (_S_IFDIR))
#define O_RDONLY _O_RDONLY
#define stat _stat
#define fstat _fstat
@ -129,8 +129,8 @@ typedef uint32_t BclRandInt;
#if BC_ENABLE_LIBRARY
typedef enum BclError {
typedef enum BclError
{
BCL_ERROR_NONE,
BCL_ERROR_INVALID_NUM,
@ -151,8 +151,8 @@ typedef enum BclError {
} BclError;
typedef struct BclNumber {
typedef struct BclNumber
{
size_t i;
} BclNumber;
@ -161,81 +161,179 @@ struct BclCtxt;
typedef struct BclCtxt* BclContext;
void bcl_handleSignal(void);
bool bcl_running(void);
void
bcl_handleSignal(void);
BclError bcl_init(void);
void bcl_free(void);
bool
bcl_running(void);
bool bcl_abortOnFatalError(void);
void bcl_setAbortOnFatalError(bool abrt);
bool bcl_leadingZeroes(void);
void bcl_setLeadingZeroes(bool leadingZeroes);
BclError
bcl_init(void);
void bcl_gc(void);
void
bcl_free(void);
BclError bcl_pushContext(BclContext ctxt);
void bcl_popContext(void);
BclContext bcl_context(void);
bool
bcl_abortOnFatalError(void);
BclContext bcl_ctxt_create(void);
void bcl_ctxt_free(BclContext ctxt);
void bcl_ctxt_freeNums(BclContext ctxt);
void
bcl_setAbortOnFatalError(bool abrt);
size_t bcl_ctxt_scale(BclContext ctxt);
void bcl_ctxt_setScale(BclContext ctxt, size_t scale);
size_t bcl_ctxt_ibase(BclContext ctxt);
void bcl_ctxt_setIbase(BclContext ctxt, size_t ibase);
size_t bcl_ctxt_obase(BclContext ctxt);
void bcl_ctxt_setObase(BclContext ctxt, size_t obase);
bool
bcl_leadingZeroes(void);
BclError bcl_err(BclNumber n);
void
bcl_setLeadingZeroes(bool leadingZeroes);
BclNumber bcl_num_create(void);
void bcl_num_free(BclNumber n);
void
bcl_gc(void);
bool bcl_num_neg(BclNumber n);
void bcl_num_setNeg(BclNumber n, bool neg);
size_t bcl_num_scale(BclNumber n);
BclError bcl_num_setScale(BclNumber n, size_t scale);
size_t bcl_num_len(BclNumber n);
BclError
bcl_pushContext(BclContext ctxt);
BclError bcl_copy(BclNumber d, BclNumber s);
BclNumber bcl_dup(BclNumber s);
void
bcl_popContext(void);
BclError bcl_bigdig(BclNumber n, BclBigDig *result);
BclNumber bcl_bigdig2num(BclBigDig val);
BclContext
bcl_context(void);
BclNumber bcl_add(BclNumber a, BclNumber b);
BclNumber bcl_sub(BclNumber a, BclNumber b);
BclNumber bcl_mul(BclNumber a, BclNumber b);
BclNumber bcl_div(BclNumber a, BclNumber b);
BclNumber bcl_mod(BclNumber a, BclNumber b);
BclNumber bcl_pow(BclNumber a, BclNumber b);
BclNumber bcl_lshift(BclNumber a, BclNumber b);
BclNumber bcl_rshift(BclNumber a, BclNumber b);
BclNumber bcl_sqrt(BclNumber a);
BclError bcl_divmod(BclNumber a, BclNumber b, BclNumber *c, BclNumber *d);
BclNumber bcl_modexp(BclNumber a, BclNumber b, BclNumber c);
BclContext
bcl_ctxt_create(void);
ssize_t bcl_cmp(BclNumber a, BclNumber b);
void
bcl_ctxt_free(BclContext ctxt);
void bcl_zero(BclNumber n);
void bcl_one(BclNumber n);
void
bcl_ctxt_freeNums(BclContext ctxt);
BclNumber bcl_parse(const char *restrict val);
char* bcl_string(BclNumber n);
size_t
bcl_ctxt_scale(BclContext ctxt);
BclNumber bcl_irand(BclNumber a);
BclNumber bcl_frand(size_t places);
BclNumber bcl_ifrand(BclNumber a, size_t places);
void
bcl_ctxt_setScale(BclContext ctxt, size_t scale);
BclError bcl_rand_seedWithNum(BclNumber n);
BclError bcl_rand_seed(unsigned char seed[BCL_SEED_SIZE]);
void bcl_rand_reseed(void);
BclNumber bcl_rand_seed2num(void);
BclRandInt bcl_rand_int(void);
BclRandInt bcl_rand_bounded(BclRandInt bound);
size_t
bcl_ctxt_ibase(BclContext ctxt);
void
bcl_ctxt_setIbase(BclContext ctxt, size_t ibase);
size_t
bcl_ctxt_obase(BclContext ctxt);
void
bcl_ctxt_setObase(BclContext ctxt, size_t obase);
BclError
bcl_err(BclNumber n);
BclNumber
bcl_num_create(void);
void
bcl_num_free(BclNumber n);
bool
bcl_num_neg(BclNumber n);
void
bcl_num_setNeg(BclNumber n, bool neg);
size_t
bcl_num_scale(BclNumber n);
BclError
bcl_num_setScale(BclNumber n, size_t scale);
size_t
bcl_num_len(BclNumber n);
BclError
bcl_copy(BclNumber d, BclNumber s);
BclNumber
bcl_dup(BclNumber s);
BclError
bcl_bigdig(BclNumber n, BclBigDig* result);
BclNumber
bcl_bigdig2num(BclBigDig val);
BclNumber
bcl_add(BclNumber a, BclNumber b);
BclNumber
bcl_sub(BclNumber a, BclNumber b);
BclNumber
bcl_mul(BclNumber a, BclNumber b);
BclNumber
bcl_div(BclNumber a, BclNumber b);
BclNumber
bcl_mod(BclNumber a, BclNumber b);
BclNumber
bcl_pow(BclNumber a, BclNumber b);
BclNumber
bcl_lshift(BclNumber a, BclNumber b);
BclNumber
bcl_rshift(BclNumber a, BclNumber b);
BclNumber
bcl_sqrt(BclNumber a);
BclError
bcl_divmod(BclNumber a, BclNumber b, BclNumber* c, BclNumber* d);
BclNumber
bcl_modexp(BclNumber a, BclNumber b, BclNumber c);
ssize_t
bcl_cmp(BclNumber a, BclNumber b);
void
bcl_zero(BclNumber n);
void
bcl_one(BclNumber n);
BclNumber
bcl_parse(const char* restrict val);
char*
bcl_string(BclNumber n);
BclNumber
bcl_irand(BclNumber a);
BclNumber
bcl_frand(size_t places);
BclNumber
bcl_ifrand(BclNumber a, size_t places);
BclError
bcl_rand_seedWithNum(BclNumber n);
BclError
bcl_rand_seed(unsigned char seed[BCL_SEED_SIZE]);
void
bcl_rand_reseed(void);
BclNumber
bcl_rand_seed2num(void);
BclRandInt
bcl_rand_int(void);
BclRandInt
bcl_rand_bounded(BclRandInt bound);
#endif // BC_ENABLE_LIBRARY

15
contrib/bc/include/dc.h
View File

@ -46,7 +46,8 @@
* The main function for dc. It just sets variables and passes its arguments
* through to @a bc_vm_boot().
*/
void dc_main(int argc, char *argv[]);
void
dc_main(int argc, char* argv[]);
// A reference to the dc help text.
extern const char dc_help[];
@ -56,7 +57,8 @@ extern const char dc_help[];
* @a BcLexNext.)
* @param l The lexer.
*/
void dc_lex_token(BcLex *l);
void
dc_lex_token(BcLex* l);
/**
* Returns true if the negative char `_` should be treated as a command or not.
@ -66,7 +68,8 @@ void dc_lex_token(BcLex *l);
* @return True if a negative should be treated as a command, false if it
* should be treated as a negative sign on a number.
*/
bool dc_lex_negCommand(BcLex *l);
bool
dc_lex_negCommand(BcLex* l);
// References to the signal message and its length.
extern const char dc_sig_msg[];
@ -88,7 +91,8 @@ extern const uint8_t dc_parse_insts[];
* @a BcParseParse.)
* @param p The parser.
*/
void dc_parse_parse(BcParse *p);
void
dc_parse_parse(BcParse* p);
/**
* The @a BcParseExpr function for dc. (See include/parse.h for a definition of
@ -97,7 +101,8 @@ void dc_parse_parse(BcParse *p);
* @param flags Flags that define the requirements that the parsed code must
* meet or an error will result. See @a BcParseExpr for more info.
*/
void dc_parse_expr(BcParse *p, uint8_t flags);
void
dc_parse_expr(BcParse* p, uint8_t flags);
#endif // DC_ENABLED

82
contrib/bc/include/file.h
View File

@ -38,18 +38,34 @@
#include <stdarg.h>
#include <history.h>
#include <vector.h>
#define BC_FILE_ULL_LENGTH (21)
/// The file struct.
typedef struct BcFile {
#if BC_ENABLE_LINE_LIB
#include <stdio.h>
/// The file struct.
typedef struct BcFile
{
// The file. This is here simply to make the line lib code as compatible
// with the existing code as possible.
FILE* f;
} BcFile;
#else // BC_ENABLE_LINE_LIB
/// The file struct.
typedef struct BcFile
{
// The actual file descriptor.
int fd;
// The buffer for the file.
char *buf;
char* buf;
// The length (number of actual chars) in the buffer.
size_t len;
@ -59,13 +75,15 @@ typedef struct BcFile {
} BcFile;
#if BC_ENABLE_HISTORY
#endif // BC_ENABLE_LINE_LIB
#if BC_ENABLE_HISTORY && !BC_ENABLE_LINE_LIB
/// Types of flushing. These are important because of history and printing
/// strings without newlines, something that users could use as their own
/// prompts.
typedef enum BcFlushType {
typedef enum BcFlushType
{
/// Do not clear the stored partial line, but don't add to it.
BC_FLUSH_NO_EXTRAS_NO_CLEAR,
@ -80,10 +98,10 @@ typedef enum BcFlushType {
} BcFlushType;
#else // BC_ENABLE_HISTORY
#else // BC_ENABLE_HISTORY && !BC_ENABLE_LINE_LIB
// These make sure that the BcFlushType parameter disappears if history is not
// used.
// used, editline is used, or readline is used.
#define bc_file_putchar(f, t, c) bc_file_putchar(f, c)
#define bc_file_flushErr(f, t) bc_file_flushErr(f)
@ -91,7 +109,19 @@ typedef enum BcFlushType {
#define bc_file_write(f, t, b, n) bc_file_write(f, b, n)
#define bc_file_puts(f, t, s) bc_file_puts(f, s)
#endif // BC_ENABLE_HISTORY
#endif // BC_ENABLE_HISTORY && !BC_ENABLE_LINE_LIB
#if BC_ENABLE_LINE_LIB
/**
* Initialize a file.
* @param f The file to initialize.
* @param file The stdio file.
*/
void
bc_file_init(BcFile* f, FILE* file);
#else // BC_ENABLE_LINE_LIB
/**
* Initialize a file.
@ -100,13 +130,17 @@ typedef enum BcFlushType {
* @param buf The buffer for the file.
* @param cap The capacity of the buffer.
*/
void bc_file_init(BcFile *f, int fd, char *buf, size_t cap);
void
bc_file_init(BcFile* f, int fd, char* buf, size_t cap);
#endif // BC_ENABLE_LINE_LIB
/**
* Frees a file, including flushing it.
* @param f The file to free.
*/
void bc_file_free(BcFile *f);
void
bc_file_free(BcFile* f);
/**
* Print a char into the file.
@ -114,7 +148,8 @@ void bc_file_free(BcFile *f);
* @param type The flush type.
* @param c The character to write.
*/
void bc_file_putchar(BcFile *restrict f, BcFlushType type, uchar c);
void
bc_file_putchar(BcFile* restrict f, BcFlushType type, uchar c);
/**
* Flush and return an error if it failed. This is meant to be used when needing
@ -124,14 +159,16 @@ void bc_file_putchar(BcFile *restrict f, BcFlushType type, uchar c);
* @param type The flush type.
* @return A status indicating if an error occurred.
*/
BcStatus bc_file_flushErr(BcFile *restrict f, BcFlushType type);
BcStatus
bc_file_flushErr(BcFile* restrict f, BcFlushType type);
/**
* Flush and throw an error on failure.
* @param f The file to flush.
* @param type The flush type.
*/
void bc_file_flush(BcFile *restrict f, BcFlushType type);
void
bc_file_flush(BcFile* restrict f, BcFlushType type);
/**
* Write the contents of buf to the file.
@ -140,22 +177,24 @@ void bc_file_flush(BcFile *restrict f, BcFlushType type);
* @param buf The buffer whose contents will be written to the file.
* @param n The length of buf.
*/
void bc_file_write(BcFile *restrict f, BcFlushType type,
const char *buf, size_t n);
void
bc_file_write(BcFile* restrict f, BcFlushType type, const char* buf, size_t n);
/**
* Write to the file like fprintf would. This is very rudimentary.
* @param f The file to flush.
* @param fmt The format string.
*/
void bc_file_printf(BcFile *restrict f, const char *fmt, ...);
void
bc_file_printf(BcFile* restrict f, const char* fmt, ...);
/**
* Write to the file like vfprintf would. This is very rudimentary.
* @param f The file to flush.
* @param fmt The format string.
*/
void bc_file_vprintf(BcFile *restrict f, const char *fmt, va_list args);
void
bc_file_vprintf(BcFile* restrict f, const char* fmt, va_list args);
/**
* Write str to the file.
@ -163,15 +202,16 @@ void bc_file_vprintf(BcFile *restrict f, const char *fmt, va_list args);
* @param type The flush type.
* @param str The string to write to the file.
*/
void bc_file_puts(BcFile *restrict f, BcFlushType type, const char *str);
void
bc_file_puts(BcFile* restrict f, BcFlushType type, const char* str);
#if BC_ENABLE_HISTORY
#if BC_ENABLE_HISTORY && !BC_ENABLE_LINE_LIB
// Some constant flush types for ease of use.
extern const BcFlushType bc_flush_none;
extern const BcFlushType bc_flush_err;
extern const BcFlushType bc_flush_save;
#endif // BC_ENABLE_HISTORY
#endif // BC_ENABLE_HISTORY && !BC_ENABLE_LINE_LIB
#endif // BC_FILE_H

177
contrib/bc/include/history.h
View File

@ -83,9 +83,88 @@
#define BC_ENABLE_HISTORY (1)
#endif // BC_ENABLE_HISTORY
#if BC_ENABLE_HISTORY
#ifndef BC_ENABLE_EDITLINE
#define BC_ENABLE_EDITLINE (0)
#endif // BC_ENABLE_EDITLINE
#ifndef BC_ENABLE_READLINE
#define BC_ENABLE_READLINE (0)
#endif // BC_ENABLE_READLINE
#if BC_ENABLE_EDITLINE && BC_ENABLE_READLINE
#error Must enable only one of editline or readline, not both.
#endif // BC_ENABLE_EDITLINE && BC_ENABLE_READLINE
#if BC_ENABLE_EDITLINE || BC_ENABLE_READLINE
#define BC_ENABLE_LINE_LIB (1)
#else // BC_ENABLE_EDITLINE || BC_ENABLE_READLINE
#define BC_ENABLE_LINE_LIB (0)
#endif // BC_ENABLE_EDITLINE || BC_ENABLE_READLINE
#if BC_ENABLE_LINE_LIB
#include <stdbool.h>
#include <setjmp.h>
#include <signal.h>
#include <status.h>
#include <vector.h>
extern sigjmp_buf bc_history_jmpbuf;
extern volatile sig_atomic_t bc_history_inlinelib;
#endif // BC_ENABLE_LINE_LIB
#if BC_ENABLE_EDITLINE
#include <stdio.h>
#include <histedit.h>
/**
* The history struct for editline.
*/
typedef struct BcHistory
{
/// A place to store the current line.
EditLine* el;
/// The history.
History* hist;
/// Whether the terminal is bad. This is more or less not used.
bool badTerm;
} BcHistory;
// The path to the editrc and its length.
extern const char bc_history_editrc[];
extern const size_t bc_history_editrc_len;
#else // BC_ENABLE_EDITLINE
#if BC_ENABLE_READLINE
#include <stdio.h>
#include <readline/readline.h>
#include <readline/history.h>
/**
* The history struct for readline.
*/
typedef struct BcHistory
{
/// A place to store the current line.
char* line;
/// Whether the terminal is bad. This is more or less not used.
bool badTerm;
} BcHistory;
#else // BC_ENABLE_READLINE
#if BC_ENABLE_HISTORY
#include <stddef.h>
#include <signal.h>
@ -106,7 +185,7 @@
#include <conio.h>
#define strncasecmp _strnicmp
#define strcasecmp _stricmp
#define strcasecmp _stricmp
#endif // _WIN32
@ -154,9 +233,12 @@
#define BC_HISTORY_DEBUG_BUF_SIZE (1024)
// clang-format off
#define lndebug(...) \
do { \
if (bc_history_debug_fp.fd == 0) { \
do \
{ \
if (bc_history_debug_fp.fd == 0) \
{ \
bc_history_debug_buf = bc_vm_malloc(BC_HISTORY_DEBUG_BUF_SIZE); \
bc_file_init(&bc_history_debug_fp, \
open("/tmp/lndebug.txt", O_APPEND), \
@ -169,15 +251,17 @@
} \
bc_file_printf(&bc_history_debug_fp, ", " __VA_ARGS__); \
bc_file_flush(&bc_history_debug_fp); \
} while (0)
} \
while (0)
#else // BC_DEBUG_CODE
#define lndebug(fmt, ...)
#endif // BC_DEBUG_CODE
// clang-format on
/// An enum of useful actions. To understand what these mean, check terminal
/// emulators for their shortcuts or the VT100 codes.
typedef enum BcHistoryAction {
typedef enum BcHistoryAction
{
BC_ACTION_NULL = 0,
BC_ACTION_CTRL_A = 1,
BC_ACTION_CTRL_B = 2,
@ -200,7 +284,7 @@ typedef enum BcHistoryAction {
BC_ACTION_CTRL_Z = 26,
BC_ACTION_ESC = 27,
BC_ACTION_CTRL_BSLASH = 28,
BC_ACTION_BACKSPACE = 127
BC_ACTION_BACKSPACE = 127
} BcHistoryAction;
@ -208,8 +292,8 @@ typedef enum BcHistoryAction {
* This represents the state during line editing. We pass this state
* to functions implementing specific editing functionalities.
*/
typedef struct BcHistory {
typedef struct BcHistory
{
/// Edited line buffer.
BcVec buf;
@ -220,7 +304,7 @@ typedef struct BcHistory {
BcVec extras;
/// Prompt to display.
const char *prompt;
const char* prompt;
/// Prompt length.
size_t plen;
@ -272,39 +356,15 @@ typedef struct BcHistory {
} BcHistory;
/**
* Get a line from stdin using history. This returns a status because I don't
* want to throw errors while the terminal is in raw mode.
* @param h The history data.
* @param vec A vector to put the line into.
* @param prompt The prompt to display, if desired.
* @return A status indicating an error, if any. Returning a status here
* is better because if we throw an error out of history, we
* leave the terminal in raw mode or in some other half-baked
* state.
*/
BcStatus bc_history_line(BcHistory *h, BcVec *vec, const char *prompt);
/**
* Initialize history data.
* @param h The struct to initialize.
*/
void bc_history_init(BcHistory *h);
/**
* Free history data (and recook the terminal).
* @param h The struct to free.
*/
void bc_history_free(BcHistory *h);
/**
* Frees strings used by history.
* @param str The string to free.
*/
void bc_history_string_free(void *str);
void
bc_history_string_free(void* str);
// A list of terminals that don't work.
extern const char *bc_history_bad_terms[];
extern const char* bc_history_bad_terms[];
// A tab in history and its length.
extern const char bc_history_tab[];
@ -323,16 +383,53 @@ extern const size_t bc_history_combo_chars_len;
// Debug data.
extern BcFile bc_history_debug_fp;
extern char *bc_history_debug_buf;
extern char* bc_history_debug_buf;
/**
* A function to print keycodes for debugging.
* @param h The history data.
*/
void bc_history_printKeyCodes(BcHistory* h);
void
bc_history_printKeyCodes(BcHistory* h);
#endif // BC_DEBUG_CODE
#endif // BC_ENABLE_HISTORY
#endif // BC_ENABLE_READLINE
#endif // BC_ENABLE_EDITLINE
#if BC_ENABLE_HISTORY
/**
* Get a line from stdin using history. This returns a status because I don't
* want to throw errors while the terminal is in raw mode.
* @param h The history data.
* @param vec A vector to put the line into.
* @param prompt The prompt to display, if desired.
* @return A status indicating an error, if any. Returning a status here
* is better because if we throw an error out of history, we
* leave the terminal in raw mode or in some other half-baked
* state.
*/
BcStatus
bc_history_line(BcHistory* h, BcVec* vec, const char* prompt);
/**
* Initialize history data.
* @param h The struct to initialize.
*/
void
bc_history_init(BcHistory* h);
/**
* Free history data (and recook the terminal).
* @param h The struct to free.
*/
void
bc_history_free(BcHistory* h);
#endif // BC_ENABLE_HISTORY
#endif // BC_HISTORY_H

95
contrib/bc/include/lang.h
View File

@ -47,8 +47,8 @@
#include <num.h>
/// The instructions for bytecode.
typedef enum BcInst {
typedef enum BcInst
{
#if BC_ENABLED
/// Postfix increment and decrement. Prefix are translated into
@ -329,15 +329,15 @@ typedef enum BcInst {
} BcInst;
#if BC_C11
static_assert(BC_INST_INVALID <= UCHAR_MAX,
"Too many instructions to fit into an unsigned char");
_Static_assert(BC_INST_INVALID <= UCHAR_MAX,
"Too many instructions to fit into an unsigned char");
#endif // BC_C11
/// Used by maps to identify where items are in the array.
typedef struct BcId {
typedef struct BcId
{
/// The name of the item.
char *name;
char* name;
/// The index into the array where the item is.
size_t idx;
@ -345,8 +345,8 @@ typedef struct BcId {
} BcId;
/// The location of a var, array, or array element.
typedef struct BcLoc {
typedef struct BcLoc
{
/// The index of the var or array.
size_t loc;
@ -356,10 +356,10 @@ typedef struct BcLoc {
} BcLoc;
/// An entry for a constant.
typedef struct BcConst {
typedef struct BcConst
{
/// The original string as parsed from the source code.
char *val;
char* val;
/// The last base that the constant was parsed in.
BcBigDig base;
@ -372,8 +372,8 @@ typedef struct BcConst {
/// A function. This is also used in dc, not just bc. The reason is that strings
/// are executed in dc, and they are converted to functions in order to be
/// executed.
typedef struct BcFunc {
typedef struct BcFunc
{
/// The bytecode instructions.
BcVec code;
@ -399,7 +399,7 @@ typedef struct BcFunc {
BcVec consts;
/// The function's name.
const char *name;
const char* name;
#if BC_ENABLED
/// True if the function is a void function.
@ -409,8 +409,8 @@ typedef struct BcFunc {
} BcFunc;
/// Types of results that can be pushed onto the results stack.
typedef enum BcResultType {
typedef enum BcResultType
{
/// Result is a variable.
BC_RESULT_VAR,
@ -464,8 +464,8 @@ typedef enum BcResultType {
} BcResultType;
/// A union to store data for various result types.
typedef union BcResultData {
typedef union BcResultData
{
/// A number. Strings are stored here too; they are numbers with
/// cap == 0 && num == NULL. The string's index into the strings vector is
/// stored in the scale field. But this is only used for strings stored in
@ -482,8 +482,8 @@ typedef union BcResultData {
} BcResultData;
/// A tagged union for results.
typedef struct BcResult {
typedef struct BcResult
{
/// The tag. The type of the result.
BcResultType t;
@ -494,8 +494,8 @@ typedef struct BcResult {
/// An instruction pointer. This is how bc knows where in the bytecode vector,
/// and which function, the current execution is.
typedef struct BcInstPtr {
typedef struct BcInstPtr
{
/// The index of the currently executing function in the fns vector.
size_t func;
@ -510,8 +510,8 @@ typedef struct BcInstPtr {
} BcInstPtr;
/// Types of identifiers.
typedef enum BcType {
typedef enum BcType
{
/// Variable.
BC_TYPE_VAR,
@ -529,8 +529,8 @@ typedef enum BcType {
#if BC_ENABLED
/// An auto variable in bc.
typedef struct BcAuto {
typedef struct BcAuto
{
/// The index of the variable in the vars or arrs vectors.
size_t idx;
@ -549,7 +549,8 @@ struct BcProgram;
* @param name The name of the function. The string is assumed to be owned by
* some other entity.
*/
void bc_func_init(BcFunc *f, const char* name);
void
bc_func_init(BcFunc* f, const char* name);
/**
* Inserts an auto into the function.
@ -560,15 +561,17 @@ void bc_func_init(BcFunc *f, const char* name);
* @param line The line in the source code where the insert happened. This is
* solely for error reporting.
*/
void bc_func_insert(BcFunc *f, struct BcProgram* p, char* name,
BcType type, size_t line);
void
bc_func_insert(BcFunc* f, struct BcProgram* p, char* name, BcType type,
size_t line);
/**
* Resets a function in preparation for it to be reused. This can happen in bc
* because it is a dynamic language and functions can be redefined.
* @param f The functio to reset.
*/
void bc_func_reset(BcFunc *f);
void
bc_func_reset(BcFunc* f);
#ifndef NDEBUG
/**
@ -577,7 +580,8 @@ void bc_func_reset(BcFunc *f);
* check for memory leaks.
* @param func The function to free as a void pointer.
*/
void bc_func_free(void *func);
void
bc_func_free(void* func);
#endif // NDEBUG
/**
@ -591,7 +595,8 @@ void bc_func_free(void *func);
* @param nums True if the array should be for numbers, false if it should be
* for vectors.
*/
void bc_array_init(BcVec *a, bool nums);
void
bc_array_init(BcVec* a, bool nums);
/**
* Copies an array to another array. This is used to do pass arrays to functions
@ -600,19 +605,22 @@ void bc_array_init(BcVec *a, bool nums);
* @param d The destination array.
* @param s The source array.
*/
void bc_array_copy(BcVec *d, const BcVec *s);
void
bc_array_copy(BcVec* d, const BcVec* s);
/**
* Frees a string stored in a function. This is a destructor.
* @param string The string to free as a void pointer.
*/
void bc_string_free(void *string);
void
bc_string_free(void* string);
/**
* Frees a constant stored in a function. This is a destructor.
* @param constant The constant to free as a void pointer.
*/
void bc_const_free(void *constant);
void
bc_const_free(void* constant);
/**
* Clears a result. It sets the type to BC_RESULT_TEMP and clears the union by
@ -620,7 +628,8 @@ void bc_const_free(void *constant);
* uninitialized data.
* @param r The result to clear.
*/
void bc_result_clear(BcResult *r);
void
bc_result_clear(BcResult* r);
/**
* Copies a result into another. This is done for things like duplicating the
@ -629,13 +638,15 @@ void bc_result_clear(BcResult *r);
* @param d The destination result.
* @param src The source result.
*/
void bc_result_copy(BcResult *d, BcResult *src);
void
bc_result_copy(BcResult* d, BcResult* src);
/**
* Frees a result. This is a destructor.
* @param result The result to free as a void pointer.
*/
void bc_result_free(void *result);
void
bc_result_free(void* result);
/**
* Expands an array to @a len. This can happen because in bc, you do not have to
@ -646,7 +657,8 @@ void bc_result_free(void *result);
* @param a The array to expand.
* @param len The length to expand to.
*/
void bc_array_expand(BcVec *a, size_t len);
void
bc_array_expand(BcVec* a, size_t len);
/**
* Compare two BcId's and return the result. Since they are just comparing the
@ -656,7 +668,8 @@ void bc_array_expand(BcVec *a, size_t len);
* @param e2 The second id.
* @return The result of strcmp() on the BcId's names.
*/
int bc_id_cmp(const BcId *e1, const BcId *e2);
int
bc_id_cmp(const BcId* e1, const BcId* e2);
#if BC_ENABLED

49
contrib/bc/include/lex.h
View File

@ -84,8 +84,8 @@
((c) == '.' && !(pt) && !(int_only)))
/// An enum of lex token types.
typedef enum BcLexType {
typedef enum BcLexType
{
/// End of file.
BC_LEX_EOF,
@ -462,10 +462,10 @@ struct BcLex;
typedef void (*BcLexNext)(struct BcLex* l);
/// The lexer.
typedef struct BcLex {
typedef struct BcLex
{
/// A pointer to the text to lex.
const char *buf;
const char* buf;
/// The current index into buf.
size_t i;
@ -502,7 +502,8 @@ typedef struct BcLex {
* Initializes a lexer.
* @param l The lexer to initialize.
*/
void bc_lex_init(BcLex *l);
void
bc_lex_init(BcLex* l);
/**
* Frees a lexer. This is not guarded by #ifndef NDEBUG because a separate
@ -510,14 +511,16 @@ void bc_lex_init(BcLex *l);
* that parser needs a lexer.
* @param l The lexer to free.
*/
void bc_lex_free(BcLex *l);
void
bc_lex_free(BcLex* l);
/**
* Sets the filename that the lexer will be lexing.
* @param l The lexer.
* @param file The filename that the lexer will lex.
*/
void bc_lex_file(BcLex *l, const char *file);
void
bc_lex_file(BcLex* l, const char* file);
/**
* Sets the text the lexer will lex.
@ -527,32 +530,37 @@ void bc_lex_file(BcLex *l, const char *file);
* @param is_exprs True if the text is from command-line expressions, false
* otherwise.
*/
void bc_lex_text(BcLex *l, const char *text, bool is_stdin, bool is_exprs);
void
bc_lex_text(BcLex* l, const char* text, bool is_stdin, bool is_exprs);
/**
* Generic next function for the parser to call. It takes care of calling the
* correct @a BcLexNext function and consuming whitespace.
* @param l The lexer.
*/
void bc_lex_next(BcLex *l);
void
bc_lex_next(BcLex* l);
/**
* Lexes a line comment (one beginning with '#' and going to a newline).
* @param l The lexer.
*/
void bc_lex_lineComment(BcLex *l);
void
bc_lex_lineComment(BcLex* l);
/**
* Lexes a general comment (C-style comment).
* @param l The lexer.
*/
void bc_lex_comment(BcLex *l);
void
bc_lex_comment(BcLex* l);
/**
* Lexes whitespace, finding as much as possible.
* @param l The lexer.
*/
void bc_lex_whitespace(BcLex *l);
void
bc_lex_whitespace(BcLex* l);
/**
* Lexes a number that begins with char @a start. This takes care of parsing
@ -562,32 +570,37 @@ void bc_lex_whitespace(BcLex *l);
* this function, the lexer had to eat the first char. It fixes
* that by passing it in.
*/
void bc_lex_number(BcLex *l, char start);
void
bc_lex_number(BcLex* l, char start);
/**
* Lexes a name/identifier.
* @param l The lexer.
*/
void bc_lex_name(BcLex *l);
void
bc_lex_name(BcLex* l);
/**
* Lexes common whitespace characters.
* @param l The lexer.
* @param c The character to lex.
*/
void bc_lex_commonTokens(BcLex *l, char c);
void
bc_lex_commonTokens(BcLex* l, char c);
/**
* Throws a parse error because char @a c was invalid.
* @param l The lexer.
* @param c The problem character.
*/
void bc_lex_invalidChar(BcLex *l, char c);
void
bc_lex_invalidChar(BcLex* l, char c);
/**
* Reads a line from stdin and puts it into the lexer's buffer.
* @param l The lexer.
*/
bool bc_lex_readLine(BcLex *l);
bool
bc_lex_readLine(BcLex* l);
#endif // BC_LEX_H

104
contrib/bc/include/library.h
View File

@ -46,12 +46,14 @@
* @param l The label to jump to on error.
*/
#define BC_FUNC_HEADER_LOCK(l) \
do { \
do \
{ \
BC_SIG_LOCK; \
BC_SETJMP_LOCKED(l); \
vm.err = BCL_ERROR_NONE; \
vm.running = 1; \
} while (0)
} \
while (0)
/**
* A footer to unlock and stop the jumping if an error happened. It also sets
@ -59,25 +61,29 @@
* @param e The error variable to set.
*/
#define BC_FUNC_FOOTER_UNLOCK(e) \
do { \
do \
{ \
BC_SIG_ASSERT_LOCKED; \
e = vm.err; \
vm.running = 0; \
BC_UNSETJMP; \
BC_LONGJMP_STOP; \
vm.sig_lock = 0; \
} while (0)
} \
while (0)
/**
* A header that sets a jump and sets running.
* @param l The label to jump to on error.
*/
#define BC_FUNC_HEADER(l) \
do { \
do \
{ \
BC_SETJMP(l); \
vm.err = BCL_ERROR_NONE; \
vm.running = 1; \
} while (0)
} \
while (0)
/**
* A header that assumes that signals are already locked. It sets a jump and
@ -85,23 +91,27 @@
* @param l The label to jump to on error.
*/
#define BC_FUNC_HEADER_INIT(l) \
do { \
do \
{ \
BC_SETJMP_LOCKED(l); \
vm.err = BCL_ERROR_NONE; \
vm.running = 1; \
} while (0)
} \
while (0)
/**
* A footer for functions that do not return an error code. It clears running
* and unlocks the signals. It also stops the jumping.
*/
#define BC_FUNC_FOOTER_NO_ERR \
do { \
do \
{ \
vm.running = 0; \
BC_UNSETJMP; \
BC_LONGJMP_STOP; \
vm.sig_lock = 0; \
} while (0)
} \
while (0)
/**
* A footer for functions that *do* return an error code. It clears running and
@ -109,10 +119,12 @@
* @param e The error variable to set.
*/
#define BC_FUNC_FOOTER(e) \
do { \
do \
{ \
e = vm.err; \
BC_FUNC_FOOTER_NO_ERR; \
} while (0)
} \
while (0)
/**
* A footer that sets up n based the value of e and sets up the return value in
@ -123,13 +135,16 @@
* @param idx The idx to set as the return value.
*/
#define BC_MAYBE_SETUP(c, e, n, idx) \
do { \
if (BC_ERR((e) != BCL_ERROR_NONE)) { \
do \
{ \
if (BC_ERR((e) != BCL_ERROR_NONE)) \
{ \
if ((n).num != NULL) bc_num_free(&(n)); \
idx.i = 0 - (size_t) (e); \
} \
else idx = bcl_num_insert(c, &(n)); \
} while (0)
} \
while (0)
/**
* A header to check the context and return an error encoded in a number if it
@ -137,37 +152,44 @@
* @param c The context.
*/
#define BC_CHECK_CTXT(c) \
do { \
do \
{ \
c = bcl_context(); \
if (BC_ERR(c == NULL)) { \
if (BC_ERR(c == NULL)) \
{ \
BclNumber n_num; \
n_num.i = 0 - (size_t) BCL_ERROR_INVALID_CONTEXT; \
return n_num; \
} \
} while (0)
} \
while (0)
/**
* A header to check the context and return an error directly if it is bad.
* @param c The context.
*/
#define BC_CHECK_CTXT_ERR(c) \
do { \
do \
{ \
c = bcl_context(); \
if (BC_ERR(c == NULL)) { \
if (BC_ERR(c == NULL)) \
{ \
return BCL_ERROR_INVALID_CONTEXT; \
} \
} while (0)
} \
while (0)
/**
* A header to check the context and abort if it is bad.
* @param c The context.
*/
#define BC_CHECK_CTXT_ASSERT(c) \
do { \
do \
{ \
c = bcl_context(); \
assert(c != NULL); \
} while (0)
} \
while (0)
/**
* A header to check the number in the context and return an error encoded as a
@ -176,16 +198,22 @@
* @param n The BclNumber.
*/
#define BC_CHECK_NUM(c, n) \
do { \
if (BC_ERR((n).i >= (c)->nums.len)) { \
do \
{ \
if (BC_ERR((n).i >= (c)->nums.len)) \
{ \
if ((n).i > 0 - (size_t) BCL_ERROR_NELEMS) return (n); \
else { \
else \
{ \
BclNumber n_num; \
n_num.i = 0 - (size_t) BCL_ERROR_INVALID_NUM; \
return n_num; \
} \
} \
} while (0)
} \
while (0)
//clang-format off
/**
* A header to check the number in the context and return an error directly if
@ -194,13 +222,20 @@
* @param n The BclNumber.
*/
#define BC_CHECK_NUM_ERR(c, n) \
do { \
if (BC_ERR((n).i >= (c)->nums.len)) { \
do \
{ \
if (BC_ERR((n).i >= (c)->nums.len)) \
{ \
if ((n).i > 0 - (size_t) BCL_ERROR_NELEMS) \
{ \
return (BclError) (0 - (n).i); \
} \
else return BCL_ERROR_INVALID_NUM; \
} \
} while (0)
} \
while (0)
//clang-format on
/**
* Turns a BclNumber into a BcNum.
@ -213,11 +248,12 @@
* Frees a BcNum for bcl. This is a destructor.
* @param num The BcNum to free, as a void pointer.
*/
void bcl_num_destruct(void *num);
void
bcl_num_destruct(void* num);
/// The actual context struct.
typedef struct BclCtxt {
typedef struct BclCtxt
{
/// The context's scale.
size_t scale;

161
contrib/bc/include/num.h
View File

@ -106,12 +106,12 @@ typedef int_least16_t BcDig;
#define BC_NUM_DEF_SIZE (8)
/// The actual number struct. This is where the magic happens.
typedef struct BcNum {
typedef struct BcNum
{
/// The limb array. It is restrict because *no* other item should own the
/// array. For more information, see the development manual
/// (manuals/development.md#numbers).
BcDig *restrict num;
BcDig* restrict num;
/// The number of limbs before the decimal (radix) point. This also stores
/// the negative bit in the least significant bit since it uses at least two
@ -259,8 +259,7 @@ struct BcRNG;
* @param v The value to set the rdx to.
* @param neg The value to set the negative bit to.
*/
#define BC_NUM_RDX_SET_NEG(n, v, neg) \
((n)->rdx = (((v) << 1) | (neg)))
#define BC_NUM_RDX_SET_NEG(n, v, neg) ((n)->rdx = (((v) << 1) | (neg)))
/**
* Returns true if the rdx and scale for @a n match.
@ -350,11 +349,11 @@ struct BcRNG;
// These are for debugging only.
#if BC_DEBUG_CODE
#define BC_NUM_PRINT(x) fprintf(stderr, "%s = %lu\n", #x, (unsigned long)(x))
#define BC_NUM_PRINT(x) fprintf(stderr, "%s = %lu\n", #x, (unsigned long) (x))
#define DUMP_NUM bc_num_dump
#else // BC_DEBUG_CODE
#undef DUMP_NUM
#define DUMP_NUM(x,y)
#define DUMP_NUM(x, y)
#define BC_NUM_PRINT(x)
#endif // BC_DEBUG_CODE
@ -419,7 +418,8 @@ typedef void (*BcNumShiftAddOp)(BcDig* restrict a, const BcDig* restrict b,
* @param n The number to initialize.
* @param req The number of limbs @a n must have in its limb array.
*/
void bc_num_init(BcNum *restrict n, size_t req);
void
bc_num_init(BcNum* restrict n, size_t req);
/**
* Initializes (sets up) @a n with the preallocated limb array @a num that has
@ -429,7 +429,8 @@ void bc_num_init(BcNum *restrict n, size_t req);
* @param num The preallocated limb array.
* @param cap The capacity of @a num.
*/
void bc_num_setup(BcNum *restrict n, BcDig *restrict num, size_t cap);
void
bc_num_setup(BcNum* restrict n, BcDig* restrict num, size_t cap);
/**
* Copies @a s into @a d. This does a deep copy and requires that @a d is
@ -437,7 +438,8 @@ void bc_num_setup(BcNum *restrict n, BcDig *restrict num, size_t cap);
* @param d The destination BcNum.
* @param s The source BcNum.
*/
void bc_num_copy(BcNum *d, const BcNum *s);
void
bc_num_copy(BcNum* d, const BcNum* s);
/**
* Creates @a d and copies @a s into @a d. This does a deep copy and requires
@ -445,7 +447,8 @@ void bc_num_copy(BcNum *d, const BcNum *s);
* @param d The destination BcNum.
* @param s The source BcNum.
*/
void bc_num_createCopy(BcNum *d, const BcNum *s);
void
bc_num_createCopy(BcNum* d, const BcNum* s);
/**
* Creates (initializes) @a n and sets its value to the equivalent of @a val.
@ -453,27 +456,31 @@ void bc_num_createCopy(BcNum *d, const BcNum *s);
* @param n The number to initialize and set.
* @param val The value to set @a n's value to.
*/
void bc_num_createFromBigdig(BcNum *restrict n, BcBigDig val);
void
bc_num_createFromBigdig(BcNum* restrict n, BcBigDig val);
/**
* Makes @a n valid for holding strings. @a n must *not* be allocated; this
* simply clears some fields, including setting the num field to NULL.
* @param n The number to clear.
*/
void bc_num_clear(BcNum *restrict n);
void
bc_num_clear(BcNum* restrict n);
/**
* Frees @a num, which is a BcNum as a void pointer. This is a destructor.
* @param num The BcNum to free as a void pointer.
*/
void bc_num_free(void *num);
void
bc_num_free(void* num);
/**
* Returns the scale of @a n.
* @param n The number.
* @return The scale of @a n.
*/
size_t bc_num_scale(const BcNum *restrict n);
size_t
bc_num_scale(const BcNum* restrict n);
/**
* Returns the length (in decimal digits) of @a n. This is complicated. First,
@ -483,7 +490,8 @@ size_t bc_num_scale(const BcNum *restrict n);
* @param n The number.
* @return The length of @a n.
*/
size_t bc_num_len(const BcNum *restrict n);
size_t
bc_num_len(const BcNum* restrict n);
/**
* Convert a number to a BcBigDig (hardware integer). This version does error
@ -492,7 +500,8 @@ size_t bc_num_len(const BcNum *restrict n);
* @param n The number to convert.
* @return The number as a hardware integer.
*/
BcBigDig bc_num_bigdig(const BcNum *restrict n);
BcBigDig
bc_num_bigdig(const BcNum* restrict n);
/**
* Convert a number to a BcBigDig (hardware integer). This version does no error
@ -500,7 +509,8 @@ BcBigDig bc_num_bigdig(const BcNum *restrict n);
* @param n The number to convert.
* @return The number as a hardware integer.
*/
BcBigDig bc_num_bigdig2(const BcNum *restrict n);
BcBigDig
bc_num_bigdig2(const BcNum* restrict n);
/**
* Sets @a n to the value of @a val. @a n is expected to be a valid and
@ -508,7 +518,8 @@ BcBigDig bc_num_bigdig2(const BcNum *restrict n);
* @param n The number to set.
* @param val The value to set the number to.
*/
void bc_num_bigdig2num(BcNum *restrict n, BcBigDig val);
void
bc_num_bigdig2num(BcNum* restrict n, BcBigDig val);
#if BC_ENABLE_EXTRA_MATH
@ -519,22 +530,24 @@ void bc_num_bigdig2num(BcNum *restrict n, BcBigDig val);
* @param b The return value.
* @param rng The pseudo-random number generator.
*/
void bc_num_irand(BcNum *restrict a, BcNum *restrict b,
struct BcRNG *restrict rng);
void
bc_num_irand(BcNum* restrict a, BcNum* restrict b, struct BcRNG* restrict rng);
/**
* Sets the seed for the PRNG @a rng from @a n.
* @param n The new seed for the PRNG.
* @param rng The PRNG to set the seed for.
*/
void bc_num_rng(const BcNum *restrict n, struct BcRNG *rng);
void
bc_num_rng(const BcNum* restrict n, struct BcRNG* rng);
/**
* Sets @a n to the value produced by the PRNG. This implements rand().
* @param n The number to set.
* @param rng The pseudo-random number generator.
*/
void bc_num_createFromRNG(BcNum *restrict n, struct BcRNG *rng);
void
bc_num_createFromRNG(BcNum* restrict n, struct BcRNG* rng);
#endif // BC_ENABLE_EXTRA_MATH
@ -545,7 +558,8 @@ void bc_num_createFromRNG(BcNum *restrict n, struct BcRNG *rng);
* @param c The return value.
* @param scale The current scale.
*/
void bc_num_add(BcNum *a, BcNum *b, BcNum *c, size_t scale);
void
bc_num_add(BcNum* a, BcNum* b, BcNum* c, size_t scale);
/**
* The subtract function. This is a BcNumBinaryOp function.
@ -554,7 +568,8 @@ void bc_num_add(BcNum *a, BcNum *b, BcNum *c, size_t scale);
* @param c The return value.
* @param scale The current scale.
*/
void bc_num_sub(BcNum *a, BcNum *b, BcNum *c, size_t scale);
void
bc_num_sub(BcNum* a, BcNum* b, BcNum* c, size_t scale);
/**
* The multiply function.
@ -563,7 +578,8 @@ void bc_num_sub(BcNum *a, BcNum *b, BcNum *c, size_t scale);
* @param c The return value.
* @param scale The current scale.
*/
void bc_num_mul(BcNum *a, BcNum *b, BcNum *c, size_t scale);
void
bc_num_mul(BcNum* a, BcNum* b, BcNum* c, size_t scale);
/**
* The division function.
@ -572,7 +588,8 @@ void bc_num_mul(BcNum *a, BcNum *b, BcNum *c, size_t scale);
* @param c The return value.
* @param scale The current scale.
*/
void bc_num_div(BcNum *a, BcNum *b, BcNum *c, size_t scale);
void
bc_num_div(BcNum* a, BcNum* b, BcNum* c, size_t scale);
/**
* The modulus function.
@ -581,7 +598,8 @@ void bc_num_div(BcNum *a, BcNum *b, BcNum *c, size_t scale);
* @param c The return value.
* @param scale The current scale.
*/
void bc_num_mod(BcNum *a, BcNum *b, BcNum *c, size_t scale);
void
bc_num_mod(BcNum* a, BcNum* b, BcNum* c, size_t scale);
/**
* The power function.
@ -590,7 +608,8 @@ void bc_num_mod(BcNum *a, BcNum *b, BcNum *c, size_t scale);
* @param c The return value.
* @param scale The current scale.
*/
void bc_num_pow(BcNum *a, BcNum *b, BcNum *c, size_t scale);
void
bc_num_pow(BcNum* a, BcNum* b, BcNum* c, size_t scale);
#if BC_ENABLE_EXTRA_MATH
/**
@ -600,7 +619,8 @@ void bc_num_pow(BcNum *a, BcNum *b, BcNum *c, size_t scale);
* @param c The return value.
* @param scale The current scale.
*/
void bc_num_places(BcNum *a, BcNum *b, BcNum *c, size_t scale);
void
bc_num_places(BcNum* a, BcNum* b, BcNum* c, size_t scale);
/**
* The left shift function (<< operator). This is a BcNumBinaryOp function.
@ -609,7 +629,8 @@ void bc_num_places(BcNum *a, BcNum *b, BcNum *c, size_t scale);
* @param c The return value.
* @param scale The current scale.
*/
void bc_num_lshift(BcNum *a, BcNum *b, BcNum *c, size_t scale);
void
bc_num_lshift(BcNum* a, BcNum* b, BcNum* c, size_t scale);
/**
* The right shift function (>> operator). This is a BcNumBinaryOp function.
@ -618,7 +639,8 @@ void bc_num_lshift(BcNum *a, BcNum *b, BcNum *c, size_t scale);
* @param c The return value.
* @param scale The current scale.
*/
void bc_num_rshift(BcNum *a, BcNum *b, BcNum *c, size_t scale);
void
bc_num_rshift(BcNum* a, BcNum* b, BcNum* c, size_t scale);
#endif // BC_ENABLE_EXTRA_MATH
@ -628,7 +650,8 @@ void bc_num_rshift(BcNum *a, BcNum *b, BcNum *c, size_t scale);
* @param b The return value.
* @param scale The current scale.
*/
void bc_num_sqrt(BcNum *restrict a, BcNum *restrict b, size_t scale);
void
bc_num_sqrt(BcNum* restrict a, BcNum* restrict b, size_t scale);
/**
* Divsion and modulus together. This is a dc extension.
@ -638,7 +661,8 @@ void bc_num_sqrt(BcNum *restrict a, BcNum *restrict b, size_t scale);
* @param d The second return value (modulus).
* @param scale The current scale.
*/
void bc_num_divmod(BcNum *a, BcNum *b, BcNum *c, BcNum *d, size_t scale);
void
bc_num_divmod(BcNum* a, BcNum* b, BcNum* c, BcNum* d, size_t scale);
/**
* A function returning the required allocation size for an addition or a
@ -649,7 +673,8 @@ void bc_num_divmod(BcNum *a, BcNum *b, BcNum *c, BcNum *d, size_t scale);
* @return The size of allocation needed for the result of add or subtract
* with @a a, @a b, and @a scale.
*/
size_t bc_num_addReq(const BcNum* a, const BcNum* b, size_t scale);
size_t
bc_num_addReq(const BcNum* a, const BcNum* b, size_t scale);
/**
* A function returning the required allocation size for a multiplication. This
@ -660,7 +685,8 @@ size_t bc_num_addReq(const BcNum* a, const BcNum* b, size_t scale);
* @return The size of allocation needed for the result of multiplication
* with @a a, @a b, and @a scale.
*/
size_t bc_num_mulReq(const BcNum *a, const BcNum *b, size_t scale);
size_t
bc_num_mulReq(const BcNum* a, const BcNum* b, size_t scale);
/**
* A function returning the required allocation size for a division or modulus.
@ -671,7 +697,8 @@ size_t bc_num_mulReq(const BcNum *a, const BcNum *b, size_t scale);
* @return The size of allocation needed for the result of division or
* modulus with @a a, @a b, and @a scale.
*/
size_t bc_num_divReq(const BcNum *a, const BcNum *b, size_t scale);
size_t
bc_num_divReq(const BcNum* a, const BcNum* b, size_t scale);
/**
* A function returning the required allocation size for an exponentiation. This
@ -682,7 +709,8 @@ size_t bc_num_divReq(const BcNum *a, const BcNum *b, size_t scale);
* @return The size of allocation needed for the result of exponentiation
* with @a a, @a b, and @a scale.
*/
size_t bc_num_powReq(const BcNum *a, const BcNum *b, size_t scale);
size_t
bc_num_powReq(const BcNum* a, const BcNum* b, size_t scale);
#if BC_ENABLE_EXTRA_MATH
@ -695,7 +723,8 @@ size_t bc_num_powReq(const BcNum *a, const BcNum *b, size_t scale);
* @return The size of allocation needed for the result of places, left
* shift, or right shift with @a a, @a b, and @a scale.
*/
size_t bc_num_placesReq(const BcNum *a, const BcNum *b, size_t scale);
size_t
bc_num_placesReq(const BcNum* a, const BcNum* b, size_t scale);
#endif // BC_ENABLE_EXTRA_MATH
@ -705,7 +734,8 @@ size_t bc_num_placesReq(const BcNum *a, const BcNum *b, size_t scale);
* @param n The number to truncate.
* @param places The number of places to truncate @a n by.
*/
void bc_num_truncate(BcNum *restrict n, size_t places);
void
bc_num_truncate(BcNum* restrict n, size_t places);
/**
* Extend @a n *by* @a places decimal places. This only extends places *after*
@ -713,7 +743,8 @@ void bc_num_truncate(BcNum *restrict n, size_t places);
* @param n The number to truncate.
* @param places The number of places to extend @a n by.
*/
void bc_num_extend(BcNum *restrict n, size_t places);
void
bc_num_extend(BcNum* restrict n, size_t places);
/**
* Shifts @a n right by @a places decimal places. This is the workhorse of the
@ -722,7 +753,8 @@ void bc_num_extend(BcNum *restrict n, size_t places);
* @param n The number to shift right.
* @param places The number of decimal places to shift @a n right by.
*/
void bc_num_shiftRight(BcNum *restrict n, size_t places);
void
bc_num_shiftRight(BcNum* restrict n, size_t places);
/**
* Compare a and b and return the result of their comparison as an ssize_t.
@ -732,7 +764,8 @@ void bc_num_shiftRight(BcNum *restrict n, size_t places);
* @param b The second number.
* @return The result of the comparison.
*/
ssize_t bc_num_cmp(const BcNum *a, const BcNum *b);
ssize_t
bc_num_cmp(const BcNum* a, const BcNum* b);
/**
* Modular exponentiation.
@ -741,28 +774,30 @@ ssize_t bc_num_cmp(const BcNum *a, const BcNum *b);
* @param c The third parameter.
* @param d The return value.
*/
void bc_num_modexp(BcNum *a, BcNum *b, BcNum *c, BcNum *restrict d);
void
bc_num_modexp(BcNum* a, BcNum* b, BcNum* c, BcNum* restrict d);
/**
* Sets @a n to zero with a scale of zero.
* @param n The number to zero.
*/
void bc_num_zero(BcNum *restrict n);
void
bc_num_zero(BcNum* restrict n);
/**
* Sets @a n to one with a scale of zero.
* @param n The number to set to one.
*/
void bc_num_one(BcNum *restrict n);
void
bc_num_one(BcNum* restrict n);
/**
* An efficient function to compare @a n to zero.
* @param n The number to compare to zero.
* @return The result of the comparison.
*/
ssize_t bc_num_cmpZero(const BcNum *n);
#if !defined(NDEBUG) || BC_ENABLE_LIBRARY
ssize_t
bc_num_cmpZero(const BcNum* n);
/**
* Check a number string for validity and return true if it is, false otherwise.
@ -772,9 +807,8 @@ ssize_t bc_num_cmpZero(const BcNum *n);
* @param val The string to check.
* @return True if the string is a valid number, false otherwise.
*/
bool bc_num_strValid(const char *restrict val);
#endif // !defined(NDEBUG) || BC_ENABLE_LIBRARY
bool
bc_num_strValid(const char* restrict val);
/**
* Parses a number string into the number @a n according to @a base.
@ -782,7 +816,8 @@ bool bc_num_strValid(const char *restrict val);
* @param val The number string to parse.
* @param base The base to parse the number string by.
*/
void bc_num_parse(BcNum *restrict n, const char *restrict val, BcBigDig base);
void
bc_num_parse(BcNum* restrict n, const char* restrict val, BcBigDig base);
/**
* Prints the number @a n according to @a base.
@ -791,7 +826,8 @@ void bc_num_parse(BcNum *restrict n, const char *restrict val, BcBigDig base);
* @param newline True if a newline should be inserted at the end, false
* otherwise.
*/
void bc_num_print(BcNum *restrict n, BcBigDig base, bool newline);
void
bc_num_print(BcNum* restrict n, BcBigDig base, bool newline);
#if !BC_ENABLE_LIBRARY
@ -799,7 +835,8 @@ void bc_num_print(BcNum *restrict n, BcBigDig base, bool newline);
* Prints a number as a character stream.
* @param n The number to print as a character stream.
*/
void bc_num_stream(BcNum *restrict n);
void
bc_num_stream(BcNum* restrict n);
#endif // !BC_ENABLE_LIBRARY
@ -811,7 +848,8 @@ void bc_num_stream(BcNum *restrict n);
* @param name The label to print the number with.
* @param emptyline True if there should be an empty line after the number.
*/
void bc_num_printDebug(const BcNum *n, const char *name, bool emptyline);
void
bc_num_printDebug(const BcNum* n, const char* name, bool emptyline);
/**
* Print the limbs of @a n. This is a debug-only function.
@ -819,7 +857,8 @@ void bc_num_printDebug(const BcNum *n, const char *name, bool emptyline);
* @param len The length of the number.
* @param emptyline True if there should be an empty line after the number.
*/
void bc_num_printDigs(const BcDig* n, size_t len, bool emptyline);
void
bc_num_printDigs(const BcDig* n, size_t len, bool emptyline);
/**
* Print debug info about @a n along with its limbs.
@ -827,14 +866,16 @@ void bc_num_printDigs(const BcDig* n, size_t len, bool emptyline);
* @param name The label to print the number with.
* @param emptyline True if there should be an empty line after the number.
*/
void bc_num_printWithDigs(const BcNum *n, const char *name, bool emptyline);
void
bc_num_printWithDigs(const BcNum* n, const char* name, bool emptyline);
/**
* Dump debug info about a BcNum variable.
* @param varname The variable name.
* @param n The number.
*/
void bc_num_dump(const char *varname, const BcNum *n);
void
bc_num_dump(const char* varname, const BcNum* n);
#endif // BC_DEBUG_CODE
@ -842,7 +883,7 @@ void bc_num_dump(const char *varname, const BcNum *n);
extern const char bc_num_hex_digits[];
/// An array of powers of 10 for easy conversion from number of digits to
//powers.
/// powers.
extern const BcBigDig bc_num_pow10[BC_BASE_DIGS + 1];
/// A reference to a constant array that is the max of a BigDig.

24
contrib/bc/include/opt.h
View File

@ -44,10 +44,10 @@
#include <stdlib.h>
/// The data required to parse command-line arguments.
typedef struct BcOpt {
typedef struct BcOpt
{
/// The array of arguments.
char **argv;
char** argv;
/// The index of the current argument.
size_t optind;
@ -59,13 +59,13 @@ typedef struct BcOpt {
int subopt;
/// The option argument.
char *optarg;
char* optarg;
} BcOpt;
/// The types of arguments. This is specially adapted for bc.
typedef enum BcOptType {
typedef enum BcOptType
{
/// No argument required.
BC_OPT_NONE,
@ -84,10 +84,10 @@ typedef enum BcOptType {
} BcOptType;
/// A struct to hold const data for long options.
typedef struct BcOptLong {
typedef struct BcOptLong
{
/// The name of the option.
const char *name;
const char* name;
/// The type of the option.
BcOptType type;
@ -102,7 +102,8 @@ typedef struct BcOptLong {
* @param o The option data to initialize.
* @param argv The array of arguments.
*/
void bc_opt_init(BcOpt *o, char **argv);
void
bc_opt_init(BcOpt* o, char** argv);
/**
* Parse an option. This returns a value the same way getopt() and getopt_long()
@ -111,7 +112,8 @@ void bc_opt_init(BcOpt *o, char **argv);
* @param longopts The long options.
* @return A character for the parsed option, or -1 if done.
*/
int bc_opt_parse(BcOpt *o, const BcOptLong *longopts);
int
bc_opt_parse(BcOpt* o, const BcOptLong* longopts);
/**
* Returns true if the option is `--` and not a long option.

47
contrib/bc/include/parse.h
View File

@ -53,23 +53,24 @@
/// loops, while loops, and if statements. This is because POSIX requires that
/// certain operators are *only* used in those cases. It's whacked, but that's
/// how it is.
#define BC_PARSE_REL (UINTMAX_C(1)<<0)
#define BC_PARSE_REL (UINTMAX_C(1) << 0)
/// A flag that requires that the expression is valid for a print statement.
#define BC_PARSE_PRINT (UINTMAX_C(1)<<1)
#define BC_PARSE_PRINT (UINTMAX_C(1) << 1)
/// A flag that requires that the expression does *not* have any function call.
#define BC_PARSE_NOCALL (UINTMAX_C(1)<<2)
#define BC_PARSE_NOCALL (UINTMAX_C(1) << 2)
/// A flag that requires that the expression does *not* have a read() expression.
#define BC_PARSE_NOREAD (UINTMAX_C(1)<<3)
/// A flag that requires that the expression does *not* have a read()
/// expression.
#define BC_PARSE_NOREAD (UINTMAX_C(1) << 3)
/// A flag that *allows* (rather than requires) that an array appear in the
/// expression. This is mostly used as parameters in bc.
#define BC_PARSE_ARRAY (UINTMAX_C(1)<<4)
#define BC_PARSE_ARRAY (UINTMAX_C(1) << 4)
/// A flag that requires that the expression is not empty and returns a value.
#define BC_PARSE_NEEDVAL (UINTMAX_C(1)<<5)
#define BC_PARSE_NEEDVAL (UINTMAX_C(1) << 5)
/**
* Returns true if the parser has been initialized.
@ -154,8 +155,8 @@ typedef void (*BcParseParse)(struct BcParse* p);
typedef void (*BcParseExpr)(struct BcParse* p, uint8_t flags);
/// The parser struct.
typedef struct BcParse {
typedef struct BcParse
{
/// The lexer.
BcLex l;
@ -191,11 +192,11 @@ typedef struct BcParse {
#endif // BC_ENABLED
/// A reference to the program to grab the current function when necessary.
struct BcProgram *prog;
struct BcProgram* prog;
/// A reference to the current function. The function is what holds the
/// bytecode vector that the parser is filling.
BcFunc *func;
BcFunc* func;
/// The index of the function.
size_t fidx;
@ -214,40 +215,46 @@ typedef struct BcParse {
* @param prog A referenc to the program.
* @param func The index of the current function.
*/
void bc_parse_init(BcParse *p, struct BcProgram *prog, size_t func);
void
bc_parse_init(BcParse* p, struct BcProgram* prog, size_t func);
/**
* Frees a parser. This is not guarded by #ifndef NDEBUG because a separate
* parser is created at runtime to parse read() expressions and dc strings.
* @param p The parser to free.
*/
void bc_parse_free(BcParse *p);
void
bc_parse_free(BcParse* p);
/**
* Resets the parser. Resetting means erasing all state to the point that the
* parser would think it was just initialized.
* @param p The parser to reset.
*/
void bc_parse_reset(BcParse *p);
void
bc_parse_reset(BcParse* p);
/**
* Adds a string. See @a BcProgram in include/program.h for more details.
* @param p The parser that parsed the string.
*/
void bc_parse_addString(BcParse *p);
void
bc_parse_addString(BcParse* p);
/**
* Adds a number. See @a BcProgram in include/program.h for more details.
* @param p The parser that parsed the number.
*/
void bc_parse_number(BcParse *p);
void
bc_parse_number(BcParse* p);
/**
* Update the current function in the parser.
* @param p The parser.
* @param fidx The index of the new function.
*/
void bc_parse_updateFunc(BcParse *p, size_t fidx);
void
bc_parse_updateFunc(BcParse* p, size_t fidx);
/**
* Adds a new variable or array. See @a BcProgram in include/program.h for more
@ -256,7 +263,8 @@ void bc_parse_updateFunc(BcParse *p, size_t fidx);
* @param name The name of the variable or array to add.
* @param var True if the name is for a variable, false if it's for an array.
*/
void bc_parse_pushName(const BcParse* p, char *name, bool var);
void
bc_parse_pushName(const BcParse* p, char* name, bool var);
/**
* Sets the text that the parser will parse.
@ -266,7 +274,8 @@ void bc_parse_pushName(const BcParse* p, char *name, bool var);
* @param is_exprs True if the text is from command-line expressions, false
* otherwise.
*/
void bc_parse_text(BcParse *p, const char *text, bool is_stdin, bool is_exprs);
void
bc_parse_text(BcParse* p, const char* text, bool is_stdin, bool is_exprs);
// References to const 0 and 1 strings for special cases. bc and dc have
// specific instructions for 0 and 1 because they pop up so often and (in the

1065
contrib/bc/include/program.h
View File

File diff suppressed because it is too large Load Diff

48
contrib/bc/include/rand.h
View File

@ -65,7 +65,7 @@
* @param ptr A void ptr to some data that will help generate the random ulong.
* @return The random ulong.
*/
typedef ulong (*BcRandUlong)(void *ptr);
typedef ulong (*BcRandUlong)(void* ptr);
#if BC_LONG_BIT >= 64
@ -178,8 +178,8 @@ typedef __uint128_t BcRandState;
#else // BC_RAND_BUILTIN
/// A typedef for the PCG state.
typedef struct BcRandState {
typedef struct BcRandState
{
/// The low bits.
uint_fast64_t lo;
@ -241,7 +241,10 @@ typedef struct BcRandState {
* @param l The low 64 bits.
* @return The constant built from @a h and @a l.
*/
#define BC_RAND_CONSTANT(h, l) { .lo = (l), .hi = (h) }
#define BC_RAND_CONSTANT(h, l) \
{ \
.lo = (l), .hi = (h) \
}
/**
* Truncates a PCG state to the number of bits in a random integer.
@ -272,7 +275,7 @@ typedef struct BcRandState {
* @param n The integer to truncate.
* @return The bottom 32 bits of @a n.
*/
#define BC_RAND_TRUNC32(n) ((n) & BC_RAND_BOTTOM32)
#define BC_RAND_TRUNC32(n) ((n) & (BC_RAND_BOTTOM32))
/**
* Returns the second 32 bits of @a n.
@ -419,8 +422,8 @@ typedef uint_fast64_t BcRandState;
#define BC_RAND_SRAND_BITS ((1 << CHAR_BIT) - 1)
/// The actual RNG data. These are the actual PRNG's.
typedef struct BcRNGData {
typedef struct BcRNGData
{
/// The state.
BcRandState state;
@ -431,8 +434,8 @@ typedef struct BcRNGData {
/// The public PRNG. This is just a stack of PRNG's to maintain the globals
/// stack illusion.
typedef struct BcRNG {
typedef struct BcRNG
{
/// The stack of PRNG's.
BcVec v;
@ -442,7 +445,8 @@ typedef struct BcRNG {
* Initializes a BcRNG.
* @param r The BcRNG to initialize.
*/
void bc_rand_init(BcRNG *r);
void
bc_rand_init(BcRNG* r);
#if BC_RAND_USE_FREE
@ -451,7 +455,8 @@ void bc_rand_init(BcRNG *r);
* exit.
* @param r The BcRNG to free.
*/
void bc_rand_free(BcRNG *r);
void
bc_rand_free(BcRNG* r);
#endif // BC_RAND_USE_FREE
@ -460,7 +465,8 @@ void bc_rand_free(BcRNG *r);
* @param r The PRNG.
* @return A random integer.
*/
BcRand bc_rand_int(BcRNG *r);
BcRand
bc_rand_int(BcRNG* r);
/**
* Returns a random integer from the PRNG bounded by @a bound. Bias is
@ -469,7 +475,8 @@ BcRand bc_rand_int(BcRNG *r);
* @param bound The bound for the random integer.
* @return A bounded random integer.
*/
BcRand bc_rand_bounded(BcRNG *r, BcRand bound);
BcRand
bc_rand_bounded(BcRNG* r, BcRand bound);
/**
* Seed the PRNG with the state in two parts and the increment in two parts.
@ -479,13 +486,15 @@ BcRand bc_rand_bounded(BcRNG *r, BcRand bound);
* @param inc1 The first part of the increment.
* @param inc2 The second part of the increment.
*/
void bc_rand_seed(BcRNG *r, ulong state1, ulong state2, ulong inc1, ulong inc2);
void
bc_rand_seed(BcRNG* r, ulong state1, ulong state2, ulong inc1, ulong inc2);
/**
* Pushes a new PRNG onto the PRNG stack.
* @param r The PRNG.
*/
void bc_rand_push(BcRNG *r);
void
bc_rand_push(BcRNG* r);
/**
* Pops one or all but one items off of the PRNG stack.
@ -493,7 +502,8 @@ void bc_rand_push(BcRNG *r);
* @param reset True if all but one PRNG should be popped off the stack, false
* if only one should be popped.
*/
void bc_rand_pop(BcRNG *r, bool reset);
void
bc_rand_pop(BcRNG* r, bool reset);
/**
* Returns, via pointers, the state of the PRNG in pieces.
@ -503,13 +513,15 @@ void bc_rand_pop(BcRNG *r, bool reset);
* @param i1 The return value for the first part of the increment.
* @param i2 The return value for the second part of the increment.
*/
void bc_rand_getRands(BcRNG *r, BcRand *s1, BcRand *s2, BcRand *i1, BcRand *i2);
void
bc_rand_getRands(BcRNG* r, BcRand* s1, BcRand* s2, BcRand* i1, BcRand* i2);
/**
* Seed the PRNG with random data.
* @param rng The PRNG.
*/
void bc_rand_srand(BcRNGData *rng);
void
bc_rand_srand(BcRNGData* rng);
/// A reference to a constant multiplier.
extern const BcRandState bc_rand_multiplier;

12
contrib/bc/include/read.h
View File

@ -53,14 +53,16 @@
* @param vec The vector to put the stdin data into.
* @param prompt The prompt to print, if desired.
*/
BcStatus bc_read_line(BcVec *vec, const char *prompt);
BcStatus
bc_read_line(BcVec* vec, const char* prompt);
/**
* Read a file and return a buffer with the data. The buffer must be freed by
* the caller.
* @param path The path to the file to read.
*/
char* bc_read_file(const char *path);
char*
bc_read_file(const char* path);
/**
* Helper function for reading characters from stdin. This takes care of a bunch
@ -69,7 +71,8 @@ char* bc_read_file(const char *path);
* @param vec The vec to put the stdin into.
* @param prompt The prompt to print, if desired.
*/
BcStatus bc_read_chars(BcVec *vec, const char *prompt);
BcStatus
bc_read_chars(BcVec* vec, const char* prompt);
/**
* Read a line from buf into vec.
@ -77,6 +80,7 @@ BcStatus bc_read_chars(BcVec *vec, const char *prompt);
* @param buf The buffer to read from.
* @param buf_len The length of the buffer.
*/
bool bc_read_buf(BcVec *vec, char *buf, size_t *buf_len);
bool
bc_read_buf(BcVec* vec, char* buf, size_t* buf_len);
#endif // BC_READ_H

113
contrib/bc/include/status.h
View File

@ -45,6 +45,13 @@
#endif // __OpenBSD__
#endif // BC_TEST_OPENBSD
// This is used by configure.sh to test for FreeBSD.
#ifdef BC_TEST_FREEBSD
#ifdef __FreeBSD__
#error On FreeBSD with _POSIX_C_SOURCE
#endif // __FreeBSD__
#endif // BC_TEST_FREEBSD
#ifndef BC_ENABLED
#define BC_ENABLED (1)
#endif // BC_ENABLED
@ -295,8 +302,8 @@
/// Statuses, which mark either which category of error happened, or some other
/// status that matters.
typedef enum BcStatus {
typedef enum BcStatus
{
/// Normal status.
BC_STATUS_SUCCESS = 0,
@ -321,8 +328,8 @@ typedef enum BcStatus {
} BcStatus;
/// Errors, which are more specific errors.
typedef enum BcErr {
typedef enum BcErr
{
// Math errors.
/// Negative number used when not allowed.
@ -565,13 +572,23 @@ typedef enum BcErr {
/// bc, and they *must* have signals locked. Other functions are expected to
/// *not* have signals locked, for reasons. So this is a pre-built assert
/// (no-op in non-debug mode) that check that signals are locked.
#define BC_SIG_ASSERT_LOCKED do { assert(vm.sig_lock); } while (0)
#define BC_SIG_ASSERT_LOCKED \
do \
{ \
assert(vm.sig_lock); \
} \
while (0)
/// Assert that signals are unlocked. There are non-async-signal-safe functions
/// in bc, and they *must* have signals locked. Other functions are expected to
/// *not* have signals locked, for reasons. So this is a pre-built assert
/// (no-op in non-debug mode) that check that signals are unlocked.
#define BC_SIG_ASSERT_NOT_LOCKED do { assert(vm.sig_lock == 0); } while (0)
#define BC_SIG_ASSERT_NOT_LOCKED \
do \
{ \
assert(vm.sig_lock == 0); \
} \
while (0)
#else // NDEBUG
@ -591,35 +608,43 @@ typedef enum BcErr {
/// Locks signals.
#define BC_SIG_LOCK \
do { \
do \
{ \
BC_SIG_ASSERT_NOT_LOCKED; \
vm.sig_lock = 1; \
} while (0)
} \
while (0)
/// Unlocks signals. If a signal happened, then this will cause a jump.
#define BC_SIG_UNLOCK \
do { \
do \
{ \
BC_SIG_ASSERT_LOCKED; \
vm.sig_lock = 0; \
if (vm.sig) BC_JMP; \
} while (0)
} \
while (0)
/// Locks signals, regardless of if they are already locked. This is really only
/// used after labels that longjmp() goes to after the jump because the cleanup
/// code must have signals locked, and BC_LONGJMP_CONT will unlock signals if it
/// doesn't jump.
#define BC_SIG_MAYLOCK \
do { \
do \
{ \
vm.sig_lock = 1; \
} while (0)
} \
while (0)
/// Unlocks signals, regardless of if they were already unlocked. If a signal
/// happened, then this will cause a jump.
#define BC_SIG_MAYUNLOCK \
do { \
do \
{ \
vm.sig_lock = 0; \
if (vm.sig) BC_JMP; \
} while (0)
} \
while (0)
/*
* Locks signals, but stores the old lock state, to be restored later by
@ -627,20 +652,24 @@ typedef enum BcErr {
* @param v The variable to store the old lock state to.
*/
#define BC_SIG_TRYLOCK(v) \
do { \
do \
{ \
v = vm.sig_lock; \
vm.sig_lock = 1; \
} while (0)
} \
while (0)
/* Restores the previous state of a signal lock, and if it is now unlocked,
* initiates an exception/jump.
* @param v The old lock state.
*/
#define BC_SIG_TRYUNLOCK(v) \
do { \
do \
{ \
vm.sig_lock = (v); \
if (!(v) && vm.sig) BC_JMP; \
} while (0)
} \
while (0)
/**
* Sets a jump, and sets it up as well so that if a longjmp() happens, bc will
@ -653,17 +682,20 @@ typedef enum BcErr {
* param l The label to jump to on a longjmp().
*/
#define BC_SETJMP(l) \
do { \
do \
{ \
sigjmp_buf sjb; \
BC_SIG_LOCK; \
bc_vec_grow(&vm.jmp_bufs, 1); \
if (sigsetjmp(sjb, 0)) { \
if (sigsetjmp(sjb, 0)) \
{ \
assert(BC_SIG_EXC); \
goto l; \
} \
bc_vec_push(&vm.jmp_bufs, &sjb); \
BC_SIG_UNLOCK; \
} while (0)
} \
while (0)
/**
* Sets a jump like BC_SETJMP, but unlike BC_SETJMP, it assumes signals are
@ -673,46 +705,55 @@ typedef enum BcErr {
* param l The label to jump to on a longjmp().
*/
#define BC_SETJMP_LOCKED(l) \
do { \
do \
{ \
sigjmp_buf sjb; \
BC_SIG_ASSERT_LOCKED; \
if (sigsetjmp(sjb, 0)) { \
if (sigsetjmp(sjb, 0)) \
{ \
assert(BC_SIG_EXC); \
goto l; \
} \
bc_vec_push(&vm.jmp_bufs, &sjb); \
} while (0)
} \
while (0)
/// Used after cleanup labels set by BC_SETJMP and BC_SETJMP_LOCKED to jump to
/// the next place. This is what continues the stack unwinding. This basically
/// copies BC_SIG_UNLOCK into itself, but that is because its condition for
/// jumping is BC_SIG_EXC, not just that a signal happened.
#define BC_LONGJMP_CONT \
do { \
do \
{ \
BC_SIG_ASSERT_LOCKED; \
if (!vm.sig_pop) bc_vec_pop(&vm.jmp_bufs); \
vm.sig_lock = 0; \
if (BC_SIG_EXC) BC_JMP; \
} while (0)
} \
while (0)
/// Unsets a jump. It always assumes signals are locked. This basically just
/// pops a jmp_buf off of the stack of jmp_bufs, and since the jump mechanism
/// always jumps to the location at the top of the stack, this effectively
/// undoes a setjmp().
#define BC_UNSETJMP \
do { \
do \
{ \
BC_SIG_ASSERT_LOCKED; \
bc_vec_pop(&vm.jmp_bufs); \
} while (0)
} \
while (0)
/// Stops a stack unwinding. Technically, a stack unwinding needs to be done
/// manually, but it will always be done unless certain flags are cleared. This
/// clears the flags.
#define BC_LONGJMP_STOP \
do { \
do \
{ \
vm.sig_pop = 0; \
vm.sig = 0; \
} while (0)
} \
while (0)
// Various convenience macros for calling the bc's error handling routine.
#if BC_ENABLE_LIBRARY
@ -773,7 +814,8 @@ typedef enum BcErr {
// for easy marking of where functions are entered and exited.
#if BC_DEBUG_CODE
#define BC_FUNC_ENTER \
do { \
do \
{ \
size_t bc_func_enter_i; \
for (bc_func_enter_i = 0; bc_func_enter_i < vm.func_depth; \
++bc_func_enter_i) \
@ -783,10 +825,12 @@ typedef enum BcErr {
vm.func_depth += 1; \
bc_file_printf(&vm.ferr, "Entering %s\n", __func__); \
bc_file_flush(&vm.ferr, bc_flush_none); \
} while (0);
} \
while (0);
#define BC_FUNC_EXIT \
do { \
do \
{ \
size_t bc_func_enter_i; \
vm.func_depth -= 1; \
for (bc_func_enter_i = 0; bc_func_enter_i < vm.func_depth; \
@ -796,7 +840,8 @@ typedef enum BcErr {
} \
bc_file_printf(&vm.ferr, "Leaving %s\n", __func__); \
bc_file_flush(&vm.ferr, bc_flush_none); \
} while (0);
} \
while (0);
#else // BC_DEBUG_CODE
#define BC_FUNC_ENTER
#define BC_FUNC_EXIT

106
contrib/bc/include/vector.h
View File

@ -47,7 +47,7 @@
/// The starting capacity for vectors. This is based on the minimum allocation
/// for 64-bit systems.
#define BC_VEC_START_CAP (UINTMAX_C(1)<<5)
#define BC_VEC_START_CAP (UINTMAX_C(1) << 5)
/// An alias.
typedef unsigned char uchar;
@ -57,7 +57,7 @@ typedef unsigned char uchar;
* to free the memory they own.
* @param ptr Pointer to the data to free.
*/
typedef void (*BcVecFree)(void *ptr);
typedef void (*BcVecFree)(void* ptr);
// Forward declaration.
struct BcId;
@ -75,8 +75,8 @@ typedef uint16_t BcSize;
#endif // BC_LONG_BIT >= 64
/// An enum of all of the destructors. We use an enum to save space.
typedef enum BcDtorType {
typedef enum BcDtorType
{
/// No destructor needed.
BC_DTOR_NONE,
@ -120,11 +120,11 @@ typedef enum BcDtorType {
} BcDtorType;
/// The actual vector struct.
typedef struct BcVec {
typedef struct BcVec
{
/// The vector array itself. This uses a char* because it is compatible with
/// pointers of all other types, and I can do pointer arithmetic on it.
char *restrict v;
char* restrict v;
/// The length of the vector, which is how many items actually exist.
size_t len;
@ -147,7 +147,8 @@ typedef struct BcVec {
* @param esize The size of the elements, as returned by sizeof().
* @param dtor The destructor of the elements, as a BcDtorType enum.
*/
void bc_vec_init(BcVec *restrict v, size_t esize, BcDtorType dtor);
void
bc_vec_init(BcVec* restrict v, size_t esize, BcDtorType dtor);
/**
* Expands the vector to have a capacity of @a req items, if it doesn't have
@ -155,14 +156,16 @@ void bc_vec_init(BcVec *restrict v, size_t esize, BcDtorType dtor);
* @param v The vector to expand.
* @param req The requested capacity.
*/
void bc_vec_expand(BcVec *restrict v, size_t req);
void
bc_vec_expand(BcVec* restrict v, size_t req);
/**
* Grow a vector by at least @a n elements.
* @param v The vector to grow.
* @param n The number of elements to grow the vector by.
*/
void bc_vec_grow(BcVec *restrict v, size_t n);
void
bc_vec_grow(BcVec* restrict v, size_t n);
/**
* Pops @a n items off the back of the vector. The vector must have at least
@ -170,7 +173,8 @@ void bc_vec_grow(BcVec *restrict v, size_t n);
* @param v The vector to pop off of.
* @param n The number of elements to pop off.
*/
void bc_vec_npop(BcVec *restrict v, size_t n);
void
bc_vec_npop(BcVec* restrict v, size_t n);
/**
* Pops @a n items, starting at index @a idx, off the vector. The vector must
@ -180,7 +184,8 @@ void bc_vec_npop(BcVec *restrict v, size_t n);
* @param n The number of elements to pop off.
* @param idx The index to start popping at.
*/
void bc_vec_npopAt(BcVec *restrict v, size_t n, size_t idx);
void
bc_vec_npopAt(BcVec* restrict v, size_t n, size_t idx);
/**
* Pushes one item on the back of the vector. It does a memcpy(), but it assumes
@ -188,7 +193,8 @@ void bc_vec_npopAt(BcVec *restrict v, size_t n, size_t idx);
* @param v The vector to push onto.
* @param data A pointer to the data to push.
*/
void bc_vec_push(BcVec *restrict v, const void *data);
void
bc_vec_push(BcVec* restrict v, const void* data);
/**
* Pushes @a n items on the back of the vector. It does a memcpy(), but it
@ -196,7 +202,8 @@ void bc_vec_push(BcVec *restrict v, const void *data);
* @param v The vector to push onto.
* @param data A pointer to the elements of data to push.
*/
void bc_vec_npush(BcVec *restrict v, size_t n, const void *data);
void
bc_vec_npush(BcVec* restrict v, size_t n, const void* data);
/**
* Push an empty element and return a pointer to it. This is done as an
@ -205,7 +212,8 @@ void bc_vec_npush(BcVec *restrict v, size_t n, const void *data);
* @param v The vector to push onto.
* @return A pointer to the newly-pushed element.
*/
void* bc_vec_pushEmpty(BcVec *restrict v);
void*
bc_vec_pushEmpty(BcVec* restrict v);
/**
* Pushes a byte onto a bytecode vector. This is a convenience function for the
@ -213,7 +221,8 @@ void* bc_vec_pushEmpty(BcVec *restrict v);
* @param v The vector to push onto.
* @param data The byte to push.
*/
void bc_vec_pushByte(BcVec *restrict v, uchar data);
void
bc_vec_pushByte(BcVec* restrict v, uchar data);
/**
* Pushes and index onto a bytecode vector. The vector must be a bytecode
@ -222,7 +231,8 @@ void bc_vec_pushByte(BcVec *restrict v, uchar data);
* @param v The vector to push onto.
* @param idx The index to push.
*/
void bc_vec_pushIndex(BcVec *restrict v, size_t idx);
void
bc_vec_pushIndex(BcVec* restrict v, size_t idx);
/**
* Push an item onto the vector at a certain index. The index must be valid
@ -233,7 +243,8 @@ void bc_vec_pushIndex(BcVec *restrict v, size_t idx);
* @param data A pointer to the data to push.
* @param idx The index to push at.
*/
void bc_vec_pushAt(BcVec *restrict v, const void *data, size_t idx);
void
bc_vec_pushAt(BcVec* restrict v, const void* data, size_t idx);
/**
* Empties the vector and sets it to the string. The vector must be a valid
@ -243,7 +254,8 @@ void bc_vec_pushAt(BcVec *restrict v, const void *data, size_t idx);
* of the string, but must never be more.
* @param str The string to push.
*/
void bc_vec_string(BcVec *restrict v, size_t len, const char *restrict str);
void
bc_vec_string(BcVec* restrict v, size_t len, const char* restrict str);
/**
* Appends the string to the end of the vector, which must be holding a string
@ -251,13 +263,15 @@ void bc_vec_string(BcVec *restrict v, size_t len, const char *restrict str);
* @param v The vector to append to.
* @param str The string to append (by copying).
*/
void bc_vec_concat(BcVec *restrict v, const char *restrict str);
void
bc_vec_concat(BcVec* restrict v, const char* restrict str);
/**
* Empties a vector and pushes a nul-byte at the first index. The vector must be
* a char vector.
*/
void bc_vec_empty(BcVec *restrict v);
void
bc_vec_empty(BcVec* restrict v);
#if BC_ENABLE_HISTORY
@ -268,7 +282,8 @@ void bc_vec_empty(BcVec *restrict v);
* @param idx The index of the item to replace.
* @param data The data to replace the item with.
*/
void bc_vec_replaceAt(BcVec *restrict v, size_t idx, const void *data);
void
bc_vec_replaceAt(BcVec* restrict v, size_t idx, const void* data);
#endif // BC_ENABLE_HISTORY
@ -279,7 +294,8 @@ void bc_vec_replaceAt(BcVec *restrict v, size_t idx, const void *data);
* @param idx The index to the item to get a pointer to.
* @return A pointer to the item at @a idx.
*/
void* bc_vec_item(const BcVec *restrict v, size_t idx);
void*
bc_vec_item(const BcVec* restrict v, size_t idx);
/**
* Returns a pointer to the item in the vector at the index, reversed. This is
@ -288,19 +304,22 @@ void* bc_vec_item(const BcVec *restrict v, size_t idx);
* @param idx The index to the item to get a pointer to.
* @return A pointer to the item at len - @a idx - 1.
*/
void* bc_vec_item_rev(const BcVec *restrict v, size_t idx);
void*
bc_vec_item_rev(const BcVec* restrict v, size_t idx);
/**
* Zeros a vector. The vector must not be allocated.
* @param v The vector to clear.
*/
void bc_vec_clear(BcVec *restrict v);
void
bc_vec_clear(BcVec* restrict v);
/**
* Frees a vector and its elements. This is a destructor.
* @param vec A vector as a void pointer.
*/
void bc_vec_free(void *vec);
void
bc_vec_free(void* vec);
/**
* Attempts to insert an item into a map and returns true if it succeeded, false
@ -313,8 +332,9 @@ void bc_vec_free(void *vec);
* in the map.
* @return True if the item was inserted, false if the item already exists.
*/
bool bc_map_insert(BcVec *restrict v, const char *name,
size_t idx, size_t *restrict i);
bool
bc_map_insert(BcVec* restrict v, const char* name, size_t idx,
size_t* restrict i);
/**
* Returns the index of the item with @a name in the map, or BC_VEC_INVALID_IDX
@ -324,7 +344,8 @@ bool bc_map_insert(BcVec *restrict v, const char *name,
* @return The index in the map of the item with @a name, or
* BC_VEC_INVALID_IDX if the item does not exist.
*/
size_t bc_map_index(const BcVec *restrict v, const char *name);
size_t
bc_map_index(const BcVec* restrict v, const char* name);
#if DC_ENABLED
@ -334,7 +355,8 @@ size_t bc_map_index(const BcVec *restrict v, const char *name);
* @param idx The index.
* @return The name of the item at @a idx.
*/
const char* bc_map_name(const BcVec *restrict v, size_t idx);
const char*
bc_map_name(const BcVec* restrict v, size_t idx);
#endif // DC_ENABLED
@ -372,10 +394,10 @@ extern const BcVecFree bc_vec_dtors[];
#define BC_SLAB_SIZE (4096)
/// A slab for allocating strings.
typedef struct BcSlab {
typedef struct BcSlab
{
/// The actual allocation.
char *s;
char* s;
/// How many bytes of the slab are taken.
size_t len;
@ -386,13 +408,15 @@ typedef struct BcSlab {
* Frees a slab. This is a destructor.
* @param slab The slab as a void pointer.
*/
void bc_slab_free(void *slab);
void
bc_slab_free(void* slab);
/**
* Initializes a slab vector.
* @param v The vector to initialize.
*/
void bc_slabvec_init(BcVec *restrict v);
void
bc_slabvec_init(BcVec* restrict v);
/**
* Duplicates the string using slabs in the slab vector.
@ -400,7 +424,8 @@ void bc_slabvec_init(BcVec *restrict v);
* @param str The string to duplicate.
* @return A pointer to the duplicated string, owned by the slab vector.
*/
char* bc_slabvec_strdup(BcVec *restrict v, const char *str);
char*
bc_slabvec_strdup(BcVec* restrict v, const char* str);
#if BC_ENABLED
@ -408,7 +433,8 @@ char* bc_slabvec_strdup(BcVec *restrict v, const char *str);
* Undoes the last allocation on the slab vector. This allows bc to have a
* heap-based stacks for strings. This is used by the bc parser.
*/
void bc_slabvec_undo(BcVec *restrict v, size_t len);
void
bc_slabvec_undo(BcVec* restrict v, size_t len);
#endif // BC_ENABLED
@ -417,7 +443,8 @@ void bc_slabvec_undo(BcVec *restrict v, size_t len);
* first slab.
* @param v The slab vector to clear.
*/
void bc_slabvec_clear(BcVec *restrict v);
void
bc_slabvec_clear(BcVec* restrict v);
#if BC_DEBUG_CODE
@ -425,7 +452,8 @@ void bc_slabvec_clear(BcVec *restrict v);
* Prints all of the items in a slab vector, in order.
* @param v The vector whose items will be printed.
*/
void bc_slabvec_print(BcVec *v, const char *func);
void
bc_slabvec_print(BcVec* v, const char* func);
#endif // BC_DEBUG_CODE

2
contrib/bc/include/version.h
View File

@ -37,6 +37,6 @@
#define BC_VERSION_H
/// The current version.
#define VERSION 5.2.5
#define VERSION 5.3.1
#endif // BC_VERSION_H

155
contrib/bc/include/vm.h
View File

@ -132,52 +132,52 @@
#if DC_ENABLED
/// The flag for the extended register option.
#define DC_FLAG_X (UINTMAX_C(1)<<0)
#define DC_FLAG_X (UINTMAX_C(1) << 0)
#endif // DC_ENABLED
#if BC_ENABLED
/// The flag for the POSIX warning option.
#define BC_FLAG_W (UINTMAX_C(1)<<1)
#define BC_FLAG_W (UINTMAX_C(1) << 1)
/// The flag for the POSIX error option.
#define BC_FLAG_S (UINTMAX_C(1)<<2)
#define BC_FLAG_S (UINTMAX_C(1) << 2)
/// The flag for the math library option.
#define BC_FLAG_L (UINTMAX_C(1)<<3)
#define BC_FLAG_L (UINTMAX_C(1) << 3)
/// The flag for the global stacks option.
#define BC_FLAG_G (UINTMAX_C(1)<<4)
#define BC_FLAG_G (UINTMAX_C(1) << 4)
#endif // BC_ENABLED
/// The flag for quiet, though this one is reversed; the option clears the flag.
#define BC_FLAG_Q (UINTMAX_C(1)<<5)
#define BC_FLAG_Q (UINTMAX_C(1) << 5)
/// The flag for interactive.
#define BC_FLAG_I (UINTMAX_C(1)<<6)
#define BC_FLAG_I (UINTMAX_C(1) << 6)
/// The flag for prompt. This is also reversed; the option clears the flag.
#define BC_FLAG_P (UINTMAX_C(1)<<7)
#define BC_FLAG_P (UINTMAX_C(1) << 7)
/// The flag for read prompt. This is also reversed; the option clears the flag.
#define BC_FLAG_R (UINTMAX_C(1)<<8)
#define BC_FLAG_R (UINTMAX_C(1) << 8)
/// The flag for a leading zero.
#define BC_FLAG_Z (UINTMAX_C(1)<<9)
#define BC_FLAG_Z (UINTMAX_C(1) << 9)
/// The flag for stdin being a TTY.
#define BC_FLAG_TTYIN (UINTMAX_C(1)<<10)
#define BC_FLAG_TTYIN (UINTMAX_C(1) << 10)
/// The flag for TTY mode.
#define BC_FLAG_TTY (UINTMAX_C(1)<<11)
#define BC_FLAG_TTY (UINTMAX_C(1) << 11)
/// The flag for reset on SIGINT.
#define BC_FLAG_SIGINT (UINTMAX_C(1)<<12)
#define BC_FLAG_SIGINT (UINTMAX_C(1) << 12)
/// The flag for exiting with expressions.
#define BC_FLAG_EXPR_EXIT (UINTMAX_C(1)<<13)
#define BC_FLAG_EXPR_EXIT (UINTMAX_C(1) << 13)
/// A convenience macro for getting the TTYIN flag.
#define BC_TTYIN (vm.flags & BC_FLAG_TTYIN)
@ -320,18 +320,30 @@
/// Returns the max number of variables that is allowed.
#define BC_MAX_VARS ((ulong) (SIZE_MAX - 1))
#if BC_ENABLE_LINE_LIB
/// The size of the global buffer.
#define BC_VM_BUF_SIZE (1<<12)
#define BC_VM_BUF_SIZE (1 << 10)
/// The amount of the global buffer allocated to stdin.
#define BC_VM_STDIN_BUF_SIZE (BC_VM_BUF_SIZE - 1)
#else // BC_ENABLE_LINE_LIB
/// The size of the global buffer.
#define BC_VM_BUF_SIZE (1 << 12)
/// The amount of the global buffer allocated to stdout.
#define BC_VM_STDOUT_BUF_SIZE (1<<11)
#define BC_VM_STDOUT_BUF_SIZE (1 << 11)
/// The amount of the global buffer allocated to stderr.
#define BC_VM_STDERR_BUF_SIZE (1<<10)
#define BC_VM_STDERR_BUF_SIZE (1 << 10)
/// The amount of the global buffer allocated to stdin.
#define BC_VM_STDIN_BUF_SIZE (BC_VM_STDERR_BUF_SIZE - 1)
#endif // BC_ENABLE_LINE_LIB
/// The max number of temporary BcNums that can be kept.
#define BC_VM_MAX_TEMPS (1 << 9)
@ -360,8 +372,8 @@
/// The global vm struct. This holds all of the global data besides the file
/// buffers.
typedef struct BcVm {
typedef struct BcVm
{
/// The current status. This is volatile sig_atomic_t because it is also
/// used in the signal handler. See the development manual
/// (manuals/development.md#async-signal-safe-signal-handling) for more
@ -443,7 +455,7 @@ typedef struct BcVm {
const char* file;
/// The message printed when SIGINT happens.
const char *sigmsg;
const char* sigmsg;
#endif // !BC_ENABLE_LIBRARY
@ -515,10 +527,10 @@ typedef struct BcVm {
/// The name of the calculator under use. This is used by BC_IS_BC and
/// BC_IS_DC.
const char *name;
const char* name;
/// The help text for the calculator.
const char *help;
const char* help;
#if BC_ENABLE_HISTORY
@ -537,17 +549,17 @@ typedef struct BcVm {
BcParseExpr expr;
/// The text to display to label functions in error messages.
const char *func_header;
const char* func_header;
/// The names of the categories of errors.
const char *err_ids[BC_ERR_IDX_NELEMS + BC_ENABLED];
const char* err_ids[BC_ERR_IDX_NELEMS + BC_ENABLED];
/// The messages for each error.
const char *err_msgs[BC_ERR_NELEMS];
const char* err_msgs[BC_ERR_NELEMS];
#if BC_ENABLE_NLS
/// The locale.
const char *locale;
const char* locale;
#endif // BC_ENABLE_NLS
#endif // !BC_ENABLE_LIBRARY
@ -568,7 +580,7 @@ typedef struct BcVm {
/// A buffer of environment arguments. This is the actual value of the
/// environment variable.
char *env_args_buffer;
char* env_args_buffer;
/// A vector for environment arguments after parsing.
BcVec env_args;
@ -615,7 +627,7 @@ typedef struct BcVm {
#endif // BC_ENABLE_NLS
/// A pointer to the stdin buffer.
char *buf;
char* buf;
/// The number of items in the input buffer.
size_t buf_len;
@ -653,44 +665,51 @@ typedef struct BcVm {
* Print the copyright banner and help if it's non-NULL.
* @param help The help message to print if it's non-NULL.
*/
void bc_vm_info(const char* const help);
void
bc_vm_info(const char* const help);
/**
* The entrance point for bc/dc together.
* @param argc The count of arguments.
* @param argv The argument array.
*/
void bc_vm_boot(int argc, char *argv[]);
void
bc_vm_boot(int argc, char* argv[]);
/**
* Initializes some of the BcVm global. This is separate to make things easier
* on the library code.
*/
void bc_vm_init(void);
void
bc_vm_init(void);
/**
* Frees the BcVm global.
*/
void bc_vm_shutdown(void);
void
bc_vm_shutdown(void);
/**
* Add a temp to the temp array.
* @param num The BcDig array to add to the temp array.
*/
void bc_vm_addTemp(BcDig *num);
void
bc_vm_addTemp(BcDig* num);
/**
* Dish out a temp, or NULL if there are none.
* @return A temp, or NULL if none exist.
*/
BcDig* bc_vm_takeTemp(void);
BcDig*
bc_vm_takeTemp(void);
/**
* Frees all temporaries.
*/
void bc_vm_freeTemps(void);
void
bc_vm_freeTemps(void);
#if !BC_ENABLE_HISTORY
#if !BC_ENABLE_HISTORY || BC_ENABLE_LINE_LIB
/**
* Erases the flush argument if history does not exist because it does not
@ -698,20 +717,22 @@ void bc_vm_freeTemps(void);
*/
#define bc_vm_putchar(c, t) bc_vm_putchar(c)
#endif // !BC_ENABLE_HISTORY
#endif // !BC_ENABLE_HISTORY || BC_ENABLE_LINE_LIB
/**
* Print to stdout with limited formating.
* @param fmt The format string.
*/
void bc_vm_printf(const char *fmt, ...);
void
bc_vm_printf(const char* fmt, ...);
/**
* Puts a char into the stdout buffer.
* @param c The character to put on the stdout buffer.
* @param type The flush type.
*/
void bc_vm_putchar(int c, BcFlushType type);
void
bc_vm_putchar(int c, BcFlushType type);
/**
* Multiplies @a n and @a size and throws an allocation error if overflow
@ -720,7 +741,8 @@ void bc_vm_putchar(int c, BcFlushType type);
* @param size The size of each element.
* @return The product of @a n and @a size.
*/
size_t bc_vm_arraySize(size_t n, size_t size);
size_t
bc_vm_arraySize(size_t n, size_t size);
/**
* Adds @a a and @a b and throws an error if overflow occurs.
@ -728,14 +750,16 @@ size_t bc_vm_arraySize(size_t n, size_t size);
* @param b The second operand.
* @return The sum of @a a and @a b.
*/
size_t bc_vm_growSize(size_t a, size_t b);
size_t
bc_vm_growSize(size_t a, size_t b);
/**
* Allocate @a n bytes and throw an allocation error if allocation fails.
* @param n The bytes to allocate.
* @return A pointer to the allocated memory.
*/
void* bc_vm_malloc(size_t n);
void*
bc_vm_malloc(size_t n);
/**
* Reallocate @a ptr to be @a n bytes and throw an allocation error if
@ -744,48 +768,55 @@ void* bc_vm_malloc(size_t n);
* @param n The bytes to allocate.
* @return A pointer to the reallocated memory.
*/
void* bc_vm_realloc(void *ptr, size_t n);
void*
bc_vm_realloc(void* ptr, size_t n);
/**
* Allocates space for, and duplicates, @a str.
* @param str The string to allocate.
* @return The allocated string.
*/
char* bc_vm_strdup(const char *str);
char*
bc_vm_strdup(const char* str);
/**
* Reads a line from stdin into BcVm's buffer field.
* @param clear True if the buffer should be cleared first, false otherwise.
* @return True if a line was read, false otherwise.
*/
bool bc_vm_readLine(bool clear);
bool
bc_vm_readLine(bool clear);
/**
* Reads a line from the command-line expressions into BcVm's buffer field.
* @param clear True if the buffer should be cleared first, false otherwise.
* @return True if a line was read, false otherwise.
*/
bool bc_vm_readBuf(bool clear);
bool
bc_vm_readBuf(bool clear);
/**
* A convenience and portability function for OpenBSD's pledge().
* @param promises The promises to pledge().
* @param execpromises The exec promises to pledge().
*/
void bc_pledge(const char *promises, const char *execpromises);
void
bc_pledge(const char* promises, const char* execpromises);
/**
* Returns the value of an environment variable.
* @param var The environment variable.
* @return The value of the environment variable.
*/
char* bc_vm_getenv(const char* var);
char*
bc_vm_getenv(const char* var);
/**
* Frees an environment variable value.
* @param val The value to free.
*/
void bc_vm_getenvFree(char* val);
void
bc_vm_getenvFree(char* val);
#if BC_DEBUG_CODE
@ -793,13 +824,15 @@ void bc_vm_getenvFree(char* val);
* Start executing a jump series.
* @param f The name of the function that started the jump series.
*/
void bc_vm_jmp(const char *f);
void
bc_vm_jmp(const char* f);
#else // BC_DEBUG_CODE
/**
* Start executing a jump series.
*/
void bc_vm_jmp(void);
void
bc_vm_jmp(void);
#endif // BC_DEBUG_CODE
@ -811,18 +844,21 @@ void bc_vm_jmp(void);
* or no POSIX errors are enabled.
* @param e The error.
*/
void bc_vm_handleError(BcErr e);
void
bc_vm_handleError(BcErr e);
/**
* Handle a fatal error.
* @param e The error.
*/
void bc_vm_fatalError(BcErr e);
void
bc_vm_fatalError(BcErr e);
/**
* A function to call at exit.
*/
void bc_vm_atexit(void);
void
bc_vm_atexit(void);
#else // BC_ENABLE_LIBRARY
@ -833,7 +869,8 @@ void bc_vm_atexit(void);
* @param e The error.
* @param line The source line where the error occurred.
*/
void bc_vm_handleError(BcErr e, size_t line, ...);
void
bc_vm_handleError(BcErr e, size_t line, ...);
/**
* Handle a fatal error.
@ -842,13 +879,15 @@ void bc_vm_handleError(BcErr e, size_t line, ...);
#if !BC_ENABLE_MEMCHECK
BC_NORETURN
#endif // !BC_ENABLE_MEMCHECK
void bc_vm_fatalError(BcErr e);
void
bc_vm_fatalError(BcErr e);
/**
* A function to call at exit.
* @param status The exit status.
*/
int bc_vm_atexit(int status);
int
bc_vm_atexit(int status);
#endif // BC_ENABLE_LIBRARY
/// A reference to the copyright header.
@ -861,7 +900,7 @@ extern const char* const bc_err_line;
extern const char* const bc_err_func_header;
/// A reference to the array of default error category names.
extern const char *bc_errs[];
extern const char* bc_errs[];
/// A reference to the array of error category indices for each error.
extern const uchar bc_err_ids[];

4
contrib/bc/locales/en_US.msg
View File

@ -77,10 +77,10 @@ $set 4
22 "POSIX does not allow comparison operators outside if statements or loops"
23 "POSIX requires 0 or 1 comparison operators per condition"
24 "POSIX requires all 3 parts of a for loop to be non-empty"
25 "POSIX requires a newline between a semicolon and a function definition",
25 "POSIX requires a newline between a semicolon and a function definition"
26 "POSIX does not allow exponential notation"
27 "POSIX does not allow array references as function parameters"
28 "POSIX does not allow void functions",
28 "POSIX does not allow void functions"
29 "POSIX requires the left brace be on the same line as the function header"
30 "POSIX does not allow strings to be assigned to variables or arrays"

128
contrib/bc/manuals/bc/A.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "BC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "BC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH NAME
.PP
bc - arbitrary-precision decimal arithmetic language and calculator
@ -38,13 +40,17 @@ bc - arbitrary-precision decimal arithmetic language and calculator
[\f[B]-e\f[R] \f[I]expr\f[R]]
[\f[B]--expression\f[R]=\f[I]expr\f[R]\&...] [\f[B]-f\f[R]
\f[I]file\f[R]\&...] [\f[B]--file\f[R]=\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...] [\f[B]-I\f[R] \f[I]ibase\f[R]]
[\f[B]--ibase\f[R]=\f[I]ibase\f[R]] [\f[B]-O\f[R] \f[I]obase\f[R]]
[\f[B]--obase\f[R]=\f[I]obase\f[R]] [\f[B]-S\f[R] \f[I]scale\f[R]]
[\f[B]--scale\f[R]=\f[I]scale\f[R]] [\f[B]-E\f[R] \f[I]seed\f[R]]
[\f[B]--seed\f[R]=\f[I]seed\f[R]]
.SH DESCRIPTION
.PP
bc(1) is an interactive processor for a language first standardized in
1991 by POSIX.
(The current standard is
here (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).)
(The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .)
The language provides unlimited precision decimal arithmetic and is
somewhat C-like, but there are differences.
Such differences will be noted in this document.
@ -287,26 +293,32 @@ multiple times.
Keywords are \f[I]not\f[R] redefined when parsing the builtin math
library (see the \f[B]LIBRARY\f[R] section).
.PP
It is a fatal error to redefine keywords mandated by the POSIX standard.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
It is a fatal error to attempt to redefine words that this bc(1) does
not reserve as keywords.
.RE
.TP
\f[B]-q\f[R], \f[B]--quiet\f[R]
This option is for compatibility with the GNU
bc(1) (https://www.gnu.org/software/bc/); it is a no-op.
This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op.
Without this option, GNU bc(1) prints a copyright header.
This bc(1) only prints the copyright header if one or more of the
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given.
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given
unless the \f[B]BC_BANNER\f[R] environment variable is set and contains
a non-zero integer or if this bc(1) was built with the header displayed
by default.
If \f[I]any\f[R] of that is the case, then this option \f[I]does\f[R]
prevent bc(1) from printing the header.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-s\f[R], \f[B]--standard\f[R]
Process exactly the language defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
and error if any extensions are used.
Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
@ -382,13 +394,57 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-E\f[R] \f[I]seed\f[R], \f[B]--seed\f[R]=\f[I]seed\f[R]
Sets the builtin variable \f[B]seed\f[R] to the value \f[I]seed\f[R]
assuming that \f[I]seed\f[R] is in base 10.
It is a fatal error if \f[I]seed\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files or expressions are given by the \f[B]-f\f[R],
\f[B]--file\f[R], \f[B]-e\f[R], or \f[B]--expression\f[R] options, then
bc(1) read from \f[B]stdin\f[R].
bc(1) reads from \f[B]stdin\f[R].
.PP
However, there are a few caveats to this.
.PP
@ -435,8 +491,8 @@ redirect \f[B]stderr\f[R] to \f[B]/dev/null\f[R].
.SH SYNTAX
.PP
The syntax for bc(1) programs is mostly C-like, with some differences.
This bc(1) follows the POSIX
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
This bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
which is a much more thorough resource for the language this bc(1)
accepts.
This section is meant to be a summary and a listing of all the
@ -1020,8 +1076,8 @@ Note that unlike in C, these operators have a lower precedence than the
\f[B]assignment\f[R] operators, which means that \f[B]a=b>c\f[R] is
interpreted as \f[B](a=b)>c\f[R].
.PP
Also, unlike the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can
be used.
This allowance is a \f[B]non-portable extension\f[R].
@ -1328,8 +1384,8 @@ when the \f[B]-s\f[R] option, the \f[B]-w\f[R] option, or equivalents
are given.
.SS Standard Library
.PP
The
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
defines the following functions for the math library:
.TP
\f[B]s(x)\f[R]
@ -1385,7 +1441,8 @@ Functions\f[R] subsection below).
The extended library is \f[I]not\f[R] loaded when the
\f[B]-s\f[R]/\f[B]--standard\f[R] or \f[B]-w\f[R]/\f[B]--warn\f[R]
options are given since they are not part of the library defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
.PP
The extended library is a \f[B]non-portable extension\f[R].
.TP
@ -1404,13 +1461,13 @@ Functions\f[R] subsection below).
.TP
\f[B]r(x, p)\f[R]
Returns \f[B]x\f[R] rounded to \f[B]p\f[R] decimal places according to
the rounding mode round half away from
\f[B]0\f[R] (https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
the rounding mode round half away from \f[B]0\f[R]
(https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
.TP
\f[B]ceil(x, p)\f[R]
Returns \f[B]x\f[R] rounded to \f[B]p\f[R] decimal places according to
the rounding mode round away from
\f[B]0\f[R] (https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
the rounding mode round away from \f[B]0\f[R]
(https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
.TP
\f[B]f(x)\f[R]
Returns the factorial of the truncated absolute value of \f[B]x\f[R].
@ -2275,11 +2332,11 @@ subsection of the \f[B]FUNCTIONS\f[R] section).
.RE
.SS Transcendental Functions
.PP
All transcendental functions can return slightly inaccurate results (up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place)).
This is unavoidable, and this
article (https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT) explains
why it is impossible and unnecessary to calculate exact results for the
All transcendental functions can return slightly inaccurate results, up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place).
This is unavoidable, and the article at
https://people.eecs.berkeley.edu/\[ti]wkahan/LOG10HAF.TXT explains why
it is impossible and unnecessary to calculate exact results for the
transcendental functions.
.PP
Because of the possible inaccuracy, I recommend that users call those
@ -2558,8 +2615,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes bc(1) exit after executing the
expressions and expression files, and a non-zero value makes bc(1) not
exit.
expressions and expression files, and a zero value makes bc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -2646,8 +2702,8 @@ checking, and its normal behavior can be forced by using the
\f[B]-i\f[R] flag or \f[B]--interactive\f[R] option.
.SH INTERACTIVE MODE
.PP
Per the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both \f[B]stdin\f[R]
and \f[B]stdout\f[R] are hooked to a terminal, but the \f[B]-i\f[R] flag
@ -2680,8 +2736,8 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
required in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
.SS Command-Line History
@ -2776,8 +2832,8 @@ dc(1)
.SH STANDARDS
.PP
bc(1) is compliant with the IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
(\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .
The flags \f[B]-efghiqsvVw\f[R], all long options, and the extensions
noted above are extensions to that specification.
.PP

141
contrib/bc/manuals/bc/A.1.md
View File

@ -34,14 +34,15 @@ bc - arbitrary-precision decimal arithmetic language and calculator
# SYNOPSIS
**bc** [**-ghilPqRsvVw**] [**-\-global-stacks**] [**-\-help**] [**-\-interactive**] [**-\-mathlib**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-quiet**] [**-\-standard**] [**-\-warn**] [**-\-version**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...]
**bc** [**-ghilPqRsvVw**] [**-\-global-stacks**] [**-\-help**] [**-\-interactive**] [**-\-mathlib**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-quiet**] [**-\-standard**] [**-\-warn**] [**-\-version**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...] [**-I** *ibase*] [**-\-ibase**=*ibase*] [**-O** *obase*] [**-\-obase**=*obase*] [**-S** *scale*] [**-\-scale**=*scale*] [**-E** *seed*] [**-\-seed**=*seed*]
# DESCRIPTION
bc(1) is an interactive processor for a language first standardized in 1991 by
POSIX. (The current standard is [here][1].) The language provides unlimited
precision decimal arithmetic and is somewhat C-like, but there are differences.
Such differences will be noted in this document.
POSIX. (The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .) The
language provides unlimited precision decimal arithmetic and is somewhat C-like,
but there are differences. Such differences will be noted in this document.
After parsing and handling options, this bc(1) reads any files given on the
command line and executes them before reading from **stdin**.
@ -223,23 +224,29 @@ The following are the options that bc(1) accepts.
Keywords are *not* redefined when parsing the builtin math library (see the
**LIBRARY** section).
It is a fatal error to redefine keywords mandated by the POSIX standard. It
is a fatal error to attempt to redefine words that this bc(1) does not
reserve as keywords.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html). It is
a fatal error to attempt to redefine words that this bc(1) does not reserve
as keywords.
**-q**, **-\-quiet**
: This option is for compatibility with the [GNU bc(1)][2]; it is a no-op.
Without this option, GNU bc(1) prints a copyright header. This bc(1) only
prints the copyright header if one or more of the **-v**, **-V**, or
**-\-version** options are given.
: This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op. Without this option, GNU
bc(1) prints a copyright header. This bc(1) only prints the copyright header
if one or more of the **-v**, **-V**, or **-\-version** options are given
unless the **BC_BANNER** environment variable is set and contains a non-zero
integer or if this bc(1) was built with the header displayed by default. If
*any* of that is the case, then this option *does* prevent bc(1) from
printing the header.
This is a **non-portable extension**.
**-s**, **-\-standard**
: Process exactly the language defined by the [standard][1] and error if any
extensions are used.
: Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
This is a **non-portable extension**.
@ -299,12 +306,48 @@ The following are the options that bc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-E** *seed*, **-\-seed**=*seed*
: Sets the builtin variable **seed** to the value *seed* assuming that *seed*
is in base 10. It is a fatal error if *seed* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files or expressions are given by the **-f**, **-\-file**, **-e**, or
**-\-expression** options, then bc(1) read from **stdin**.
**-\-expression** options, then bc(1) reads from **stdin**.
However, there are a few caveats to this.
@ -350,9 +393,10 @@ it is recommended that those scripts be changed to redirect **stderr** to
# SYNTAX
The syntax for bc(1) programs is mostly C-like, with some differences. This
bc(1) follows the [POSIX standard][1], which is a much more thorough resource
for the language this bc(1) accepts. This section is meant to be a summary and a
listing of all the extensions to the standard.
bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), which is a
much more thorough resource for the language this bc(1) accepts. This section is
meant to be a summary and a listing of all the extensions to the standard.
In the sections below, **E** means expression, **S** means statement, and **I**
means identifier.
@ -805,9 +849,10 @@ The operators will be described in more detail below.
**assignment** operators, which means that **a=b\>c** is interpreted as
**(a=b)\>c**.
Also, unlike the [standard][1] requires, these operators can appear anywhere
any other expressions can be used. This allowance is a
**non-portable extension**.
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can be
used. This allowance is a **non-portable extension**.
**&&**
@ -1054,7 +1099,9 @@ equivalents are given.
## Standard Library
The [standard][1] defines the following functions for the math library:
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) defines the
following functions for the math library:
**s(x)**
@ -1102,7 +1149,8 @@ The [standard][1] defines the following functions for the math library:
The extended library is *not* loaded when the **-s**/**-\-standard** or
**-w**/**-\-warn** options are given since they are not part of the library
defined by the [standard][1].
defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
The extended library is a **non-portable extension**.
@ -1119,12 +1167,14 @@ The extended library is a **non-portable extension**.
**r(x, p)**
: Returns **x** rounded to **p** decimal places according to the rounding mode
[round half away from **0**][3].
round half away from **0**
(https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
**ceil(x, p)**
: Returns **x** rounded to **p** decimal places according to the rounding mode
[round away from **0**][6].
round away from **0**
(https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
**f(x)**
@ -1888,10 +1938,11 @@ The extended library is a **non-portable extension**.
## Transcendental Functions
All transcendental functions can return slightly inaccurate results (up to 1
[ULP][4]). This is unavoidable, and [this article][5] explains why it is
impossible and unnecessary to calculate exact results for the transcendental
functions.
All transcendental functions can return slightly inaccurate results, up to 1 ULP
(https://en.wikipedia.org/wiki/Unit_in_the_last_place). This is unavoidable, and
the article at https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT explains
why it is impossible and unnecessary to calculate exact results for the
transcendental functions.
Because of the possible inaccuracy, I recommend that users call those functions
with the precision (**scale**) set to at least 1 higher than is necessary. If
@ -2134,8 +2185,8 @@ bc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes bc(1) exit
after executing the expressions and expression files, and a non-zero value
makes bc(1) not exit.
after executing the expressions and expression files, and a zero value makes
bc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -2215,10 +2266,12 @@ checking, and its normal behavior can be forced by using the **-i** flag or
# INTERACTIVE MODE
Per the [standard][1], bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both **stdin** and **stdout**
are hooked to a terminal, but the **-i** flag and **-\-interactive** option can
turn it on in other situations.
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), bc(1) has
an interactive mode and a non-interactive mode. Interactive mode is turned on
automatically when both **stdin** and **stdout** are hooked to a terminal, but
the **-i** flag and **-\-interactive** option can turn it on in other
situations.
In interactive mode, bc(1) attempts to recover from errors (see the **RESET**
section), and in normal execution, flushes **stdout** as soon as execution is
@ -2244,8 +2297,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Command-Line History
@ -2331,9 +2386,10 @@ dc(1)
# STANDARDS
bc(1) is compliant with the [IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1]
specification. The flags **-efghiqsvVw**, all long options, and the extensions
noted above are extensions to that specification.
bc(1) is compliant with the IEEE Std 1003.1-2017 (“POSIX.1-2017”) specification
at https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html . The
flags **-efghiqsvVw**, all long options, and the extensions noted above are
extensions to that specification.
Note that the specification explicitly says that bc(1) only accepts numbers that
use a period (**.**) as a radix point, regardless of the value of
@ -2349,10 +2405,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHORS
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html
[2]: https://www.gnu.org/software/bc/
[3]: https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero
[4]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
[5]: https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT
[6]: https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero

100
contrib/bc/manuals/bc/E.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "BC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "BC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH NAME
.PP
bc - arbitrary-precision decimal arithmetic language and calculator
@ -43,8 +45,8 @@ bc - arbitrary-precision decimal arithmetic language and calculator
.PP
bc(1) is an interactive processor for a language first standardized in
1991 by POSIX.
(The current standard is
here (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).)
(The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .)
The language provides unlimited precision decimal arithmetic and is
somewhat C-like, but there are differences.
Such differences will be noted in this document.
@ -256,26 +258,32 @@ multiple times.
Keywords are \f[I]not\f[R] redefined when parsing the builtin math
library (see the \f[B]LIBRARY\f[R] section).
.PP
It is a fatal error to redefine keywords mandated by the POSIX standard.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
It is a fatal error to attempt to redefine words that this bc(1) does
not reserve as keywords.
.RE
.TP
\f[B]-q\f[R], \f[B]--quiet\f[R]
This option is for compatibility with the GNU
bc(1) (https://www.gnu.org/software/bc/); it is a no-op.
This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op.
Without this option, GNU bc(1) prints a copyright header.
This bc(1) only prints the copyright header if one or more of the
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given.
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given
unless the \f[B]BC_BANNER\f[R] environment variable is set and contains
a non-zero integer or if this bc(1) was built with the header displayed
by default.
If \f[I]any\f[R] of that is the case, then this option \f[I]does\f[R]
prevent bc(1) from printing the header.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-s\f[R], \f[B]--standard\f[R]
Process exactly the language defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
and error if any extensions are used.
Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
@ -351,13 +359,46 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files or expressions are given by the \f[B]-f\f[R],
\f[B]--file\f[R], \f[B]-e\f[R], or \f[B]--expression\f[R] options, then
bc(1) read from \f[B]stdin\f[R].
bc(1) reads from \f[B]stdin\f[R].
.PP
However, there are a few caveats to this.
.PP
@ -404,8 +445,8 @@ redirect \f[B]stderr\f[R] to \f[B]/dev/null\f[R].
.SH SYNTAX
.PP
The syntax for bc(1) programs is mostly C-like, with some differences.
This bc(1) follows the POSIX
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
This bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
which is a much more thorough resource for the language this bc(1)
accepts.
This section is meant to be a summary and a listing of all the
@ -812,8 +853,8 @@ Note that unlike in C, these operators have a lower precedence than the
\f[B]assignment\f[R] operators, which means that \f[B]a=b>c\f[R] is
interpreted as \f[B](a=b)>c\f[R].
.PP
Also, unlike the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can
be used.
This allowance is a \f[B]non-portable extension\f[R].
@ -1102,8 +1143,8 @@ All of the functions below are available when the \f[B]-l\f[R] or
\f[B]--mathlib\f[R] command-line flags are given.
.SS Standard Library
.PP
The
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
defines the following functions for the math library:
.TP
\f[B]s(x)\f[R]
@ -1156,11 +1197,11 @@ Functions\f[R] subsection below).
.RE
.SS Transcendental Functions
.PP
All transcendental functions can return slightly inaccurate results (up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place)).
This is unavoidable, and this
article (https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT) explains
why it is impossible and unnecessary to calculate exact results for the
All transcendental functions can return slightly inaccurate results, up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place).
This is unavoidable, and the article at
https://people.eecs.berkeley.edu/\[ti]wkahan/LOG10HAF.TXT explains why
it is impossible and unnecessary to calculate exact results for the
transcendental functions.
.PP
Because of the possible inaccuracy, I recommend that users call those
@ -1406,8 +1447,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes bc(1) exit after executing the
expressions and expression files, and a non-zero value makes bc(1) not
exit.
expressions and expression files, and a zero value makes bc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1492,8 +1532,8 @@ checking, and its normal behavior can be forced by using the
\f[B]-i\f[R] flag or \f[B]--interactive\f[R] option.
.SH INTERACTIVE MODE
.PP
Per the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both \f[B]stdin\f[R]
and \f[B]stdout\f[R] are hooked to a terminal, but the \f[B]-i\f[R] flag
@ -1526,8 +1566,8 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
required in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
.SS Command-Line History
@ -1622,8 +1662,8 @@ dc(1)
.SH STANDARDS
.PP
bc(1) is compliant with the IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
(\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .
The flags \f[B]-efghiqsvVw\f[R], all long options, and the extensions
noted above are extensions to that specification.
.PP

121
contrib/bc/manuals/bc/E.1.md
View File

@ -39,9 +39,10 @@ bc - arbitrary-precision decimal arithmetic language and calculator
# DESCRIPTION
bc(1) is an interactive processor for a language first standardized in 1991 by
POSIX. (The current standard is [here][1].) The language provides unlimited
precision decimal arithmetic and is somewhat C-like, but there are differences.
Such differences will be noted in this document.
POSIX. (The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .) The
language provides unlimited precision decimal arithmetic and is somewhat C-like,
but there are differences. Such differences will be noted in this document.
After parsing and handling options, this bc(1) reads any files given on the
command line and executes them before reading from **stdin**.
@ -203,23 +204,29 @@ The following are the options that bc(1) accepts.
Keywords are *not* redefined when parsing the builtin math library (see the
**LIBRARY** section).
It is a fatal error to redefine keywords mandated by the POSIX standard. It
is a fatal error to attempt to redefine words that this bc(1) does not
reserve as keywords.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html). It is
a fatal error to attempt to redefine words that this bc(1) does not reserve
as keywords.
**-q**, **-\-quiet**
: This option is for compatibility with the [GNU bc(1)][2]; it is a no-op.
Without this option, GNU bc(1) prints a copyright header. This bc(1) only
prints the copyright header if one or more of the **-v**, **-V**, or
**-\-version** options are given.
: This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op. Without this option, GNU
bc(1) prints a copyright header. This bc(1) only prints the copyright header
if one or more of the **-v**, **-V**, or **-\-version** options are given
unless the **BC_BANNER** environment variable is set and contains a non-zero
integer or if this bc(1) was built with the header displayed by default. If
*any* of that is the case, then this option *does* prevent bc(1) from
printing the header.
This is a **non-portable extension**.
**-s**, **-\-standard**
: Process exactly the language defined by the [standard][1] and error if any
extensions are used.
: Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
This is a **non-portable extension**.
@ -279,12 +286,39 @@ The following are the options that bc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files or expressions are given by the **-f**, **-\-file**, **-e**, or
**-\-expression** options, then bc(1) read from **stdin**.
**-\-expression** options, then bc(1) reads from **stdin**.
However, there are a few caveats to this.
@ -330,9 +364,10 @@ it is recommended that those scripts be changed to redirect **stderr** to
# SYNTAX
The syntax for bc(1) programs is mostly C-like, with some differences. This
bc(1) follows the [POSIX standard][1], which is a much more thorough resource
for the language this bc(1) accepts. This section is meant to be a summary and a
listing of all the extensions to the standard.
bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), which is a
much more thorough resource for the language this bc(1) accepts. This section is
meant to be a summary and a listing of all the extensions to the standard.
In the sections below, **E** means expression, **S** means statement, and **I**
means identifier.
@ -648,9 +683,10 @@ The operators will be described in more detail below.
**assignment** operators, which means that **a=b\>c** is interpreted as
**(a=b)\>c**.
Also, unlike the [standard][1] requires, these operators can appear anywhere
any other expressions can be used. This allowance is a
**non-portable extension**.
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can be
used. This allowance is a **non-portable extension**.
**&&**
@ -883,7 +919,9 @@ command-line flags are given.
## Standard Library
The [standard][1] defines the following functions for the math library:
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) defines the
following functions for the math library:
**s(x)**
@ -929,10 +967,11 @@ The [standard][1] defines the following functions for the math library:
## Transcendental Functions
All transcendental functions can return slightly inaccurate results (up to 1
[ULP][4]). This is unavoidable, and [this article][5] explains why it is
impossible and unnecessary to calculate exact results for the transcendental
functions.
All transcendental functions can return slightly inaccurate results, up to 1 ULP
(https://en.wikipedia.org/wiki/Unit_in_the_last_place). This is unavoidable, and
the article at https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT explains
why it is impossible and unnecessary to calculate exact results for the
transcendental functions.
Because of the possible inaccuracy, I recommend that users call those functions
with the precision (**scale**) set to at least 1 higher than is necessary. If
@ -1154,8 +1193,8 @@ bc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes bc(1) exit
after executing the expressions and expression files, and a non-zero value
makes bc(1) not exit.
after executing the expressions and expression files, and a zero value makes
bc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1233,10 +1272,12 @@ checking, and its normal behavior can be forced by using the **-i** flag or
# INTERACTIVE MODE
Per the [standard][1], bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both **stdin** and **stdout**
are hooked to a terminal, but the **-i** flag and **-\-interactive** option can
turn it on in other situations.
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), bc(1) has
an interactive mode and a non-interactive mode. Interactive mode is turned on
automatically when both **stdin** and **stdout** are hooked to a terminal, but
the **-i** flag and **-\-interactive** option can turn it on in other
situations.
In interactive mode, bc(1) attempts to recover from errors (see the **RESET**
section), and in normal execution, flushes **stdout** as soon as execution is
@ -1262,8 +1303,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Command-Line History
@ -1349,9 +1392,10 @@ dc(1)
# STANDARDS
bc(1) is compliant with the [IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1]
specification. The flags **-efghiqsvVw**, all long options, and the extensions
noted above are extensions to that specification.
bc(1) is compliant with the IEEE Std 1003.1-2017 (“POSIX.1-2017”) specification
at https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html . The
flags **-efghiqsvVw**, all long options, and the extensions noted above are
extensions to that specification.
Note that the specification explicitly says that bc(1) only accepts numbers that
use a period (**.**) as a radix point, regardless of the value of
@ -1367,10 +1411,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHORS
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html
[2]: https://www.gnu.org/software/bc/
[3]: https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero
[4]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
[5]: https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT
[6]: https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero

100
contrib/bc/manuals/bc/EH.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "BC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "BC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH NAME
.PP
bc - arbitrary-precision decimal arithmetic language and calculator
@ -43,8 +45,8 @@ bc - arbitrary-precision decimal arithmetic language and calculator
.PP
bc(1) is an interactive processor for a language first standardized in
1991 by POSIX.
(The current standard is
here (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).)
(The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .)
The language provides unlimited precision decimal arithmetic and is
somewhat C-like, but there are differences.
Such differences will be noted in this document.
@ -256,26 +258,32 @@ multiple times.
Keywords are \f[I]not\f[R] redefined when parsing the builtin math
library (see the \f[B]LIBRARY\f[R] section).
.PP
It is a fatal error to redefine keywords mandated by the POSIX standard.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
It is a fatal error to attempt to redefine words that this bc(1) does
not reserve as keywords.
.RE
.TP
\f[B]-q\f[R], \f[B]--quiet\f[R]
This option is for compatibility with the GNU
bc(1) (https://www.gnu.org/software/bc/); it is a no-op.
This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op.
Without this option, GNU bc(1) prints a copyright header.
This bc(1) only prints the copyright header if one or more of the
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given.
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given
unless the \f[B]BC_BANNER\f[R] environment variable is set and contains
a non-zero integer or if this bc(1) was built with the header displayed
by default.
If \f[I]any\f[R] of that is the case, then this option \f[I]does\f[R]
prevent bc(1) from printing the header.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-s\f[R], \f[B]--standard\f[R]
Process exactly the language defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
and error if any extensions are used.
Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
@ -351,13 +359,46 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files or expressions are given by the \f[B]-f\f[R],
\f[B]--file\f[R], \f[B]-e\f[R], or \f[B]--expression\f[R] options, then
bc(1) read from \f[B]stdin\f[R].
bc(1) reads from \f[B]stdin\f[R].
.PP
However, there are a few caveats to this.
.PP
@ -404,8 +445,8 @@ redirect \f[B]stderr\f[R] to \f[B]/dev/null\f[R].
.SH SYNTAX
.PP
The syntax for bc(1) programs is mostly C-like, with some differences.
This bc(1) follows the POSIX
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
This bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
which is a much more thorough resource for the language this bc(1)
accepts.
This section is meant to be a summary and a listing of all the
@ -812,8 +853,8 @@ Note that unlike in C, these operators have a lower precedence than the
\f[B]assignment\f[R] operators, which means that \f[B]a=b>c\f[R] is
interpreted as \f[B](a=b)>c\f[R].
.PP
Also, unlike the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can
be used.
This allowance is a \f[B]non-portable extension\f[R].
@ -1102,8 +1143,8 @@ All of the functions below are available when the \f[B]-l\f[R] or
\f[B]--mathlib\f[R] command-line flags are given.
.SS Standard Library
.PP
The
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
defines the following functions for the math library:
.TP
\f[B]s(x)\f[R]
@ -1156,11 +1197,11 @@ Functions\f[R] subsection below).
.RE
.SS Transcendental Functions
.PP
All transcendental functions can return slightly inaccurate results (up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place)).
This is unavoidable, and this
article (https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT) explains
why it is impossible and unnecessary to calculate exact results for the
All transcendental functions can return slightly inaccurate results, up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place).
This is unavoidable, and the article at
https://people.eecs.berkeley.edu/\[ti]wkahan/LOG10HAF.TXT explains why
it is impossible and unnecessary to calculate exact results for the
transcendental functions.
.PP
Because of the possible inaccuracy, I recommend that users call those
@ -1406,8 +1447,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes bc(1) exit after executing the
expressions and expression files, and a non-zero value makes bc(1) not
exit.
expressions and expression files, and a zero value makes bc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1492,8 +1532,8 @@ checking, and its normal behavior can be forced by using the
\f[B]-i\f[R] flag or \f[B]--interactive\f[R] option.
.SH INTERACTIVE MODE
.PP
Per the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both \f[B]stdin\f[R]
and \f[B]stdout\f[R] are hooked to a terminal, but the \f[B]-i\f[R] flag
@ -1526,8 +1566,8 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
required in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
.SS Prompt
@ -1593,8 +1633,8 @@ dc(1)
.SH STANDARDS
.PP
bc(1) is compliant with the IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
(\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .
The flags \f[B]-efghiqsvVw\f[R], all long options, and the extensions
noted above are extensions to that specification.
.PP

121
contrib/bc/manuals/bc/EH.1.md
View File

@ -39,9 +39,10 @@ bc - arbitrary-precision decimal arithmetic language and calculator
# DESCRIPTION
bc(1) is an interactive processor for a language first standardized in 1991 by
POSIX. (The current standard is [here][1].) The language provides unlimited
precision decimal arithmetic and is somewhat C-like, but there are differences.
Such differences will be noted in this document.
POSIX. (The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .) The
language provides unlimited precision decimal arithmetic and is somewhat C-like,
but there are differences. Such differences will be noted in this document.
After parsing and handling options, this bc(1) reads any files given on the
command line and executes them before reading from **stdin**.
@ -203,23 +204,29 @@ The following are the options that bc(1) accepts.
Keywords are *not* redefined when parsing the builtin math library (see the
**LIBRARY** section).
It is a fatal error to redefine keywords mandated by the POSIX standard. It
is a fatal error to attempt to redefine words that this bc(1) does not
reserve as keywords.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html). It is
a fatal error to attempt to redefine words that this bc(1) does not reserve
as keywords.
**-q**, **-\-quiet**
: This option is for compatibility with the [GNU bc(1)][2]; it is a no-op.
Without this option, GNU bc(1) prints a copyright header. This bc(1) only
prints the copyright header if one or more of the **-v**, **-V**, or
**-\-version** options are given.
: This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op. Without this option, GNU
bc(1) prints a copyright header. This bc(1) only prints the copyright header
if one or more of the **-v**, **-V**, or **-\-version** options are given
unless the **BC_BANNER** environment variable is set and contains a non-zero
integer or if this bc(1) was built with the header displayed by default. If
*any* of that is the case, then this option *does* prevent bc(1) from
printing the header.
This is a **non-portable extension**.
**-s**, **-\-standard**
: Process exactly the language defined by the [standard][1] and error if any
extensions are used.
: Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
This is a **non-portable extension**.
@ -279,12 +286,39 @@ The following are the options that bc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files or expressions are given by the **-f**, **-\-file**, **-e**, or
**-\-expression** options, then bc(1) read from **stdin**.
**-\-expression** options, then bc(1) reads from **stdin**.
However, there are a few caveats to this.
@ -330,9 +364,10 @@ it is recommended that those scripts be changed to redirect **stderr** to
# SYNTAX
The syntax for bc(1) programs is mostly C-like, with some differences. This
bc(1) follows the [POSIX standard][1], which is a much more thorough resource
for the language this bc(1) accepts. This section is meant to be a summary and a
listing of all the extensions to the standard.
bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), which is a
much more thorough resource for the language this bc(1) accepts. This section is
meant to be a summary and a listing of all the extensions to the standard.
In the sections below, **E** means expression, **S** means statement, and **I**
means identifier.
@ -648,9 +683,10 @@ The operators will be described in more detail below.
**assignment** operators, which means that **a=b\>c** is interpreted as
**(a=b)\>c**.
Also, unlike the [standard][1] requires, these operators can appear anywhere
any other expressions can be used. This allowance is a
**non-portable extension**.
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can be
used. This allowance is a **non-portable extension**.
**&&**
@ -883,7 +919,9 @@ command-line flags are given.
## Standard Library
The [standard][1] defines the following functions for the math library:
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) defines the
following functions for the math library:
**s(x)**
@ -929,10 +967,11 @@ The [standard][1] defines the following functions for the math library:
## Transcendental Functions
All transcendental functions can return slightly inaccurate results (up to 1
[ULP][4]). This is unavoidable, and [this article][5] explains why it is
impossible and unnecessary to calculate exact results for the transcendental
functions.
All transcendental functions can return slightly inaccurate results, up to 1 ULP
(https://en.wikipedia.org/wiki/Unit_in_the_last_place). This is unavoidable, and
the article at https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT explains
why it is impossible and unnecessary to calculate exact results for the
transcendental functions.
Because of the possible inaccuracy, I recommend that users call those functions
with the precision (**scale**) set to at least 1 higher than is necessary. If
@ -1154,8 +1193,8 @@ bc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes bc(1) exit
after executing the expressions and expression files, and a non-zero value
makes bc(1) not exit.
after executing the expressions and expression files, and a zero value makes
bc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1233,10 +1272,12 @@ checking, and its normal behavior can be forced by using the **-i** flag or
# INTERACTIVE MODE
Per the [standard][1], bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both **stdin** and **stdout**
are hooked to a terminal, but the **-i** flag and **-\-interactive** option can
turn it on in other situations.
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), bc(1) has
an interactive mode and a non-interactive mode. Interactive mode is turned on
automatically when both **stdin** and **stdout** are hooked to a terminal, but
the **-i** flag and **-\-interactive** option can turn it on in other
situations.
In interactive mode, bc(1) attempts to recover from errors (see the **RESET**
section), and in normal execution, flushes **stdout** as soon as execution is
@ -1262,8 +1303,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Prompt
@ -1323,9 +1366,10 @@ dc(1)
# STANDARDS
bc(1) is compliant with the [IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1]
specification. The flags **-efghiqsvVw**, all long options, and the extensions
noted above are extensions to that specification.
bc(1) is compliant with the IEEE Std 1003.1-2017 (“POSIX.1-2017”) specification
at https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html . The
flags **-efghiqsvVw**, all long options, and the extensions noted above are
extensions to that specification.
Note that the specification explicitly says that bc(1) only accepts numbers that
use a period (**.**) as a radix point, regardless of the value of
@ -1341,10 +1385,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHORS
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html
[2]: https://www.gnu.org/software/bc/
[3]: https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero
[4]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
[5]: https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT
[6]: https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero

100
contrib/bc/manuals/bc/EHN.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "BC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "BC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH NAME
.PP
bc - arbitrary-precision decimal arithmetic language and calculator
@ -43,8 +45,8 @@ bc - arbitrary-precision decimal arithmetic language and calculator
.PP
bc(1) is an interactive processor for a language first standardized in
1991 by POSIX.
(The current standard is
here (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).)
(The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .)
The language provides unlimited precision decimal arithmetic and is
somewhat C-like, but there are differences.
Such differences will be noted in this document.
@ -256,26 +258,32 @@ multiple times.
Keywords are \f[I]not\f[R] redefined when parsing the builtin math
library (see the \f[B]LIBRARY\f[R] section).
.PP
It is a fatal error to redefine keywords mandated by the POSIX standard.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
It is a fatal error to attempt to redefine words that this bc(1) does
not reserve as keywords.
.RE
.TP
\f[B]-q\f[R], \f[B]--quiet\f[R]
This option is for compatibility with the GNU
bc(1) (https://www.gnu.org/software/bc/); it is a no-op.
This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op.
Without this option, GNU bc(1) prints a copyright header.
This bc(1) only prints the copyright header if one or more of the
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given.
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given
unless the \f[B]BC_BANNER\f[R] environment variable is set and contains
a non-zero integer or if this bc(1) was built with the header displayed
by default.
If \f[I]any\f[R] of that is the case, then this option \f[I]does\f[R]
prevent bc(1) from printing the header.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-s\f[R], \f[B]--standard\f[R]
Process exactly the language defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
and error if any extensions are used.
Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
@ -351,13 +359,46 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files or expressions are given by the \f[B]-f\f[R],
\f[B]--file\f[R], \f[B]-e\f[R], or \f[B]--expression\f[R] options, then
bc(1) read from \f[B]stdin\f[R].
bc(1) reads from \f[B]stdin\f[R].
.PP
However, there are a few caveats to this.
.PP
@ -404,8 +445,8 @@ redirect \f[B]stderr\f[R] to \f[B]/dev/null\f[R].
.SH SYNTAX
.PP
The syntax for bc(1) programs is mostly C-like, with some differences.
This bc(1) follows the POSIX
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
This bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
which is a much more thorough resource for the language this bc(1)
accepts.
This section is meant to be a summary and a listing of all the
@ -812,8 +853,8 @@ Note that unlike in C, these operators have a lower precedence than the
\f[B]assignment\f[R] operators, which means that \f[B]a=b>c\f[R] is
interpreted as \f[B](a=b)>c\f[R].
.PP
Also, unlike the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can
be used.
This allowance is a \f[B]non-portable extension\f[R].
@ -1102,8 +1143,8 @@ All of the functions below are available when the \f[B]-l\f[R] or
\f[B]--mathlib\f[R] command-line flags are given.
.SS Standard Library
.PP
The
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
defines the following functions for the math library:
.TP
\f[B]s(x)\f[R]
@ -1156,11 +1197,11 @@ Functions\f[R] subsection below).
.RE
.SS Transcendental Functions
.PP
All transcendental functions can return slightly inaccurate results (up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place)).
This is unavoidable, and this
article (https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT) explains
why it is impossible and unnecessary to calculate exact results for the
All transcendental functions can return slightly inaccurate results, up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place).
This is unavoidable, and the article at
https://people.eecs.berkeley.edu/\[ti]wkahan/LOG10HAF.TXT explains why
it is impossible and unnecessary to calculate exact results for the
transcendental functions.
.PP
Because of the possible inaccuracy, I recommend that users call those
@ -1406,8 +1447,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes bc(1) exit after executing the
expressions and expression files, and a non-zero value makes bc(1) not
exit.
expressions and expression files, and a zero value makes bc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1492,8 +1532,8 @@ checking, and its normal behavior can be forced by using the
\f[B]-i\f[R] flag or \f[B]--interactive\f[R] option.
.SH INTERACTIVE MODE
.PP
Per the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both \f[B]stdin\f[R]
and \f[B]stdout\f[R] are hooked to a terminal, but the \f[B]-i\f[R] flag
@ -1526,8 +1566,8 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
required in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
.SS Prompt
@ -1589,8 +1629,8 @@ dc(1)
.SH STANDARDS
.PP
bc(1) is compliant with the IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
(\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .
The flags \f[B]-efghiqsvVw\f[R], all long options, and the extensions
noted above are extensions to that specification.
.PP

121
contrib/bc/manuals/bc/EHN.1.md
View File

@ -39,9 +39,10 @@ bc - arbitrary-precision decimal arithmetic language and calculator
# DESCRIPTION
bc(1) is an interactive processor for a language first standardized in 1991 by
POSIX. (The current standard is [here][1].) The language provides unlimited
precision decimal arithmetic and is somewhat C-like, but there are differences.
Such differences will be noted in this document.
POSIX. (The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .) The
language provides unlimited precision decimal arithmetic and is somewhat C-like,
but there are differences. Such differences will be noted in this document.
After parsing and handling options, this bc(1) reads any files given on the
command line and executes them before reading from **stdin**.
@ -203,23 +204,29 @@ The following are the options that bc(1) accepts.
Keywords are *not* redefined when parsing the builtin math library (see the
**LIBRARY** section).
It is a fatal error to redefine keywords mandated by the POSIX standard. It
is a fatal error to attempt to redefine words that this bc(1) does not
reserve as keywords.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html). It is
a fatal error to attempt to redefine words that this bc(1) does not reserve
as keywords.
**-q**, **-\-quiet**
: This option is for compatibility with the [GNU bc(1)][2]; it is a no-op.
Without this option, GNU bc(1) prints a copyright header. This bc(1) only
prints the copyright header if one or more of the **-v**, **-V**, or
**-\-version** options are given.
: This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op. Without this option, GNU
bc(1) prints a copyright header. This bc(1) only prints the copyright header
if one or more of the **-v**, **-V**, or **-\-version** options are given
unless the **BC_BANNER** environment variable is set and contains a non-zero
integer or if this bc(1) was built with the header displayed by default. If
*any* of that is the case, then this option *does* prevent bc(1) from
printing the header.
This is a **non-portable extension**.
**-s**, **-\-standard**
: Process exactly the language defined by the [standard][1] and error if any
extensions are used.
: Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
This is a **non-portable extension**.
@ -279,12 +286,39 @@ The following are the options that bc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files or expressions are given by the **-f**, **-\-file**, **-e**, or
**-\-expression** options, then bc(1) read from **stdin**.
**-\-expression** options, then bc(1) reads from **stdin**.
However, there are a few caveats to this.
@ -330,9 +364,10 @@ it is recommended that those scripts be changed to redirect **stderr** to
# SYNTAX
The syntax for bc(1) programs is mostly C-like, with some differences. This
bc(1) follows the [POSIX standard][1], which is a much more thorough resource
for the language this bc(1) accepts. This section is meant to be a summary and a
listing of all the extensions to the standard.
bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), which is a
much more thorough resource for the language this bc(1) accepts. This section is
meant to be a summary and a listing of all the extensions to the standard.
In the sections below, **E** means expression, **S** means statement, and **I**
means identifier.
@ -648,9 +683,10 @@ The operators will be described in more detail below.
**assignment** operators, which means that **a=b\>c** is interpreted as
**(a=b)\>c**.
Also, unlike the [standard][1] requires, these operators can appear anywhere
any other expressions can be used. This allowance is a
**non-portable extension**.
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can be
used. This allowance is a **non-portable extension**.
**&&**
@ -883,7 +919,9 @@ command-line flags are given.
## Standard Library
The [standard][1] defines the following functions for the math library:
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) defines the
following functions for the math library:
**s(x)**
@ -929,10 +967,11 @@ The [standard][1] defines the following functions for the math library:
## Transcendental Functions
All transcendental functions can return slightly inaccurate results (up to 1
[ULP][4]). This is unavoidable, and [this article][5] explains why it is
impossible and unnecessary to calculate exact results for the transcendental
functions.
All transcendental functions can return slightly inaccurate results, up to 1 ULP
(https://en.wikipedia.org/wiki/Unit_in_the_last_place). This is unavoidable, and
the article at https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT explains
why it is impossible and unnecessary to calculate exact results for the
transcendental functions.
Because of the possible inaccuracy, I recommend that users call those functions
with the precision (**scale**) set to at least 1 higher than is necessary. If
@ -1154,8 +1193,8 @@ bc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes bc(1) exit
after executing the expressions and expression files, and a non-zero value
makes bc(1) not exit.
after executing the expressions and expression files, and a zero value makes
bc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1233,10 +1272,12 @@ checking, and its normal behavior can be forced by using the **-i** flag or
# INTERACTIVE MODE
Per the [standard][1], bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both **stdin** and **stdout**
are hooked to a terminal, but the **-i** flag and **-\-interactive** option can
turn it on in other situations.
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), bc(1) has
an interactive mode and a non-interactive mode. Interactive mode is turned on
automatically when both **stdin** and **stdout** are hooked to a terminal, but
the **-i** flag and **-\-interactive** option can turn it on in other
situations.
In interactive mode, bc(1) attempts to recover from errors (see the **RESET**
section), and in normal execution, flushes **stdout** as soon as execution is
@ -1262,8 +1303,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Prompt
@ -1318,9 +1361,10 @@ dc(1)
# STANDARDS
bc(1) is compliant with the [IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1]
specification. The flags **-efghiqsvVw**, all long options, and the extensions
noted above are extensions to that specification.
bc(1) is compliant with the IEEE Std 1003.1-2017 (“POSIX.1-2017”) specification
at https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html . The
flags **-efghiqsvVw**, all long options, and the extensions noted above are
extensions to that specification.
Note that the specification explicitly says that bc(1) only accepts numbers that
use a period (**.**) as a radix point, regardless of the value of
@ -1333,10 +1377,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHORS
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html
[2]: https://www.gnu.org/software/bc/
[3]: https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero
[4]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
[5]: https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT
[6]: https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero

100
contrib/bc/manuals/bc/EN.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "BC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "BC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH NAME
.PP
bc - arbitrary-precision decimal arithmetic language and calculator
@ -43,8 +45,8 @@ bc - arbitrary-precision decimal arithmetic language and calculator
.PP
bc(1) is an interactive processor for a language first standardized in
1991 by POSIX.
(The current standard is
here (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).)
(The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .)
The language provides unlimited precision decimal arithmetic and is
somewhat C-like, but there are differences.
Such differences will be noted in this document.
@ -256,26 +258,32 @@ multiple times.
Keywords are \f[I]not\f[R] redefined when parsing the builtin math
library (see the \f[B]LIBRARY\f[R] section).
.PP
It is a fatal error to redefine keywords mandated by the POSIX standard.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
It is a fatal error to attempt to redefine words that this bc(1) does
not reserve as keywords.
.RE
.TP
\f[B]-q\f[R], \f[B]--quiet\f[R]
This option is for compatibility with the GNU
bc(1) (https://www.gnu.org/software/bc/); it is a no-op.
This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op.
Without this option, GNU bc(1) prints a copyright header.
This bc(1) only prints the copyright header if one or more of the
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given.
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given
unless the \f[B]BC_BANNER\f[R] environment variable is set and contains
a non-zero integer or if this bc(1) was built with the header displayed
by default.
If \f[I]any\f[R] of that is the case, then this option \f[I]does\f[R]
prevent bc(1) from printing the header.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-s\f[R], \f[B]--standard\f[R]
Process exactly the language defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
and error if any extensions are used.
Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
@ -351,13 +359,46 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files or expressions are given by the \f[B]-f\f[R],
\f[B]--file\f[R], \f[B]-e\f[R], or \f[B]--expression\f[R] options, then
bc(1) read from \f[B]stdin\f[R].
bc(1) reads from \f[B]stdin\f[R].
.PP
However, there are a few caveats to this.
.PP
@ -404,8 +445,8 @@ redirect \f[B]stderr\f[R] to \f[B]/dev/null\f[R].
.SH SYNTAX
.PP
The syntax for bc(1) programs is mostly C-like, with some differences.
This bc(1) follows the POSIX
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
This bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
which is a much more thorough resource for the language this bc(1)
accepts.
This section is meant to be a summary and a listing of all the
@ -812,8 +853,8 @@ Note that unlike in C, these operators have a lower precedence than the
\f[B]assignment\f[R] operators, which means that \f[B]a=b>c\f[R] is
interpreted as \f[B](a=b)>c\f[R].
.PP
Also, unlike the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can
be used.
This allowance is a \f[B]non-portable extension\f[R].
@ -1102,8 +1143,8 @@ All of the functions below are available when the \f[B]-l\f[R] or
\f[B]--mathlib\f[R] command-line flags are given.
.SS Standard Library
.PP
The
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
defines the following functions for the math library:
.TP
\f[B]s(x)\f[R]
@ -1156,11 +1197,11 @@ Functions\f[R] subsection below).
.RE
.SS Transcendental Functions
.PP
All transcendental functions can return slightly inaccurate results (up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place)).
This is unavoidable, and this
article (https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT) explains
why it is impossible and unnecessary to calculate exact results for the
All transcendental functions can return slightly inaccurate results, up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place).
This is unavoidable, and the article at
https://people.eecs.berkeley.edu/\[ti]wkahan/LOG10HAF.TXT explains why
it is impossible and unnecessary to calculate exact results for the
transcendental functions.
.PP
Because of the possible inaccuracy, I recommend that users call those
@ -1406,8 +1447,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes bc(1) exit after executing the
expressions and expression files, and a non-zero value makes bc(1) not
exit.
expressions and expression files, and a zero value makes bc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1492,8 +1532,8 @@ checking, and its normal behavior can be forced by using the
\f[B]-i\f[R] flag or \f[B]--interactive\f[R] option.
.SH INTERACTIVE MODE
.PP
Per the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both \f[B]stdin\f[R]
and \f[B]stdout\f[R] are hooked to a terminal, but the \f[B]-i\f[R] flag
@ -1526,8 +1566,8 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
required in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
.SS Command-Line History
@ -1618,8 +1658,8 @@ dc(1)
.SH STANDARDS
.PP
bc(1) is compliant with the IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
(\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .
The flags \f[B]-efghiqsvVw\f[R], all long options, and the extensions
noted above are extensions to that specification.
.PP

121
contrib/bc/manuals/bc/EN.1.md
View File

@ -39,9 +39,10 @@ bc - arbitrary-precision decimal arithmetic language and calculator
# DESCRIPTION
bc(1) is an interactive processor for a language first standardized in 1991 by
POSIX. (The current standard is [here][1].) The language provides unlimited
precision decimal arithmetic and is somewhat C-like, but there are differences.
Such differences will be noted in this document.
POSIX. (The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .) The
language provides unlimited precision decimal arithmetic and is somewhat C-like,
but there are differences. Such differences will be noted in this document.
After parsing and handling options, this bc(1) reads any files given on the
command line and executes them before reading from **stdin**.
@ -203,23 +204,29 @@ The following are the options that bc(1) accepts.
Keywords are *not* redefined when parsing the builtin math library (see the
**LIBRARY** section).
It is a fatal error to redefine keywords mandated by the POSIX standard. It
is a fatal error to attempt to redefine words that this bc(1) does not
reserve as keywords.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html). It is
a fatal error to attempt to redefine words that this bc(1) does not reserve
as keywords.
**-q**, **-\-quiet**
: This option is for compatibility with the [GNU bc(1)][2]; it is a no-op.
Without this option, GNU bc(1) prints a copyright header. This bc(1) only
prints the copyright header if one or more of the **-v**, **-V**, or
**-\-version** options are given.
: This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op. Without this option, GNU
bc(1) prints a copyright header. This bc(1) only prints the copyright header
if one or more of the **-v**, **-V**, or **-\-version** options are given
unless the **BC_BANNER** environment variable is set and contains a non-zero
integer or if this bc(1) was built with the header displayed by default. If
*any* of that is the case, then this option *does* prevent bc(1) from
printing the header.
This is a **non-portable extension**.
**-s**, **-\-standard**
: Process exactly the language defined by the [standard][1] and error if any
extensions are used.
: Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
This is a **non-portable extension**.
@ -279,12 +286,39 @@ The following are the options that bc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files or expressions are given by the **-f**, **-\-file**, **-e**, or
**-\-expression** options, then bc(1) read from **stdin**.
**-\-expression** options, then bc(1) reads from **stdin**.
However, there are a few caveats to this.
@ -330,9 +364,10 @@ it is recommended that those scripts be changed to redirect **stderr** to
# SYNTAX
The syntax for bc(1) programs is mostly C-like, with some differences. This
bc(1) follows the [POSIX standard][1], which is a much more thorough resource
for the language this bc(1) accepts. This section is meant to be a summary and a
listing of all the extensions to the standard.
bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), which is a
much more thorough resource for the language this bc(1) accepts. This section is
meant to be a summary and a listing of all the extensions to the standard.
In the sections below, **E** means expression, **S** means statement, and **I**
means identifier.
@ -648,9 +683,10 @@ The operators will be described in more detail below.
**assignment** operators, which means that **a=b\>c** is interpreted as
**(a=b)\>c**.
Also, unlike the [standard][1] requires, these operators can appear anywhere
any other expressions can be used. This allowance is a
**non-portable extension**.
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can be
used. This allowance is a **non-portable extension**.
**&&**
@ -883,7 +919,9 @@ command-line flags are given.
## Standard Library
The [standard][1] defines the following functions for the math library:
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) defines the
following functions for the math library:
**s(x)**
@ -929,10 +967,11 @@ The [standard][1] defines the following functions for the math library:
## Transcendental Functions
All transcendental functions can return slightly inaccurate results (up to 1
[ULP][4]). This is unavoidable, and [this article][5] explains why it is
impossible and unnecessary to calculate exact results for the transcendental
functions.
All transcendental functions can return slightly inaccurate results, up to 1 ULP
(https://en.wikipedia.org/wiki/Unit_in_the_last_place). This is unavoidable, and
the article at https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT explains
why it is impossible and unnecessary to calculate exact results for the
transcendental functions.
Because of the possible inaccuracy, I recommend that users call those functions
with the precision (**scale**) set to at least 1 higher than is necessary. If
@ -1154,8 +1193,8 @@ bc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes bc(1) exit
after executing the expressions and expression files, and a non-zero value
makes bc(1) not exit.
after executing the expressions and expression files, and a zero value makes
bc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1233,10 +1272,12 @@ checking, and its normal behavior can be forced by using the **-i** flag or
# INTERACTIVE MODE
Per the [standard][1], bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both **stdin** and **stdout**
are hooked to a terminal, but the **-i** flag and **-\-interactive** option can
turn it on in other situations.
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), bc(1) has
an interactive mode and a non-interactive mode. Interactive mode is turned on
automatically when both **stdin** and **stdout** are hooked to a terminal, but
the **-i** flag and **-\-interactive** option can turn it on in other
situations.
In interactive mode, bc(1) attempts to recover from errors (see the **RESET**
section), and in normal execution, flushes **stdout** as soon as execution is
@ -1262,8 +1303,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Command-Line History
@ -1344,9 +1387,10 @@ dc(1)
# STANDARDS
bc(1) is compliant with the [IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1]
specification. The flags **-efghiqsvVw**, all long options, and the extensions
noted above are extensions to that specification.
bc(1) is compliant with the IEEE Std 1003.1-2017 (“POSIX.1-2017”) specification
at https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html . The
flags **-efghiqsvVw**, all long options, and the extensions noted above are
extensions to that specification.
Note that the specification explicitly says that bc(1) only accepts numbers that
use a period (**.**) as a radix point, regardless of the value of
@ -1359,10 +1403,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHORS
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html
[2]: https://www.gnu.org/software/bc/
[3]: https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero
[4]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
[5]: https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT
[6]: https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero

128
contrib/bc/manuals/bc/H.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "BC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "BC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH NAME
.PP
bc - arbitrary-precision decimal arithmetic language and calculator
@ -38,13 +40,17 @@ bc - arbitrary-precision decimal arithmetic language and calculator
[\f[B]-e\f[R] \f[I]expr\f[R]]
[\f[B]--expression\f[R]=\f[I]expr\f[R]\&...] [\f[B]-f\f[R]
\f[I]file\f[R]\&...] [\f[B]--file\f[R]=\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...] [\f[B]-I\f[R] \f[I]ibase\f[R]]
[\f[B]--ibase\f[R]=\f[I]ibase\f[R]] [\f[B]-O\f[R] \f[I]obase\f[R]]
[\f[B]--obase\f[R]=\f[I]obase\f[R]] [\f[B]-S\f[R] \f[I]scale\f[R]]
[\f[B]--scale\f[R]=\f[I]scale\f[R]] [\f[B]-E\f[R] \f[I]seed\f[R]]
[\f[B]--seed\f[R]=\f[I]seed\f[R]]
.SH DESCRIPTION
.PP
bc(1) is an interactive processor for a language first standardized in
1991 by POSIX.
(The current standard is
here (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).)
(The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .)
The language provides unlimited precision decimal arithmetic and is
somewhat C-like, but there are differences.
Such differences will be noted in this document.
@ -287,26 +293,32 @@ multiple times.
Keywords are \f[I]not\f[R] redefined when parsing the builtin math
library (see the \f[B]LIBRARY\f[R] section).
.PP
It is a fatal error to redefine keywords mandated by the POSIX standard.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
It is a fatal error to attempt to redefine words that this bc(1) does
not reserve as keywords.
.RE
.TP
\f[B]-q\f[R], \f[B]--quiet\f[R]
This option is for compatibility with the GNU
bc(1) (https://www.gnu.org/software/bc/); it is a no-op.
This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op.
Without this option, GNU bc(1) prints a copyright header.
This bc(1) only prints the copyright header if one or more of the
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given.
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given
unless the \f[B]BC_BANNER\f[R] environment variable is set and contains
a non-zero integer or if this bc(1) was built with the header displayed
by default.
If \f[I]any\f[R] of that is the case, then this option \f[I]does\f[R]
prevent bc(1) from printing the header.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-s\f[R], \f[B]--standard\f[R]
Process exactly the language defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
and error if any extensions are used.
Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
@ -382,13 +394,57 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-E\f[R] \f[I]seed\f[R], \f[B]--seed\f[R]=\f[I]seed\f[R]
Sets the builtin variable \f[B]seed\f[R] to the value \f[I]seed\f[R]
assuming that \f[I]seed\f[R] is in base 10.
It is a fatal error if \f[I]seed\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files or expressions are given by the \f[B]-f\f[R],
\f[B]--file\f[R], \f[B]-e\f[R], or \f[B]--expression\f[R] options, then
bc(1) read from \f[B]stdin\f[R].
bc(1) reads from \f[B]stdin\f[R].
.PP
However, there are a few caveats to this.
.PP
@ -435,8 +491,8 @@ redirect \f[B]stderr\f[R] to \f[B]/dev/null\f[R].
.SH SYNTAX
.PP
The syntax for bc(1) programs is mostly C-like, with some differences.
This bc(1) follows the POSIX
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
This bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
which is a much more thorough resource for the language this bc(1)
accepts.
This section is meant to be a summary and a listing of all the
@ -1020,8 +1076,8 @@ Note that unlike in C, these operators have a lower precedence than the
\f[B]assignment\f[R] operators, which means that \f[B]a=b>c\f[R] is
interpreted as \f[B](a=b)>c\f[R].
.PP
Also, unlike the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can
be used.
This allowance is a \f[B]non-portable extension\f[R].
@ -1328,8 +1384,8 @@ when the \f[B]-s\f[R] option, the \f[B]-w\f[R] option, or equivalents
are given.
.SS Standard Library
.PP
The
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
defines the following functions for the math library:
.TP
\f[B]s(x)\f[R]
@ -1385,7 +1441,8 @@ Functions\f[R] subsection below).
The extended library is \f[I]not\f[R] loaded when the
\f[B]-s\f[R]/\f[B]--standard\f[R] or \f[B]-w\f[R]/\f[B]--warn\f[R]
options are given since they are not part of the library defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
.PP
The extended library is a \f[B]non-portable extension\f[R].
.TP
@ -1404,13 +1461,13 @@ Functions\f[R] subsection below).
.TP
\f[B]r(x, p)\f[R]
Returns \f[B]x\f[R] rounded to \f[B]p\f[R] decimal places according to
the rounding mode round half away from
\f[B]0\f[R] (https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
the rounding mode round half away from \f[B]0\f[R]
(https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
.TP
\f[B]ceil(x, p)\f[R]
Returns \f[B]x\f[R] rounded to \f[B]p\f[R] decimal places according to
the rounding mode round away from
\f[B]0\f[R] (https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
the rounding mode round away from \f[B]0\f[R]
(https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
.TP
\f[B]f(x)\f[R]
Returns the factorial of the truncated absolute value of \f[B]x\f[R].
@ -2275,11 +2332,11 @@ subsection of the \f[B]FUNCTIONS\f[R] section).
.RE
.SS Transcendental Functions
.PP
All transcendental functions can return slightly inaccurate results (up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place)).
This is unavoidable, and this
article (https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT) explains
why it is impossible and unnecessary to calculate exact results for the
All transcendental functions can return slightly inaccurate results, up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place).
This is unavoidable, and the article at
https://people.eecs.berkeley.edu/\[ti]wkahan/LOG10HAF.TXT explains why
it is impossible and unnecessary to calculate exact results for the
transcendental functions.
.PP
Because of the possible inaccuracy, I recommend that users call those
@ -2558,8 +2615,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes bc(1) exit after executing the
expressions and expression files, and a non-zero value makes bc(1) not
exit.
expressions and expression files, and a zero value makes bc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -2646,8 +2702,8 @@ checking, and its normal behavior can be forced by using the
\f[B]-i\f[R] flag or \f[B]--interactive\f[R] option.
.SH INTERACTIVE MODE
.PP
Per the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both \f[B]stdin\f[R]
and \f[B]stdout\f[R] are hooked to a terminal, but the \f[B]-i\f[R] flag
@ -2680,8 +2736,8 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
required in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
.SS Prompt
@ -2747,8 +2803,8 @@ dc(1)
.SH STANDARDS
.PP
bc(1) is compliant with the IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
(\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .
The flags \f[B]-efghiqsvVw\f[R], all long options, and the extensions
noted above are extensions to that specification.
.PP

141
contrib/bc/manuals/bc/H.1.md
View File

@ -34,14 +34,15 @@ bc - arbitrary-precision decimal arithmetic language and calculator
# SYNOPSIS
**bc** [**-ghilPqRsvVw**] [**-\-global-stacks**] [**-\-help**] [**-\-interactive**] [**-\-mathlib**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-quiet**] [**-\-standard**] [**-\-warn**] [**-\-version**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...]
**bc** [**-ghilPqRsvVw**] [**-\-global-stacks**] [**-\-help**] [**-\-interactive**] [**-\-mathlib**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-quiet**] [**-\-standard**] [**-\-warn**] [**-\-version**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...] [**-I** *ibase*] [**-\-ibase**=*ibase*] [**-O** *obase*] [**-\-obase**=*obase*] [**-S** *scale*] [**-\-scale**=*scale*] [**-E** *seed*] [**-\-seed**=*seed*]
# DESCRIPTION
bc(1) is an interactive processor for a language first standardized in 1991 by
POSIX. (The current standard is [here][1].) The language provides unlimited
precision decimal arithmetic and is somewhat C-like, but there are differences.
Such differences will be noted in this document.
POSIX. (The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .) The
language provides unlimited precision decimal arithmetic and is somewhat C-like,
but there are differences. Such differences will be noted in this document.
After parsing and handling options, this bc(1) reads any files given on the
command line and executes them before reading from **stdin**.
@ -223,23 +224,29 @@ The following are the options that bc(1) accepts.
Keywords are *not* redefined when parsing the builtin math library (see the
**LIBRARY** section).
It is a fatal error to redefine keywords mandated by the POSIX standard. It
is a fatal error to attempt to redefine words that this bc(1) does not
reserve as keywords.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html). It is
a fatal error to attempt to redefine words that this bc(1) does not reserve
as keywords.
**-q**, **-\-quiet**
: This option is for compatibility with the [GNU bc(1)][2]; it is a no-op.
Without this option, GNU bc(1) prints a copyright header. This bc(1) only
prints the copyright header if one or more of the **-v**, **-V**, or
**-\-version** options are given.
: This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op. Without this option, GNU
bc(1) prints a copyright header. This bc(1) only prints the copyright header
if one or more of the **-v**, **-V**, or **-\-version** options are given
unless the **BC_BANNER** environment variable is set and contains a non-zero
integer or if this bc(1) was built with the header displayed by default. If
*any* of that is the case, then this option *does* prevent bc(1) from
printing the header.
This is a **non-portable extension**.
**-s**, **-\-standard**
: Process exactly the language defined by the [standard][1] and error if any
extensions are used.
: Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
This is a **non-portable extension**.
@ -299,12 +306,48 @@ The following are the options that bc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-E** *seed*, **-\-seed**=*seed*
: Sets the builtin variable **seed** to the value *seed* assuming that *seed*
is in base 10. It is a fatal error if *seed* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files or expressions are given by the **-f**, **-\-file**, **-e**, or
**-\-expression** options, then bc(1) read from **stdin**.
**-\-expression** options, then bc(1) reads from **stdin**.
However, there are a few caveats to this.
@ -350,9 +393,10 @@ it is recommended that those scripts be changed to redirect **stderr** to
# SYNTAX
The syntax for bc(1) programs is mostly C-like, with some differences. This
bc(1) follows the [POSIX standard][1], which is a much more thorough resource
for the language this bc(1) accepts. This section is meant to be a summary and a
listing of all the extensions to the standard.
bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), which is a
much more thorough resource for the language this bc(1) accepts. This section is
meant to be a summary and a listing of all the extensions to the standard.
In the sections below, **E** means expression, **S** means statement, and **I**
means identifier.
@ -805,9 +849,10 @@ The operators will be described in more detail below.
**assignment** operators, which means that **a=b\>c** is interpreted as
**(a=b)\>c**.
Also, unlike the [standard][1] requires, these operators can appear anywhere
any other expressions can be used. This allowance is a
**non-portable extension**.
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can be
used. This allowance is a **non-portable extension**.
**&&**
@ -1054,7 +1099,9 @@ equivalents are given.
## Standard Library
The [standard][1] defines the following functions for the math library:
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) defines the
following functions for the math library:
**s(x)**
@ -1102,7 +1149,8 @@ The [standard][1] defines the following functions for the math library:
The extended library is *not* loaded when the **-s**/**-\-standard** or
**-w**/**-\-warn** options are given since they are not part of the library
defined by the [standard][1].
defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
The extended library is a **non-portable extension**.
@ -1119,12 +1167,14 @@ The extended library is a **non-portable extension**.
**r(x, p)**
: Returns **x** rounded to **p** decimal places according to the rounding mode
[round half away from **0**][3].
round half away from **0**
(https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
**ceil(x, p)**
: Returns **x** rounded to **p** decimal places according to the rounding mode
[round away from **0**][6].
round away from **0**
(https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
**f(x)**
@ -1888,10 +1938,11 @@ The extended library is a **non-portable extension**.
## Transcendental Functions
All transcendental functions can return slightly inaccurate results (up to 1
[ULP][4]). This is unavoidable, and [this article][5] explains why it is
impossible and unnecessary to calculate exact results for the transcendental
functions.
All transcendental functions can return slightly inaccurate results, up to 1 ULP
(https://en.wikipedia.org/wiki/Unit_in_the_last_place). This is unavoidable, and
the article at https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT explains
why it is impossible and unnecessary to calculate exact results for the
transcendental functions.
Because of the possible inaccuracy, I recommend that users call those functions
with the precision (**scale**) set to at least 1 higher than is necessary. If
@ -2134,8 +2185,8 @@ bc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes bc(1) exit
after executing the expressions and expression files, and a non-zero value
makes bc(1) not exit.
after executing the expressions and expression files, and a zero value makes
bc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -2215,10 +2266,12 @@ checking, and its normal behavior can be forced by using the **-i** flag or
# INTERACTIVE MODE
Per the [standard][1], bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both **stdin** and **stdout**
are hooked to a terminal, but the **-i** flag and **-\-interactive** option can
turn it on in other situations.
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), bc(1) has
an interactive mode and a non-interactive mode. Interactive mode is turned on
automatically when both **stdin** and **stdout** are hooked to a terminal, but
the **-i** flag and **-\-interactive** option can turn it on in other
situations.
In interactive mode, bc(1) attempts to recover from errors (see the **RESET**
section), and in normal execution, flushes **stdout** as soon as execution is
@ -2244,8 +2297,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Prompt
@ -2305,9 +2360,10 @@ dc(1)
# STANDARDS
bc(1) is compliant with the [IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1]
specification. The flags **-efghiqsvVw**, all long options, and the extensions
noted above are extensions to that specification.
bc(1) is compliant with the IEEE Std 1003.1-2017 (“POSIX.1-2017”) specification
at https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html . The
flags **-efghiqsvVw**, all long options, and the extensions noted above are
extensions to that specification.
Note that the specification explicitly says that bc(1) only accepts numbers that
use a period (**.**) as a radix point, regardless of the value of
@ -2323,10 +2379,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHORS
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html
[2]: https://www.gnu.org/software/bc/
[3]: https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero
[4]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
[5]: https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT
[6]: https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero

128
contrib/bc/manuals/bc/HN.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "BC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "BC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH NAME
.PP
bc - arbitrary-precision decimal arithmetic language and calculator
@ -38,13 +40,17 @@ bc - arbitrary-precision decimal arithmetic language and calculator
[\f[B]-e\f[R] \f[I]expr\f[R]]
[\f[B]--expression\f[R]=\f[I]expr\f[R]\&...] [\f[B]-f\f[R]
\f[I]file\f[R]\&...] [\f[B]--file\f[R]=\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...] [\f[B]-I\f[R] \f[I]ibase\f[R]]
[\f[B]--ibase\f[R]=\f[I]ibase\f[R]] [\f[B]-O\f[R] \f[I]obase\f[R]]
[\f[B]--obase\f[R]=\f[I]obase\f[R]] [\f[B]-S\f[R] \f[I]scale\f[R]]
[\f[B]--scale\f[R]=\f[I]scale\f[R]] [\f[B]-E\f[R] \f[I]seed\f[R]]
[\f[B]--seed\f[R]=\f[I]seed\f[R]]
.SH DESCRIPTION
.PP
bc(1) is an interactive processor for a language first standardized in
1991 by POSIX.
(The current standard is
here (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).)
(The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .)
The language provides unlimited precision decimal arithmetic and is
somewhat C-like, but there are differences.
Such differences will be noted in this document.
@ -287,26 +293,32 @@ multiple times.
Keywords are \f[I]not\f[R] redefined when parsing the builtin math
library (see the \f[B]LIBRARY\f[R] section).
.PP
It is a fatal error to redefine keywords mandated by the POSIX standard.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
It is a fatal error to attempt to redefine words that this bc(1) does
not reserve as keywords.
.RE
.TP
\f[B]-q\f[R], \f[B]--quiet\f[R]
This option is for compatibility with the GNU
bc(1) (https://www.gnu.org/software/bc/); it is a no-op.
This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op.
Without this option, GNU bc(1) prints a copyright header.
This bc(1) only prints the copyright header if one or more of the
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given.
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given
unless the \f[B]BC_BANNER\f[R] environment variable is set and contains
a non-zero integer or if this bc(1) was built with the header displayed
by default.
If \f[I]any\f[R] of that is the case, then this option \f[I]does\f[R]
prevent bc(1) from printing the header.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-s\f[R], \f[B]--standard\f[R]
Process exactly the language defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
and error if any extensions are used.
Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
@ -382,13 +394,57 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-E\f[R] \f[I]seed\f[R], \f[B]--seed\f[R]=\f[I]seed\f[R]
Sets the builtin variable \f[B]seed\f[R] to the value \f[I]seed\f[R]
assuming that \f[I]seed\f[R] is in base 10.
It is a fatal error if \f[I]seed\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files or expressions are given by the \f[B]-f\f[R],
\f[B]--file\f[R], \f[B]-e\f[R], or \f[B]--expression\f[R] options, then
bc(1) read from \f[B]stdin\f[R].
bc(1) reads from \f[B]stdin\f[R].
.PP
However, there are a few caveats to this.
.PP
@ -435,8 +491,8 @@ redirect \f[B]stderr\f[R] to \f[B]/dev/null\f[R].
.SH SYNTAX
.PP
The syntax for bc(1) programs is mostly C-like, with some differences.
This bc(1) follows the POSIX
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
This bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
which is a much more thorough resource for the language this bc(1)
accepts.
This section is meant to be a summary and a listing of all the
@ -1020,8 +1076,8 @@ Note that unlike in C, these operators have a lower precedence than the
\f[B]assignment\f[R] operators, which means that \f[B]a=b>c\f[R] is
interpreted as \f[B](a=b)>c\f[R].
.PP
Also, unlike the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can
be used.
This allowance is a \f[B]non-portable extension\f[R].
@ -1328,8 +1384,8 @@ when the \f[B]-s\f[R] option, the \f[B]-w\f[R] option, or equivalents
are given.
.SS Standard Library
.PP
The
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
defines the following functions for the math library:
.TP
\f[B]s(x)\f[R]
@ -1385,7 +1441,8 @@ Functions\f[R] subsection below).
The extended library is \f[I]not\f[R] loaded when the
\f[B]-s\f[R]/\f[B]--standard\f[R] or \f[B]-w\f[R]/\f[B]--warn\f[R]
options are given since they are not part of the library defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
.PP
The extended library is a \f[B]non-portable extension\f[R].
.TP
@ -1404,13 +1461,13 @@ Functions\f[R] subsection below).
.TP
\f[B]r(x, p)\f[R]
Returns \f[B]x\f[R] rounded to \f[B]p\f[R] decimal places according to
the rounding mode round half away from
\f[B]0\f[R] (https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
the rounding mode round half away from \f[B]0\f[R]
(https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
.TP
\f[B]ceil(x, p)\f[R]
Returns \f[B]x\f[R] rounded to \f[B]p\f[R] decimal places according to
the rounding mode round away from
\f[B]0\f[R] (https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
the rounding mode round away from \f[B]0\f[R]
(https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
.TP
\f[B]f(x)\f[R]
Returns the factorial of the truncated absolute value of \f[B]x\f[R].
@ -2275,11 +2332,11 @@ subsection of the \f[B]FUNCTIONS\f[R] section).
.RE
.SS Transcendental Functions
.PP
All transcendental functions can return slightly inaccurate results (up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place)).
This is unavoidable, and this
article (https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT) explains
why it is impossible and unnecessary to calculate exact results for the
All transcendental functions can return slightly inaccurate results, up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place).
This is unavoidable, and the article at
https://people.eecs.berkeley.edu/\[ti]wkahan/LOG10HAF.TXT explains why
it is impossible and unnecessary to calculate exact results for the
transcendental functions.
.PP
Because of the possible inaccuracy, I recommend that users call those
@ -2558,8 +2615,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes bc(1) exit after executing the
expressions and expression files, and a non-zero value makes bc(1) not
exit.
expressions and expression files, and a zero value makes bc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -2646,8 +2702,8 @@ checking, and its normal behavior can be forced by using the
\f[B]-i\f[R] flag or \f[B]--interactive\f[R] option.
.SH INTERACTIVE MODE
.PP
Per the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both \f[B]stdin\f[R]
and \f[B]stdout\f[R] are hooked to a terminal, but the \f[B]-i\f[R] flag
@ -2680,8 +2736,8 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
required in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
.SS Prompt
@ -2743,8 +2799,8 @@ dc(1)
.SH STANDARDS
.PP
bc(1) is compliant with the IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
(\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .
The flags \f[B]-efghiqsvVw\f[R], all long options, and the extensions
noted above are extensions to that specification.
.PP

141
contrib/bc/manuals/bc/HN.1.md
View File

@ -34,14 +34,15 @@ bc - arbitrary-precision decimal arithmetic language and calculator
# SYNOPSIS
**bc** [**-ghilPqRsvVw**] [**-\-global-stacks**] [**-\-help**] [**-\-interactive**] [**-\-mathlib**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-quiet**] [**-\-standard**] [**-\-warn**] [**-\-version**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...]
**bc** [**-ghilPqRsvVw**] [**-\-global-stacks**] [**-\-help**] [**-\-interactive**] [**-\-mathlib**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-quiet**] [**-\-standard**] [**-\-warn**] [**-\-version**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...] [**-I** *ibase*] [**-\-ibase**=*ibase*] [**-O** *obase*] [**-\-obase**=*obase*] [**-S** *scale*] [**-\-scale**=*scale*] [**-E** *seed*] [**-\-seed**=*seed*]
# DESCRIPTION
bc(1) is an interactive processor for a language first standardized in 1991 by
POSIX. (The current standard is [here][1].) The language provides unlimited
precision decimal arithmetic and is somewhat C-like, but there are differences.
Such differences will be noted in this document.
POSIX. (The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .) The
language provides unlimited precision decimal arithmetic and is somewhat C-like,
but there are differences. Such differences will be noted in this document.
After parsing and handling options, this bc(1) reads any files given on the
command line and executes them before reading from **stdin**.
@ -223,23 +224,29 @@ The following are the options that bc(1) accepts.
Keywords are *not* redefined when parsing the builtin math library (see the
**LIBRARY** section).
It is a fatal error to redefine keywords mandated by the POSIX standard. It
is a fatal error to attempt to redefine words that this bc(1) does not
reserve as keywords.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html). It is
a fatal error to attempt to redefine words that this bc(1) does not reserve
as keywords.
**-q**, **-\-quiet**
: This option is for compatibility with the [GNU bc(1)][2]; it is a no-op.
Without this option, GNU bc(1) prints a copyright header. This bc(1) only
prints the copyright header if one or more of the **-v**, **-V**, or
**-\-version** options are given.
: This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op. Without this option, GNU
bc(1) prints a copyright header. This bc(1) only prints the copyright header
if one or more of the **-v**, **-V**, or **-\-version** options are given
unless the **BC_BANNER** environment variable is set and contains a non-zero
integer or if this bc(1) was built with the header displayed by default. If
*any* of that is the case, then this option *does* prevent bc(1) from
printing the header.
This is a **non-portable extension**.
**-s**, **-\-standard**
: Process exactly the language defined by the [standard][1] and error if any
extensions are used.
: Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
This is a **non-portable extension**.
@ -299,12 +306,48 @@ The following are the options that bc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-E** *seed*, **-\-seed**=*seed*
: Sets the builtin variable **seed** to the value *seed* assuming that *seed*
is in base 10. It is a fatal error if *seed* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files or expressions are given by the **-f**, **-\-file**, **-e**, or
**-\-expression** options, then bc(1) read from **stdin**.
**-\-expression** options, then bc(1) reads from **stdin**.
However, there are a few caveats to this.
@ -350,9 +393,10 @@ it is recommended that those scripts be changed to redirect **stderr** to
# SYNTAX
The syntax for bc(1) programs is mostly C-like, with some differences. This
bc(1) follows the [POSIX standard][1], which is a much more thorough resource
for the language this bc(1) accepts. This section is meant to be a summary and a
listing of all the extensions to the standard.
bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), which is a
much more thorough resource for the language this bc(1) accepts. This section is
meant to be a summary and a listing of all the extensions to the standard.
In the sections below, **E** means expression, **S** means statement, and **I**
means identifier.
@ -805,9 +849,10 @@ The operators will be described in more detail below.
**assignment** operators, which means that **a=b\>c** is interpreted as
**(a=b)\>c**.
Also, unlike the [standard][1] requires, these operators can appear anywhere
any other expressions can be used. This allowance is a
**non-portable extension**.
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can be
used. This allowance is a **non-portable extension**.
**&&**
@ -1054,7 +1099,9 @@ equivalents are given.
## Standard Library
The [standard][1] defines the following functions for the math library:
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) defines the
following functions for the math library:
**s(x)**
@ -1102,7 +1149,8 @@ The [standard][1] defines the following functions for the math library:
The extended library is *not* loaded when the **-s**/**-\-standard** or
**-w**/**-\-warn** options are given since they are not part of the library
defined by the [standard][1].
defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
The extended library is a **non-portable extension**.
@ -1119,12 +1167,14 @@ The extended library is a **non-portable extension**.
**r(x, p)**
: Returns **x** rounded to **p** decimal places according to the rounding mode
[round half away from **0**][3].
round half away from **0**
(https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
**ceil(x, p)**
: Returns **x** rounded to **p** decimal places according to the rounding mode
[round away from **0**][6].
round away from **0**
(https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
**f(x)**
@ -1888,10 +1938,11 @@ The extended library is a **non-portable extension**.
## Transcendental Functions
All transcendental functions can return slightly inaccurate results (up to 1
[ULP][4]). This is unavoidable, and [this article][5] explains why it is
impossible and unnecessary to calculate exact results for the transcendental
functions.
All transcendental functions can return slightly inaccurate results, up to 1 ULP
(https://en.wikipedia.org/wiki/Unit_in_the_last_place). This is unavoidable, and
the article at https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT explains
why it is impossible and unnecessary to calculate exact results for the
transcendental functions.
Because of the possible inaccuracy, I recommend that users call those functions
with the precision (**scale**) set to at least 1 higher than is necessary. If
@ -2134,8 +2185,8 @@ bc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes bc(1) exit
after executing the expressions and expression files, and a non-zero value
makes bc(1) not exit.
after executing the expressions and expression files, and a zero value makes
bc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -2215,10 +2266,12 @@ checking, and its normal behavior can be forced by using the **-i** flag or
# INTERACTIVE MODE
Per the [standard][1], bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both **stdin** and **stdout**
are hooked to a terminal, but the **-i** flag and **-\-interactive** option can
turn it on in other situations.
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), bc(1) has
an interactive mode and a non-interactive mode. Interactive mode is turned on
automatically when both **stdin** and **stdout** are hooked to a terminal, but
the **-i** flag and **-\-interactive** option can turn it on in other
situations.
In interactive mode, bc(1) attempts to recover from errors (see the **RESET**
section), and in normal execution, flushes **stdout** as soon as execution is
@ -2244,8 +2297,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Prompt
@ -2300,9 +2355,10 @@ dc(1)
# STANDARDS
bc(1) is compliant with the [IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1]
specification. The flags **-efghiqsvVw**, all long options, and the extensions
noted above are extensions to that specification.
bc(1) is compliant with the IEEE Std 1003.1-2017 (“POSIX.1-2017”) specification
at https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html . The
flags **-efghiqsvVw**, all long options, and the extensions noted above are
extensions to that specification.
Note that the specification explicitly says that bc(1) only accepts numbers that
use a period (**.**) as a radix point, regardless of the value of
@ -2315,10 +2371,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHORS
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html
[2]: https://www.gnu.org/software/bc/
[3]: https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero
[4]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
[5]: https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT
[6]: https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero

128
contrib/bc/manuals/bc/N.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "BC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "BC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH NAME
.PP
bc - arbitrary-precision decimal arithmetic language and calculator
@ -38,13 +40,17 @@ bc - arbitrary-precision decimal arithmetic language and calculator
[\f[B]-e\f[R] \f[I]expr\f[R]]
[\f[B]--expression\f[R]=\f[I]expr\f[R]\&...] [\f[B]-f\f[R]
\f[I]file\f[R]\&...] [\f[B]--file\f[R]=\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...] [\f[B]-I\f[R] \f[I]ibase\f[R]]
[\f[B]--ibase\f[R]=\f[I]ibase\f[R]] [\f[B]-O\f[R] \f[I]obase\f[R]]
[\f[B]--obase\f[R]=\f[I]obase\f[R]] [\f[B]-S\f[R] \f[I]scale\f[R]]
[\f[B]--scale\f[R]=\f[I]scale\f[R]] [\f[B]-E\f[R] \f[I]seed\f[R]]
[\f[B]--seed\f[R]=\f[I]seed\f[R]]
.SH DESCRIPTION
.PP
bc(1) is an interactive processor for a language first standardized in
1991 by POSIX.
(The current standard is
here (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).)
(The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .)
The language provides unlimited precision decimal arithmetic and is
somewhat C-like, but there are differences.
Such differences will be noted in this document.
@ -287,26 +293,32 @@ multiple times.
Keywords are \f[I]not\f[R] redefined when parsing the builtin math
library (see the \f[B]LIBRARY\f[R] section).
.PP
It is a fatal error to redefine keywords mandated by the POSIX standard.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
It is a fatal error to attempt to redefine words that this bc(1) does
not reserve as keywords.
.RE
.TP
\f[B]-q\f[R], \f[B]--quiet\f[R]
This option is for compatibility with the GNU
bc(1) (https://www.gnu.org/software/bc/); it is a no-op.
This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op.
Without this option, GNU bc(1) prints a copyright header.
This bc(1) only prints the copyright header if one or more of the
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given.
\f[B]-v\f[R], \f[B]-V\f[R], or \f[B]--version\f[R] options are given
unless the \f[B]BC_BANNER\f[R] environment variable is set and contains
a non-zero integer or if this bc(1) was built with the header displayed
by default.
If \f[I]any\f[R] of that is the case, then this option \f[I]does\f[R]
prevent bc(1) from printing the header.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-s\f[R], \f[B]--standard\f[R]
Process exactly the language defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
and error if any extensions are used.
Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
.RS
.PP
This is a \f[B]non-portable extension\f[R].
@ -382,13 +394,57 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-E\f[R] \f[I]seed\f[R], \f[B]--seed\f[R]=\f[I]seed\f[R]
Sets the builtin variable \f[B]seed\f[R] to the value \f[I]seed\f[R]
assuming that \f[I]seed\f[R] is in base 10.
It is a fatal error if \f[I]seed\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files or expressions are given by the \f[B]-f\f[R],
\f[B]--file\f[R], \f[B]-e\f[R], or \f[B]--expression\f[R] options, then
bc(1) read from \f[B]stdin\f[R].
bc(1) reads from \f[B]stdin\f[R].
.PP
However, there are a few caveats to this.
.PP
@ -435,8 +491,8 @@ redirect \f[B]stderr\f[R] to \f[B]/dev/null\f[R].
.SH SYNTAX
.PP
The syntax for bc(1) programs is mostly C-like, with some differences.
This bc(1) follows the POSIX
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
This bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
which is a much more thorough resource for the language this bc(1)
accepts.
This section is meant to be a summary and a listing of all the
@ -1020,8 +1076,8 @@ Note that unlike in C, these operators have a lower precedence than the
\f[B]assignment\f[R] operators, which means that \f[B]a=b>c\f[R] is
interpreted as \f[B](a=b)>c\f[R].
.PP
Also, unlike the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can
be used.
This allowance is a \f[B]non-portable extension\f[R].
@ -1328,8 +1384,8 @@ when the \f[B]-s\f[R] option, the \f[B]-w\f[R] option, or equivalents
are given.
.SS Standard Library
.PP
The
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
defines the following functions for the math library:
.TP
\f[B]s(x)\f[R]
@ -1385,7 +1441,8 @@ Functions\f[R] subsection below).
The extended library is \f[I]not\f[R] loaded when the
\f[B]-s\f[R]/\f[B]--standard\f[R] or \f[B]-w\f[R]/\f[B]--warn\f[R]
options are given since they are not part of the library defined by the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
.PP
The extended library is a \f[B]non-portable extension\f[R].
.TP
@ -1404,13 +1461,13 @@ Functions\f[R] subsection below).
.TP
\f[B]r(x, p)\f[R]
Returns \f[B]x\f[R] rounded to \f[B]p\f[R] decimal places according to
the rounding mode round half away from
\f[B]0\f[R] (https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
the rounding mode round half away from \f[B]0\f[R]
(https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
.TP
\f[B]ceil(x, p)\f[R]
Returns \f[B]x\f[R] rounded to \f[B]p\f[R] decimal places according to
the rounding mode round away from
\f[B]0\f[R] (https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
the rounding mode round away from \f[B]0\f[R]
(https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
.TP
\f[B]f(x)\f[R]
Returns the factorial of the truncated absolute value of \f[B]x\f[R].
@ -2275,11 +2332,11 @@ subsection of the \f[B]FUNCTIONS\f[R] section).
.RE
.SS Transcendental Functions
.PP
All transcendental functions can return slightly inaccurate results (up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place)).
This is unavoidable, and this
article (https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT) explains
why it is impossible and unnecessary to calculate exact results for the
All transcendental functions can return slightly inaccurate results, up
to 1 ULP (https://en.wikipedia.org/wiki/Unit_in_the_last_place).
This is unavoidable, and the article at
https://people.eecs.berkeley.edu/\[ti]wkahan/LOG10HAF.TXT explains why
it is impossible and unnecessary to calculate exact results for the
transcendental functions.
.PP
Because of the possible inaccuracy, I recommend that users call those
@ -2558,8 +2615,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes bc(1) exit after executing the
expressions and expression files, and a non-zero value makes bc(1) not
exit.
expressions and expression files, and a zero value makes bc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -2646,8 +2702,8 @@ checking, and its normal behavior can be forced by using the
\f[B]-i\f[R] flag or \f[B]--interactive\f[R] option.
.SH INTERACTIVE MODE
.PP
Per the
standard (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both \f[B]stdin\f[R]
and \f[B]stdout\f[R] are hooked to a terminal, but the \f[B]-i\f[R] flag
@ -2680,8 +2736,8 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
required in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
.SS Command-Line History
@ -2772,8 +2828,8 @@ dc(1)
.SH STANDARDS
.PP
bc(1) is compliant with the IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
(\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .
The flags \f[B]-efghiqsvVw\f[R], all long options, and the extensions
noted above are extensions to that specification.
.PP

141
contrib/bc/manuals/bc/N.1.md
View File

@ -34,14 +34,15 @@ bc - arbitrary-precision decimal arithmetic language and calculator
# SYNOPSIS
**bc** [**-ghilPqRsvVw**] [**-\-global-stacks**] [**-\-help**] [**-\-interactive**] [**-\-mathlib**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-quiet**] [**-\-standard**] [**-\-warn**] [**-\-version**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...]
**bc** [**-ghilPqRsvVw**] [**-\-global-stacks**] [**-\-help**] [**-\-interactive**] [**-\-mathlib**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-quiet**] [**-\-standard**] [**-\-warn**] [**-\-version**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...] [**-I** *ibase*] [**-\-ibase**=*ibase*] [**-O** *obase*] [**-\-obase**=*obase*] [**-S** *scale*] [**-\-scale**=*scale*] [**-E** *seed*] [**-\-seed**=*seed*]
# DESCRIPTION
bc(1) is an interactive processor for a language first standardized in 1991 by
POSIX. (The current standard is [here][1].) The language provides unlimited
precision decimal arithmetic and is somewhat C-like, but there are differences.
Such differences will be noted in this document.
POSIX. (The current standard is at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html .) The
language provides unlimited precision decimal arithmetic and is somewhat C-like,
but there are differences. Such differences will be noted in this document.
After parsing and handling options, this bc(1) reads any files given on the
command line and executes them before reading from **stdin**.
@ -223,23 +224,29 @@ The following are the options that bc(1) accepts.
Keywords are *not* redefined when parsing the builtin math library (see the
**LIBRARY** section).
It is a fatal error to redefine keywords mandated by the POSIX standard. It
is a fatal error to attempt to redefine words that this bc(1) does not
reserve as keywords.
It is a fatal error to redefine keywords mandated by the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html). It is
a fatal error to attempt to redefine words that this bc(1) does not reserve
as keywords.
**-q**, **-\-quiet**
: This option is for compatibility with the [GNU bc(1)][2]; it is a no-op.
Without this option, GNU bc(1) prints a copyright header. This bc(1) only
prints the copyright header if one or more of the **-v**, **-V**, or
**-\-version** options are given.
: This option is for compatibility with the GNU bc(1)
(https://www.gnu.org/software/bc/); it is a no-op. Without this option, GNU
bc(1) prints a copyright header. This bc(1) only prints the copyright header
if one or more of the **-v**, **-V**, or **-\-version** options are given
unless the **BC_BANNER** environment variable is set and contains a non-zero
integer or if this bc(1) was built with the header displayed by default. If
*any* of that is the case, then this option *does* prevent bc(1) from
printing the header.
This is a **non-portable extension**.
**-s**, **-\-standard**
: Process exactly the language defined by the [standard][1] and error if any
extensions are used.
: Process exactly the language defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) and
error if any extensions are used.
This is a **non-portable extension**.
@ -299,12 +306,48 @@ The following are the options that bc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-E** *seed*, **-\-seed**=*seed*
: Sets the builtin variable **seed** to the value *seed* assuming that *seed*
is in base 10. It is a fatal error if *seed* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files or expressions are given by the **-f**, **-\-file**, **-e**, or
**-\-expression** options, then bc(1) read from **stdin**.
**-\-expression** options, then bc(1) reads from **stdin**.
However, there are a few caveats to this.
@ -350,9 +393,10 @@ it is recommended that those scripts be changed to redirect **stderr** to
# SYNTAX
The syntax for bc(1) programs is mostly C-like, with some differences. This
bc(1) follows the [POSIX standard][1], which is a much more thorough resource
for the language this bc(1) accepts. This section is meant to be a summary and a
listing of all the extensions to the standard.
bc(1) follows the POSIX standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), which is a
much more thorough resource for the language this bc(1) accepts. This section is
meant to be a summary and a listing of all the extensions to the standard.
In the sections below, **E** means expression, **S** means statement, and **I**
means identifier.
@ -805,9 +849,10 @@ The operators will be described in more detail below.
**assignment** operators, which means that **a=b\>c** is interpreted as
**(a=b)\>c**.
Also, unlike the [standard][1] requires, these operators can appear anywhere
any other expressions can be used. This allowance is a
**non-portable extension**.
Also, unlike the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
requires, these operators can appear anywhere any other expressions can be
used. This allowance is a **non-portable extension**.
**&&**
@ -1054,7 +1099,9 @@ equivalents are given.
## Standard Library
The [standard][1] defines the following functions for the math library:
The standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) defines the
following functions for the math library:
**s(x)**
@ -1102,7 +1149,8 @@ The [standard][1] defines the following functions for the math library:
The extended library is *not* loaded when the **-s**/**-\-standard** or
**-w**/**-\-warn** options are given since they are not part of the library
defined by the [standard][1].
defined by the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html).
The extended library is a **non-portable extension**.
@ -1119,12 +1167,14 @@ The extended library is a **non-portable extension**.
**r(x, p)**
: Returns **x** rounded to **p** decimal places according to the rounding mode
[round half away from **0**][3].
round half away from **0**
(https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero).
**ceil(x, p)**
: Returns **x** rounded to **p** decimal places according to the rounding mode
[round away from **0**][6].
round away from **0**
(https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero).
**f(x)**
@ -1888,10 +1938,11 @@ The extended library is a **non-portable extension**.
## Transcendental Functions
All transcendental functions can return slightly inaccurate results (up to 1
[ULP][4]). This is unavoidable, and [this article][5] explains why it is
impossible and unnecessary to calculate exact results for the transcendental
functions.
All transcendental functions can return slightly inaccurate results, up to 1 ULP
(https://en.wikipedia.org/wiki/Unit_in_the_last_place). This is unavoidable, and
the article at https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT explains
why it is impossible and unnecessary to calculate exact results for the
transcendental functions.
Because of the possible inaccuracy, I recommend that users call those functions
with the precision (**scale**) set to at least 1 higher than is necessary. If
@ -2134,8 +2185,8 @@ bc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes bc(1) exit
after executing the expressions and expression files, and a non-zero value
makes bc(1) not exit.
after executing the expressions and expression files, and a zero value makes
bc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -2215,10 +2266,12 @@ checking, and its normal behavior can be forced by using the **-i** flag or
# INTERACTIVE MODE
Per the [standard][1], bc(1) has an interactive mode and a non-interactive mode.
Interactive mode is turned on automatically when both **stdin** and **stdout**
are hooked to a terminal, but the **-i** flag and **-\-interactive** option can
turn it on in other situations.
Per the standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), bc(1) has
an interactive mode and a non-interactive mode. Interactive mode is turned on
automatically when both **stdin** and **stdout** are hooked to a terminal, but
the **-i** flag and **-\-interactive** option can turn it on in other
situations.
In interactive mode, bc(1) attempts to recover from errors (see the **RESET**
section), and in normal execution, flushes **stdout** as soon as execution is
@ -2244,8 +2297,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) standard
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html), and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Command-Line History
@ -2326,9 +2381,10 @@ dc(1)
# STANDARDS
bc(1) is compliant with the [IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1]
specification. The flags **-efghiqsvVw**, all long options, and the extensions
noted above are extensions to that specification.
bc(1) is compliant with the IEEE Std 1003.1-2017 (“POSIX.1-2017”) specification
at https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html . The
flags **-efghiqsvVw**, all long options, and the extensions noted above are
extensions to that specification.
Note that the specification explicitly says that bc(1) only accepts numbers that
use a period (**.**) as a radix point, regardless of the value of
@ -2341,10 +2397,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHORS
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html
[2]: https://www.gnu.org/software/bc/
[3]: https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero
[4]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
[5]: https://people.eecs.berkeley.edu/~wkahan/LOG10HAF.TXT
[6]: https://en.wikipedia.org/wiki/Rounding#Rounding_away_from_zero

16
contrib/bc/manuals/bcl.3
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "BCL" "3" "June 2021" "Gavin D. Howard" "Libraries Manual"
.TH "BCL" "3" "June 2022" "Gavin D. Howard" "Libraries Manual"
.nh
.ad l
.SH NAME
.PP
bcl - library of arbitrary precision decimal arithmetic
@ -228,9 +230,9 @@ generator in bcl(3).
.SH DESCRIPTION
.PP
bcl(3) is a library that implements arbitrary-precision decimal math, as
standardized by
POSIX (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
in bc(1).
standardized by POSIX
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) in
bc(1).
.PP
bcl(3) is async-signal-safe if
\f[B]bcl_handleSignal(\f[R]\f[I]void\f[R]\f[B])\f[R] is used properly.
@ -1376,9 +1378,9 @@ bc(1) and dc(1)
.SH STANDARDS
.PP
bcl(3) is compliant with the arithmetic defined in the IEEE Std
1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification for bc(1).
1003.1-2017 (\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for
bc(1).
.PP
Note that the specification explicitly says that bc(1) only accepts
numbers that use a period (\f[B].\f[R]) as a radix point, regardless of

10
contrib/bc/manuals/bcl.3.md
View File

@ -215,7 +215,8 @@ generator in bcl(3).
# DESCRIPTION
bcl(3) is a library that implements arbitrary-precision decimal math, as
[standardized by POSIX][1] in bc(1).
standardized by POSIX
(https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html) in bc(1).
bcl(3) is async-signal-safe if **bcl_handleSignal(**_void_**)** is used
properly. (See the **SIGNAL HANDLING** section.)
@ -1184,8 +1185,9 @@ bc(1) and dc(1)
# STANDARDS
bcl(3) is compliant with the arithmetic defined in the
[IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1] specification for bc(1).
bcl(3) is compliant with the arithmetic defined in the IEEE Std 1003.1-2017
(“POSIX.1-2017”) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for bc(1).
Note that the specification explicitly says that bc(1) only accepts numbers that
use a period (**.**) as a radix point, regardless of the value of
@ -1198,5 +1200,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHORS
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html

39
contrib/bc/manuals/build.md
View File

@ -46,7 +46,7 @@ However, if you wish to build it yourself, this `bc` can be built using Visual
Studio or MSBuild.
Unfortunately, only one build configuration (besides Debug or Release) is
supported: extra math enabled, history and NLS (locale support) disabled, with
supported: extra math and history enabled, NLS (locale support) disabled, with
both calculators built. The default [settings][11] are `BC_BANNER=1`,
`{BC,DC}_SIGINT_RESET=0`, `{BC,DC}_TTY_MODE=1`, `{BC,DC}_PROMPT=1`.
@ -424,15 +424,46 @@ to `configure.sh`, as follows:
Both commands are equivalent.
History is automatically disabled when building for Windows or on another
platform that does not support the terminal handling that is required.
***WARNING***: Of all of the code in the `bc`, this is the only code that is not
completely portable. If the `bc` does not work on your platform, your first step
should be to retry with history disabled.
This option affects the [build type][7].
##### Editline
History support can be provided by editline, in order to implement `vi`-like
keybindings and other features.
To enable editline support pass either the `-e` flag or the `--enable-editline`
option to `configure.sh`, as follows:
```
./configure.sh -e
./configure.sh --enable-editline
```
Both commands are equivalent.
This is ignored if history is disabled.
##### Readline
History support can be provided by readline, in order to implement `vi`-like
keybindings and other features.
To enable readline support pass either the `-r` flag or the `--enable-readline`
option to `configure.sh`, as follows:
```
./configure.sh -r
./configure.sh --enable-readline
```
Both commands are equivalent.
This is ignored if history is disabled.
#### NLS (Locale Support)
To disable locale support (use only English), pass either the `-N` flag or the

77
contrib/bc/manuals/dc/A.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "DC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "DC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH Name
.PP
dc - arbitrary-precision decimal reverse-Polish notation calculator
@ -37,7 +39,11 @@ dc - arbitrary-precision decimal reverse-Polish notation calculator
[\f[B]-e\f[R] \f[I]expr\f[R]]
[\f[B]--expression\f[R]=\f[I]expr\f[R]\&...] [\f[B]-f\f[R]
\f[I]file\f[R]\&...] [\f[B]--file\f[R]=\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...] [\f[B]-I\f[R] \f[I]ibase\f[R]]
[\f[B]--ibase\f[R]=\f[I]ibase\f[R]] [\f[B]-O\f[R] \f[I]obase\f[R]]
[\f[B]--obase\f[R]=\f[I]obase\f[R]] [\f[B]-S\f[R] \f[I]scale\f[R]]
[\f[B]--scale\f[R]=\f[I]scale\f[R]] [\f[B]-E\f[R] \f[I]seed\f[R]]
[\f[B]--seed\f[R]=\f[I]seed\f[R]]
.SH DESCRIPTION
.PP
dc(1) is an arbitrary-precision calculator.
@ -129,7 +135,7 @@ This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-z\f[R], \f[B]--leading-zeroes\f[R]
Makes bc(1) print all numbers greater than \f[B]-1\f[R] and less than
Makes dc(1) print all numbers greater than \f[B]-1\f[R] and less than
\f[B]1\f[R], and not equal to \f[B]0\f[R], with a leading zero.
.RS
.PP
@ -182,13 +188,57 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-E\f[R] \f[I]seed\f[R], \f[B]--seed\f[R]=\f[I]seed\f[R]
Sets the builtin variable \f[B]seed\f[R] to the value \f[I]seed\f[R]
assuming that \f[I]seed\f[R] is in base 10.
It is a fatal error if \f[I]seed\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files are given on the command-line and no files or expressions
are given by the \f[B]-f\f[R], \f[B]--file\f[R], \f[B]-e\f[R], or
\f[B]--expression\f[R] options, then dc(1) read from \f[B]stdin\f[R].
\f[B]--expression\f[R] options, then dc(1) reads from \f[B]stdin\f[R].
.PP
However, there is a caveat to this.
.PP
@ -1346,8 +1396,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes dc(1) exit after executing the
expressions and expression files, and a non-zero value makes dc(1) not
exit.
expressions and expression files, and a zero value makes dc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1456,10 +1505,10 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
required in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R] to
be connected to a terminal.
.SS Command-Line History
.PP
Command-line history is only enabled if TTY mode is, i.e., that
@ -1548,10 +1597,10 @@ locales and thus, supports \f[B]LC_MESSAGES\f[R].
bc(1)
.SH STANDARDS
.PP
The dc(1) utility operators are compliant with the operators in the
bc(1) IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
The dc(1) utility operators are compliant with the operators in the IEEE
Std 1003.1-2017 (\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for
bc(1).
.SH BUGS
.PP
None are known.

59
contrib/bc/manuals/dc/A.1.md
View File

@ -34,7 +34,7 @@ dc - arbitrary-precision decimal reverse-Polish notation calculator
# SYNOPSIS
**dc** [**-hiPRvVx**] [**-\-version**] [**-\-help**] [**-\-interactive**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-extended-register**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...]
**dc** [**-hiPRvVx**] [**-\-version**] [**-\-help**] [**-\-interactive**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-extended-register**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...] [**-I** *ibase*] [**-\-ibase**=*ibase*] [**-O** *obase*] [**-\-obase**=*obase*] [**-S** *scale*] [**-\-scale**=*scale*] [**-E** *seed*] [**-\-seed**=*seed*]
# DESCRIPTION
@ -116,7 +116,7 @@ The following are the options that dc(1) accepts.
**-z**, **-\-leading-zeroes**
: Makes bc(1) print all numbers greater than **-1** and less than **1**, and
: Makes dc(1) print all numbers greater than **-1** and less than **1**, and
not equal to **0**, with a leading zero.
This can be set for individual numbers with the **plz(x)**, plznl(x)**,
@ -157,13 +157,49 @@ The following are the options that dc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-E** *seed*, **-\-seed**=*seed*
: Sets the builtin variable **seed** to the value *seed* assuming that *seed*
is in base 10. It is a fatal error if *seed* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files are given on the command-line and no files or expressions are given
by the **-f**, **-\-file**, **-e**, or **-\-expression** options, then dc(1)
read from **stdin**.
reads from **stdin**.
However, there is a caveat to this.
@ -1195,8 +1231,8 @@ dc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes dc(1) exit
after executing the expressions and expression files, and a non-zero value
makes dc(1) not exit.
after executing the expressions and expression files, and a zero value makes
dc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1297,8 +1333,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Command-Line History
@ -1381,8 +1419,9 @@ bc(1)
# STANDARDS
The dc(1) utility operators are compliant with the operators in the bc(1)
[IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1] specification.
The dc(1) utility operators are compliant with the operators in the IEEE Std
1003.1-2017 (“POSIX.1-2017”) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for bc(1).
# BUGS
@ -1391,5 +1430,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHOR
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html

60
contrib/bc/manuals/dc/E.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "DC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "DC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH Name
.PP
dc - arbitrary-precision decimal reverse-Polish notation calculator
@ -129,7 +131,7 @@ This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-z\f[R], \f[B]--leading-zeroes\f[R]
Makes bc(1) print all numbers greater than \f[B]-1\f[R] and less than
Makes dc(1) print all numbers greater than \f[B]-1\f[R] and less than
\f[B]1\f[R], and not equal to \f[B]0\f[R], with a leading zero.
.RS
.PP
@ -182,13 +184,46 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files are given on the command-line and no files or expressions
are given by the \f[B]-f\f[R], \f[B]--file\f[R], \f[B]-e\f[R], or
\f[B]--expression\f[R] options, then dc(1) read from \f[B]stdin\f[R].
\f[B]--expression\f[R] options, then dc(1) reads from \f[B]stdin\f[R].
.PP
However, there is a caveat to this.
.PP
@ -1141,8 +1176,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes dc(1) exit after executing the
expressions and expression files, and a non-zero value makes dc(1) not
exit.
expressions and expression files, and a zero value makes dc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1249,10 +1283,10 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
required in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R] to
be connected to a terminal.
.SS Command-Line History
.PP
Command-line history is only enabled if TTY mode is, i.e., that
@ -1341,10 +1375,10 @@ locales and thus, supports \f[B]LC_MESSAGES\f[R].
bc(1)
.SH STANDARDS
.PP
The dc(1) utility operators are compliant with the operators in the
bc(1) IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
The dc(1) utility operators are compliant with the operators in the IEEE
Std 1003.1-2017 (\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for
bc(1).
.SH BUGS
.PP
None are known.

48
contrib/bc/manuals/dc/E.1.md
View File

@ -116,7 +116,7 @@ The following are the options that dc(1) accepts.
**-z**, **-\-leading-zeroes**
: Makes bc(1) print all numbers greater than **-1** and less than **1**, and
: Makes dc(1) print all numbers greater than **-1** and less than **1**, and
not equal to **0**, with a leading zero.
This can be set for individual numbers with the **plz(x)**, plznl(x)**,
@ -157,13 +157,40 @@ The following are the options that dc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files are given on the command-line and no files or expressions are given
by the **-f**, **-\-file**, **-e**, or **-\-expression** options, then dc(1)
read from **stdin**.
reads from **stdin**.
However, there is a caveat to this.
@ -1030,8 +1057,8 @@ dc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes dc(1) exit
after executing the expressions and expression files, and a non-zero value
makes dc(1) not exit.
after executing the expressions and expression files, and a zero value makes
dc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1130,8 +1157,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Command-Line History
@ -1214,8 +1243,9 @@ bc(1)
# STANDARDS
The dc(1) utility operators are compliant with the operators in the bc(1)
[IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1] specification.
The dc(1) utility operators are compliant with the operators in the IEEE Std
1003.1-2017 (“POSIX.1-2017”) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for bc(1).
# BUGS
@ -1224,5 +1254,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHOR
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html

60
contrib/bc/manuals/dc/EH.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "DC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "DC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH Name
.PP
dc - arbitrary-precision decimal reverse-Polish notation calculator
@ -129,7 +131,7 @@ This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-z\f[R], \f[B]--leading-zeroes\f[R]
Makes bc(1) print all numbers greater than \f[B]-1\f[R] and less than
Makes dc(1) print all numbers greater than \f[B]-1\f[R] and less than
\f[B]1\f[R], and not equal to \f[B]0\f[R], with a leading zero.
.RS
.PP
@ -182,13 +184,46 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files are given on the command-line and no files or expressions
are given by the \f[B]-f\f[R], \f[B]--file\f[R], \f[B]-e\f[R], or
\f[B]--expression\f[R] options, then dc(1) read from \f[B]stdin\f[R].
\f[B]--expression\f[R] options, then dc(1) reads from \f[B]stdin\f[R].
.PP
However, there is a caveat to this.
.PP
@ -1141,8 +1176,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes dc(1) exit after executing the
expressions and expression files, and a non-zero value makes dc(1) not
exit.
expressions and expression files, and a zero value makes dc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1249,10 +1283,10 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
required in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R] to
be connected to a terminal.
.SS Prompt
.PP
If TTY mode is available, then a prompt can be enabled.
@ -1315,10 +1349,10 @@ locales and thus, supports \f[B]LC_MESSAGES\f[R].
bc(1)
.SH STANDARDS
.PP
The dc(1) utility operators are compliant with the operators in the
bc(1) IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
The dc(1) utility operators are compliant with the operators in the IEEE
Std 1003.1-2017 (\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for
bc(1).
.SH BUGS
.PP
None are known.

48
contrib/bc/manuals/dc/EH.1.md
View File

@ -116,7 +116,7 @@ The following are the options that dc(1) accepts.
**-z**, **-\-leading-zeroes**
: Makes bc(1) print all numbers greater than **-1** and less than **1**, and
: Makes dc(1) print all numbers greater than **-1** and less than **1**, and
not equal to **0**, with a leading zero.
This can be set for individual numbers with the **plz(x)**, plznl(x)**,
@ -157,13 +157,40 @@ The following are the options that dc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files are given on the command-line and no files or expressions are given
by the **-f**, **-\-file**, **-e**, or **-\-expression** options, then dc(1)
read from **stdin**.
reads from **stdin**.
However, there is a caveat to this.
@ -1030,8 +1057,8 @@ dc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes dc(1) exit
after executing the expressions and expression files, and a non-zero value
makes dc(1) not exit.
after executing the expressions and expression files, and a zero value makes
dc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1130,8 +1157,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Prompt
@ -1191,8 +1220,9 @@ bc(1)
# STANDARDS
The dc(1) utility operators are compliant with the operators in the bc(1)
[IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1] specification.
The dc(1) utility operators are compliant with the operators in the IEEE Std
1003.1-2017 (“POSIX.1-2017”) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for bc(1).
# BUGS
@ -1201,5 +1231,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHOR
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html

60
contrib/bc/manuals/dc/EHN.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "DC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "DC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH Name
.PP
dc - arbitrary-precision decimal reverse-Polish notation calculator
@ -129,7 +131,7 @@ This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-z\f[R], \f[B]--leading-zeroes\f[R]
Makes bc(1) print all numbers greater than \f[B]-1\f[R] and less than
Makes dc(1) print all numbers greater than \f[B]-1\f[R] and less than
\f[B]1\f[R], and not equal to \f[B]0\f[R], with a leading zero.
.RS
.PP
@ -182,13 +184,46 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files are given on the command-line and no files or expressions
are given by the \f[B]-f\f[R], \f[B]--file\f[R], \f[B]-e\f[R], or
\f[B]--expression\f[R] options, then dc(1) read from \f[B]stdin\f[R].
\f[B]--expression\f[R] options, then dc(1) reads from \f[B]stdin\f[R].
.PP
However, there is a caveat to this.
.PP
@ -1141,8 +1176,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes dc(1) exit after executing the
expressions and expression files, and a non-zero value makes dc(1) not
exit.
expressions and expression files, and a zero value makes dc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1249,10 +1283,10 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
required in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R] to
be connected to a terminal.
.SS Prompt
.PP
If TTY mode is available, then a prompt can be enabled.
@ -1311,10 +1345,10 @@ exit, and it uses the default handler for all other signals.
bc(1)
.SH STANDARDS
.PP
The dc(1) utility operators are compliant with the operators in the
bc(1) IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
The dc(1) utility operators are compliant with the operators in the IEEE
Std 1003.1-2017 (\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for
bc(1).
.SH BUGS
.PP
None are known.

48
contrib/bc/manuals/dc/EHN.1.md
View File

@ -116,7 +116,7 @@ The following are the options that dc(1) accepts.
**-z**, **-\-leading-zeroes**
: Makes bc(1) print all numbers greater than **-1** and less than **1**, and
: Makes dc(1) print all numbers greater than **-1** and less than **1**, and
not equal to **0**, with a leading zero.
This can be set for individual numbers with the **plz(x)**, plznl(x)**,
@ -157,13 +157,40 @@ The following are the options that dc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files are given on the command-line and no files or expressions are given
by the **-f**, **-\-file**, **-e**, or **-\-expression** options, then dc(1)
read from **stdin**.
reads from **stdin**.
However, there is a caveat to this.
@ -1030,8 +1057,8 @@ dc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes dc(1) exit
after executing the expressions and expression files, and a non-zero value
makes dc(1) not exit.
after executing the expressions and expression files, and a zero value makes
dc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1130,8 +1157,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Prompt
@ -1186,8 +1215,9 @@ bc(1)
# STANDARDS
The dc(1) utility operators are compliant with the operators in the bc(1)
[IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1] specification.
The dc(1) utility operators are compliant with the operators in the IEEE Std
1003.1-2017 (“POSIX.1-2017”) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for bc(1).
# BUGS
@ -1196,5 +1226,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHOR
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html

60
contrib/bc/manuals/dc/EN.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "DC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "DC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH Name
.PP
dc - arbitrary-precision decimal reverse-Polish notation calculator
@ -129,7 +131,7 @@ This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-z\f[R], \f[B]--leading-zeroes\f[R]
Makes bc(1) print all numbers greater than \f[B]-1\f[R] and less than
Makes dc(1) print all numbers greater than \f[B]-1\f[R] and less than
\f[B]1\f[R], and not equal to \f[B]0\f[R], with a leading zero.
.RS
.PP
@ -182,13 +184,46 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files are given on the command-line and no files or expressions
are given by the \f[B]-f\f[R], \f[B]--file\f[R], \f[B]-e\f[R], or
\f[B]--expression\f[R] options, then dc(1) read from \f[B]stdin\f[R].
\f[B]--expression\f[R] options, then dc(1) reads from \f[B]stdin\f[R].
.PP
However, there is a caveat to this.
.PP
@ -1141,8 +1176,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes dc(1) exit after executing the
expressions and expression files, and a non-zero value makes dc(1) not
exit.
expressions and expression files, and a zero value makes dc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1249,10 +1283,10 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
required in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R] to
be connected to a terminal.
.SS Command-Line History
.PP
Command-line history is only enabled if TTY mode is, i.e., that
@ -1337,10 +1371,10 @@ section).
bc(1)
.SH STANDARDS
.PP
The dc(1) utility operators are compliant with the operators in the
bc(1) IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
The dc(1) utility operators are compliant with the operators in the IEEE
Std 1003.1-2017 (\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for
bc(1).
.SH BUGS
.PP
None are known.

48
contrib/bc/manuals/dc/EN.1.md
View File

@ -116,7 +116,7 @@ The following are the options that dc(1) accepts.
**-z**, **-\-leading-zeroes**
: Makes bc(1) print all numbers greater than **-1** and less than **1**, and
: Makes dc(1) print all numbers greater than **-1** and less than **1**, and
not equal to **0**, with a leading zero.
This can be set for individual numbers with the **plz(x)**, plznl(x)**,
@ -157,13 +157,40 @@ The following are the options that dc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files are given on the command-line and no files or expressions are given
by the **-f**, **-\-file**, **-e**, or **-\-expression** options, then dc(1)
read from **stdin**.
reads from **stdin**.
However, there is a caveat to this.
@ -1030,8 +1057,8 @@ dc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes dc(1) exit
after executing the expressions and expression files, and a non-zero value
makes dc(1) not exit.
after executing the expressions and expression files, and a zero value makes
dc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1130,8 +1157,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Command-Line History
@ -1209,8 +1238,9 @@ bc(1)
# STANDARDS
The dc(1) utility operators are compliant with the operators in the bc(1)
[IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1] specification.
The dc(1) utility operators are compliant with the operators in the IEEE Std
1003.1-2017 (“POSIX.1-2017”) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for bc(1).
# BUGS
@ -1219,5 +1249,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHOR
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html

77
contrib/bc/manuals/dc/H.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "DC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "DC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH Name
.PP
dc - arbitrary-precision decimal reverse-Polish notation calculator
@ -37,7 +39,11 @@ dc - arbitrary-precision decimal reverse-Polish notation calculator
[\f[B]-e\f[R] \f[I]expr\f[R]]
[\f[B]--expression\f[R]=\f[I]expr\f[R]\&...] [\f[B]-f\f[R]
\f[I]file\f[R]\&...] [\f[B]--file\f[R]=\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...] [\f[B]-I\f[R] \f[I]ibase\f[R]]
[\f[B]--ibase\f[R]=\f[I]ibase\f[R]] [\f[B]-O\f[R] \f[I]obase\f[R]]
[\f[B]--obase\f[R]=\f[I]obase\f[R]] [\f[B]-S\f[R] \f[I]scale\f[R]]
[\f[B]--scale\f[R]=\f[I]scale\f[R]] [\f[B]-E\f[R] \f[I]seed\f[R]]
[\f[B]--seed\f[R]=\f[I]seed\f[R]]
.SH DESCRIPTION
.PP
dc(1) is an arbitrary-precision calculator.
@ -129,7 +135,7 @@ This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-z\f[R], \f[B]--leading-zeroes\f[R]
Makes bc(1) print all numbers greater than \f[B]-1\f[R] and less than
Makes dc(1) print all numbers greater than \f[B]-1\f[R] and less than
\f[B]1\f[R], and not equal to \f[B]0\f[R], with a leading zero.
.RS
.PP
@ -182,13 +188,57 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-E\f[R] \f[I]seed\f[R], \f[B]--seed\f[R]=\f[I]seed\f[R]
Sets the builtin variable \f[B]seed\f[R] to the value \f[I]seed\f[R]
assuming that \f[I]seed\f[R] is in base 10.
It is a fatal error if \f[I]seed\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files are given on the command-line and no files or expressions
are given by the \f[B]-f\f[R], \f[B]--file\f[R], \f[B]-e\f[R], or
\f[B]--expression\f[R] options, then dc(1) read from \f[B]stdin\f[R].
\f[B]--expression\f[R] options, then dc(1) reads from \f[B]stdin\f[R].
.PP
However, there is a caveat to this.
.PP
@ -1346,8 +1396,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes dc(1) exit after executing the
expressions and expression files, and a non-zero value makes dc(1) not
exit.
expressions and expression files, and a zero value makes dc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1456,10 +1505,10 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
required in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R] to
be connected to a terminal.
.SS Prompt
.PP
If TTY mode is available, then a prompt can be enabled.
@ -1522,10 +1571,10 @@ locales and thus, supports \f[B]LC_MESSAGES\f[R].
bc(1)
.SH STANDARDS
.PP
The dc(1) utility operators are compliant with the operators in the
bc(1) IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
The dc(1) utility operators are compliant with the operators in the IEEE
Std 1003.1-2017 (\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for
bc(1).
.SH BUGS
.PP
None are known.

59
contrib/bc/manuals/dc/H.1.md
View File

@ -34,7 +34,7 @@ dc - arbitrary-precision decimal reverse-Polish notation calculator
# SYNOPSIS
**dc** [**-hiPRvVx**] [**-\-version**] [**-\-help**] [**-\-interactive**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-extended-register**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...]
**dc** [**-hiPRvVx**] [**-\-version**] [**-\-help**] [**-\-interactive**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-extended-register**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...] [**-I** *ibase*] [**-\-ibase**=*ibase*] [**-O** *obase*] [**-\-obase**=*obase*] [**-S** *scale*] [**-\-scale**=*scale*] [**-E** *seed*] [**-\-seed**=*seed*]
# DESCRIPTION
@ -116,7 +116,7 @@ The following are the options that dc(1) accepts.
**-z**, **-\-leading-zeroes**
: Makes bc(1) print all numbers greater than **-1** and less than **1**, and
: Makes dc(1) print all numbers greater than **-1** and less than **1**, and
not equal to **0**, with a leading zero.
This can be set for individual numbers with the **plz(x)**, plznl(x)**,
@ -157,13 +157,49 @@ The following are the options that dc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-E** *seed*, **-\-seed**=*seed*
: Sets the builtin variable **seed** to the value *seed* assuming that *seed*
is in base 10. It is a fatal error if *seed* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files are given on the command-line and no files or expressions are given
by the **-f**, **-\-file**, **-e**, or **-\-expression** options, then dc(1)
read from **stdin**.
reads from **stdin**.
However, there is a caveat to this.
@ -1195,8 +1231,8 @@ dc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes dc(1) exit
after executing the expressions and expression files, and a non-zero value
makes dc(1) not exit.
after executing the expressions and expression files, and a zero value makes
dc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1297,8 +1333,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Prompt
@ -1358,8 +1396,9 @@ bc(1)
# STANDARDS
The dc(1) utility operators are compliant with the operators in the bc(1)
[IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1] specification.
The dc(1) utility operators are compliant with the operators in the IEEE Std
1003.1-2017 (“POSIX.1-2017”) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for bc(1).
# BUGS
@ -1368,5 +1407,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHOR
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html

77
contrib/bc/manuals/dc/HN.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "DC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "DC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH Name
.PP
dc - arbitrary-precision decimal reverse-Polish notation calculator
@ -37,7 +39,11 @@ dc - arbitrary-precision decimal reverse-Polish notation calculator
[\f[B]-e\f[R] \f[I]expr\f[R]]
[\f[B]--expression\f[R]=\f[I]expr\f[R]\&...] [\f[B]-f\f[R]
\f[I]file\f[R]\&...] [\f[B]--file\f[R]=\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...] [\f[B]-I\f[R] \f[I]ibase\f[R]]
[\f[B]--ibase\f[R]=\f[I]ibase\f[R]] [\f[B]-O\f[R] \f[I]obase\f[R]]
[\f[B]--obase\f[R]=\f[I]obase\f[R]] [\f[B]-S\f[R] \f[I]scale\f[R]]
[\f[B]--scale\f[R]=\f[I]scale\f[R]] [\f[B]-E\f[R] \f[I]seed\f[R]]
[\f[B]--seed\f[R]=\f[I]seed\f[R]]
.SH DESCRIPTION
.PP
dc(1) is an arbitrary-precision calculator.
@ -129,7 +135,7 @@ This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-z\f[R], \f[B]--leading-zeroes\f[R]
Makes bc(1) print all numbers greater than \f[B]-1\f[R] and less than
Makes dc(1) print all numbers greater than \f[B]-1\f[R] and less than
\f[B]1\f[R], and not equal to \f[B]0\f[R], with a leading zero.
.RS
.PP
@ -182,13 +188,57 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-E\f[R] \f[I]seed\f[R], \f[B]--seed\f[R]=\f[I]seed\f[R]
Sets the builtin variable \f[B]seed\f[R] to the value \f[I]seed\f[R]
assuming that \f[I]seed\f[R] is in base 10.
It is a fatal error if \f[I]seed\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files are given on the command-line and no files or expressions
are given by the \f[B]-f\f[R], \f[B]--file\f[R], \f[B]-e\f[R], or
\f[B]--expression\f[R] options, then dc(1) read from \f[B]stdin\f[R].
\f[B]--expression\f[R] options, then dc(1) reads from \f[B]stdin\f[R].
.PP
However, there is a caveat to this.
.PP
@ -1346,8 +1396,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes dc(1) exit after executing the
expressions and expression files, and a non-zero value makes dc(1) not
exit.
expressions and expression files, and a zero value makes dc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1456,10 +1505,10 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
required in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R] to
be connected to a terminal.
.SS Prompt
.PP
If TTY mode is available, then a prompt can be enabled.
@ -1518,10 +1567,10 @@ exit, and it uses the default handler for all other signals.
bc(1)
.SH STANDARDS
.PP
The dc(1) utility operators are compliant with the operators in the
bc(1) IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
The dc(1) utility operators are compliant with the operators in the IEEE
Std 1003.1-2017 (\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for
bc(1).
.SH BUGS
.PP
None are known.

59
contrib/bc/manuals/dc/HN.1.md
View File

@ -34,7 +34,7 @@ dc - arbitrary-precision decimal reverse-Polish notation calculator
# SYNOPSIS
**dc** [**-hiPRvVx**] [**-\-version**] [**-\-help**] [**-\-interactive**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-extended-register**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...]
**dc** [**-hiPRvVx**] [**-\-version**] [**-\-help**] [**-\-interactive**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-extended-register**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...] [**-I** *ibase*] [**-\-ibase**=*ibase*] [**-O** *obase*] [**-\-obase**=*obase*] [**-S** *scale*] [**-\-scale**=*scale*] [**-E** *seed*] [**-\-seed**=*seed*]
# DESCRIPTION
@ -116,7 +116,7 @@ The following are the options that dc(1) accepts.
**-z**, **-\-leading-zeroes**
: Makes bc(1) print all numbers greater than **-1** and less than **1**, and
: Makes dc(1) print all numbers greater than **-1** and less than **1**, and
not equal to **0**, with a leading zero.
This can be set for individual numbers with the **plz(x)**, plznl(x)**,
@ -157,13 +157,49 @@ The following are the options that dc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-E** *seed*, **-\-seed**=*seed*
: Sets the builtin variable **seed** to the value *seed* assuming that *seed*
is in base 10. It is a fatal error if *seed* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files are given on the command-line and no files or expressions are given
by the **-f**, **-\-file**, **-e**, or **-\-expression** options, then dc(1)
read from **stdin**.
reads from **stdin**.
However, there is a caveat to this.
@ -1195,8 +1231,8 @@ dc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes dc(1) exit
after executing the expressions and expression files, and a non-zero value
makes dc(1) not exit.
after executing the expressions and expression files, and a zero value makes
dc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1297,8 +1333,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Prompt
@ -1353,8 +1391,9 @@ bc(1)
# STANDARDS
The dc(1) utility operators are compliant with the operators in the bc(1)
[IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1] specification.
The dc(1) utility operators are compliant with the operators in the IEEE Std
1003.1-2017 (“POSIX.1-2017”) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for bc(1).
# BUGS
@ -1363,5 +1402,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHOR
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html

77
contrib/bc/manuals/dc/N.1
View File

@ -25,7 +25,9 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.TH "DC" "1" "June 2021" "Gavin D. Howard" "General Commands Manual"
.TH "DC" "1" "June 2022" "Gavin D. Howard" "General Commands Manual"
.nh
.ad l
.SH Name
.PP
dc - arbitrary-precision decimal reverse-Polish notation calculator
@ -37,7 +39,11 @@ dc - arbitrary-precision decimal reverse-Polish notation calculator
[\f[B]-e\f[R] \f[I]expr\f[R]]
[\f[B]--expression\f[R]=\f[I]expr\f[R]\&...] [\f[B]-f\f[R]
\f[I]file\f[R]\&...] [\f[B]--file\f[R]=\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...]
[\f[I]file\f[R]\&...] [\f[B]-I\f[R] \f[I]ibase\f[R]]
[\f[B]--ibase\f[R]=\f[I]ibase\f[R]] [\f[B]-O\f[R] \f[I]obase\f[R]]
[\f[B]--obase\f[R]=\f[I]obase\f[R]] [\f[B]-S\f[R] \f[I]scale\f[R]]
[\f[B]--scale\f[R]=\f[I]scale\f[R]] [\f[B]-E\f[R] \f[I]seed\f[R]]
[\f[B]--seed\f[R]=\f[I]seed\f[R]]
.SH DESCRIPTION
.PP
dc(1) is an arbitrary-precision calculator.
@ -129,7 +135,7 @@ This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-z\f[R], \f[B]--leading-zeroes\f[R]
Makes bc(1) print all numbers greater than \f[B]-1\f[R] and less than
Makes dc(1) print all numbers greater than \f[B]-1\f[R] and less than
\f[B]1\f[R], and not equal to \f[B]0\f[R], with a leading zero.
.RS
.PP
@ -182,13 +188,57 @@ exit.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-I\f[R] \f[I]ibase\f[R], \f[B]--ibase\f[R]=\f[I]ibase\f[R]
Sets the builtin variable \f[B]ibase\f[R] to the value \f[I]ibase\f[R]
assuming that \f[I]ibase\f[R] is in base 10.
It is a fatal error if \f[I]ibase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-O\f[R] \f[I]obase\f[R], \f[B]--obase\f[R]=\f[I]obase\f[R]
Sets the builtin variable \f[B]obase\f[R] to the value \f[I]obase\f[R]
assuming that \f[I]obase\f[R] is in base 10.
It is a fatal error if \f[I]obase\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-S\f[R] \f[I]scale\f[R], \f[B]--scale\f[R]=\f[I]scale\f[R]
Sets the builtin variable \f[B]scale\f[R] to the value \f[I]scale\f[R]
assuming that \f[I]scale\f[R] is in base 10.
It is a fatal error if \f[I]scale\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.TP
\f[B]-E\f[R] \f[I]seed\f[R], \f[B]--seed\f[R]=\f[I]seed\f[R]
Sets the builtin variable \f[B]seed\f[R] to the value \f[I]seed\f[R]
assuming that \f[I]seed\f[R] is in base 10.
It is a fatal error if \f[I]seed\f[R] is not a valid number.
.RS
.PP
If multiple instances of this option are given, the last is used.
.PP
This is a \f[B]non-portable extension\f[R].
.RE
.PP
All long options are \f[B]non-portable extensions\f[R].
.SH STDIN
.PP
If no files are given on the command-line and no files or expressions
are given by the \f[B]-f\f[R], \f[B]--file\f[R], \f[B]-e\f[R], or
\f[B]--expression\f[R] options, then dc(1) read from \f[B]stdin\f[R].
\f[B]--expression\f[R] options, then dc(1) reads from \f[B]stdin\f[R].
.PP
However, there is a caveat to this.
.PP
@ -1346,8 +1396,7 @@ If any expressions or expression files are given on the command-line
with \f[B]-e\f[R], \f[B]--expression\f[R], \f[B]-f\f[R], or
\f[B]--file\f[R], then if this environment variable exists and contains
an integer, a non-zero value makes dc(1) exit after executing the
expressions and expression files, and a non-zero value makes dc(1) not
exit.
expressions and expression files, and a zero value makes dc(1) not exit.
.RS
.PP
This environment variable overrides the default, which can be queried
@ -1456,10 +1505,10 @@ The default setting can be queried with the \f[B]-h\f[R] or
\f[B]--help\f[R] options.
.PP
TTY mode is different from interactive mode because interactive mode is
required in the bc(1)
specification (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html),
and interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R]
to be connected to a terminal.
required in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only \f[B]stdin\f[R] and \f[B]stdout\f[R] to
be connected to a terminal.
.SS Command-Line History
.PP
Command-line history is only enabled if TTY mode is, i.e., that
@ -1544,10 +1593,10 @@ section).
bc(1)
.SH STANDARDS
.PP
The dc(1) utility operators are compliant with the operators in the
bc(1) IEEE Std 1003.1-2017
(\[lq]POSIX.1-2017\[rq]) (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html)
specification.
The dc(1) utility operators are compliant with the operators in the IEEE
Std 1003.1-2017 (\[lq]POSIX.1-2017\[rq]) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for
bc(1).
.SH BUGS
.PP
None are known.

59
contrib/bc/manuals/dc/N.1.md
View File

@ -34,7 +34,7 @@ dc - arbitrary-precision decimal reverse-Polish notation calculator
# SYNOPSIS
**dc** [**-hiPRvVx**] [**-\-version**] [**-\-help**] [**-\-interactive**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-extended-register**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...]
**dc** [**-hiPRvVx**] [**-\-version**] [**-\-help**] [**-\-interactive**] [**-\-no-prompt**] [**-\-no-read-prompt**] [**-\-extended-register**] [**-e** *expr*] [**-\-expression**=*expr*...] [**-f** *file*...] [**-\-file**=*file*...] [*file*...] [**-I** *ibase*] [**-\-ibase**=*ibase*] [**-O** *obase*] [**-\-obase**=*obase*] [**-S** *scale*] [**-\-scale**=*scale*] [**-E** *seed*] [**-\-seed**=*seed*]
# DESCRIPTION
@ -116,7 +116,7 @@ The following are the options that dc(1) accepts.
**-z**, **-\-leading-zeroes**
: Makes bc(1) print all numbers greater than **-1** and less than **1**, and
: Makes dc(1) print all numbers greater than **-1** and less than **1**, and
not equal to **0**, with a leading zero.
This can be set for individual numbers with the **plz(x)**, plznl(x)**,
@ -157,13 +157,49 @@ The following are the options that dc(1) accepts.
This is a **non-portable extension**.
**-I** *ibase*, **-\-ibase**=*ibase*
: Sets the builtin variable **ibase** to the value *ibase* assuming that
*ibase* is in base 10. It is a fatal error if *ibase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-O** *obase*, **-\-obase**=*obase*
: Sets the builtin variable **obase** to the value *obase* assuming that
*obase* is in base 10. It is a fatal error if *obase* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-S** *scale*, **-\-scale**=*scale*
: Sets the builtin variable **scale** to the value *scale* assuming that
*scale* is in base 10. It is a fatal error if *scale* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
**-E** *seed*, **-\-seed**=*seed*
: Sets the builtin variable **seed** to the value *seed* assuming that *seed*
is in base 10. It is a fatal error if *seed* is not a valid number.
If multiple instances of this option are given, the last is used.
This is a **non-portable extension**.
All long options are **non-portable extensions**.
# STDIN
If no files are given on the command-line and no files or expressions are given
by the **-f**, **-\-file**, **-e**, or **-\-expression** options, then dc(1)
read from **stdin**.
reads from **stdin**.
However, there is a caveat to this.
@ -1195,8 +1231,8 @@ dc(1) recognizes the following environment variables:
: If any expressions or expression files are given on the command-line with
**-e**, **-\-expression**, **-f**, or **-\-file**, then if this environment
variable exists and contains an integer, a non-zero value makes dc(1) exit
after executing the expressions and expression files, and a non-zero value
makes dc(1) not exit.
after executing the expressions and expression files, and a zero value makes
dc(1) not exit.
This environment variable overrides the default, which can be queried with
the **-h** or **-\-help** options.
@ -1297,8 +1333,10 @@ setting is used. The default setting can be queried with the **-h** or
**-\-help** options.
TTY mode is different from interactive mode because interactive mode is required
in the [bc(1) specification][1], and interactive mode requires only **stdin**
and **stdout** to be connected to a terminal.
in the bc(1) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html , and
interactive mode requires only **stdin** and **stdout** to be connected to a
terminal.
## Command-Line History
@ -1376,8 +1414,9 @@ bc(1)
# STANDARDS
The dc(1) utility operators are compliant with the operators in the bc(1)
[IEEE Std 1003.1-2017 (“POSIX.1-2017”)][1] specification.
The dc(1) utility operators are compliant with the operators in the IEEE Std
1003.1-2017 (“POSIX.1-2017”) specification at
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html for bc(1).
# BUGS
@ -1386,5 +1425,3 @@ None are known. Report bugs at https://git.yzena.com/gavin/bc.
# AUTHOR
Gavin D. Howard <gavin@yzena.com> and contributors.
[1]: https://pubs.opengroup.org/onlinepubs/9699919799/utilities/bc.html

49
contrib/bc/scripts/format.sh Executable file
View File

@ -0,0 +1,49 @@
#! /bin/sh
#
# SPDX-License-Identifier: BSD-2-Clause
#
# Copyright (c) 2018-2021 Gavin D. Howard and contributors.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# * Redistributions of source code must retain the above copyright notice, this
# list of conditions and the following disclaimer.
#
# * Redistributions in binary form must reproduce the above copyright notice,
# this list of conditions and the following disclaimer in the documentation
# and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
#
scriptdir=$(dirname "$0")
cd "$scriptdir/.."
if [ "$#" -gt 0 ]; then
files="$@"
else
files=$(find "." -name "*.c" -or -name "*.h")
fi
for f in $files; do
case "$f" in
*scripts/ministat.c) continue ;;
esac
clang-format -i --style=file "$f"
sed -i 's|^#else //|#else //|g' "$f"
done

94
contrib/bc/scripts/functions.sh
View File

@ -326,3 +326,97 @@ gen_nlspath() {
# Return the result.
printf '%s' "$_gen_nlspath_nlspath"
}
ALL=0
NOSKIP=1
SKIP=2
# Filters text out of a file according to the build type.
# @param in File to filter.
# @param out File to write the filtered output to.
# @param type Build type.
filter_text() {
_filter_text_in="$1"
shift
_filter_text_out="$1"
shift
_filter_text_buildtype="$1"
shift
# Set up some local variables.
_filter_text_status="$ALL"
_filter_text_temp="$_filter_text_out.tmp"
# We need to set IFS, so we store it here for restoration later.
_filter_text_ifs="$IFS"
# Remove the file- that will be generated.
rm -rf "$_filter_text_out" "$_filter_text_temp"
# Here is the magic. This loop reads the template line-by-line, and based on
# _filter_text_status, either prints it to the markdown manual or not.
#
# Here is how the template is set up: it is a normal markdown file except
# that there are sections surrounded tags that look like this:
#
# {{ <build_type_list> }}
# ...
# {{ end }}
#
# Those tags mean that whatever build types are found in the
# <build_type_list> get to keep that section. Otherwise, skip.
#
# Obviously, the tag itself and its end are not printed to the markdown
# manual.
while IFS= read -r line; do
# If we have found an end, reset the status.
if [ "$line" = "{{ end }}" ]; then
# Some error checking. This helps when editing the templates.
if [ "$_filter_text_status" -eq "$ALL" ]; then
err_exit "{{ end }} tag without corresponding start tag" 2
fi
_filter_text_status="$ALL"
# We have found a tag that allows our build type to use it.
elif [ "${line#\{\{* $_filter_text_buildtype *\}\}}" != "$line" ]; then
# More error checking. We don't want tags nested.
if [ "$_filter_text_status" -ne "$ALL" ]; then
err_exit "start tag nested in start tag" 3
fi
_filter_text_status="$NOSKIP"
# We have found a tag that is *not* allowed for our build type.
elif [ "${line#\{\{*\}\}}" != "$line" ]; then
if [ "$_filter_text_status" -ne "$ALL" ]; then
err_exit "start tag nested in start tag" 3
fi
_filter_text_status="$SKIP"
# This is for normal lines. If we are not skipping, print.
else
if [ "$_filter_text_status" -ne "$SKIP" ]; then
printf '%s\n' "$line" >> "$_filter_text_temp"
fi
fi
done < "$_filter_text_in"
# Remove multiple blank lines.
uniq "$_filter_text_temp" "$_filter_text_out"
# Remove the temp file.
#rm -rf "$_filter_text_temp"
# Reset IFS.
IFS="$_filter_text_ifs"
}

63
contrib/bc/scripts/lint.sh Executable file
View File

@ -0,0 +1,63 @@
#! /bin/sh
#
# SPDX-License-Identifier: BSD-2-Clause
#
# Copyright (c) 2018-2021 Gavin D. Howard and contributors.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# * Redistributions of source code must retain the above copyright notice, this
# list of conditions and the following disclaimer.
#
# * Redistributions in binary form must reproduce the above copyright notice,
# this list of conditions and the following disclaimer in the documentation
# and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
#
scriptdir=$(dirname "$0")
cd "$scriptdir/.."
if [ "$#" -gt 0 ]; then
files="$@"
else
files=$(find "." -name "*.c" -or -name "*.h")
fi
for f in $files; do
case "$f" in
*scripts/ministat.c) continue ;;
esac
contents=$(clang-tidy --use-color -p ../build "$f" -- -I./include \
-D_POSIX_C_SOURCE=200809L -D_XOPEN_SOURCE=700 -D_BSD_SOURCE \
-D_GNU_SOURCE -D_DEFAULT_SOURCE 2>&1)
err="$?"
if [ ! -z "$contents" ] || [ "$err" -ne 0 ]; then
printf '%s\n' "$f"
printf '%s\n' "$contents"
printf '\n'
if [ "$err" -ne 0 ]; then
exit "$err"
fi
fi
done

157
contrib/bc/src/args.c
View File

@ -47,12 +47,15 @@
#include <read.h>
#include <args.h>
#include <opt.h>
#include <num.h>
/**
* Adds @a str to the list of expressions to execute later.
* @param str The string to add to the list of expressions.
*/
static void bc_args_exprs(const char *str) {
static void
bc_args_exprs(const char* str)
{
BC_SIG_ASSERT_LOCKED;
if (vm.exprs.v == NULL) bc_vec_init(&vm.exprs, sizeof(uchar), BC_DTOR_NONE);
bc_vec_concat(&vm.exprs, str);
@ -64,9 +67,10 @@ static void bc_args_exprs(const char *str) {
* @param file The name of the file whose contents should be added to the list
* of expressions to execute.
*/
static void bc_args_file(const char *file) {
char *buf;
static void
bc_args_file(const char* file)
{
char* buf;
BC_SIG_ASSERT_LOCKED;
@ -80,6 +84,31 @@ static void bc_args_file(const char *file) {
free(buf);
}
static BcBigDig
bc_args_builtin(const char* arg)
{
bool strvalid;
BcNum n;
BcBigDig res;
strvalid = bc_num_strValid(arg);
if (BC_ERR(!strvalid))
{
bc_verr(BC_ERR_FATAL_ARG, arg);
}
bc_num_init(&n, 0);
bc_num_parse(&n, arg, 10);
res = bc_num_bigdig(&n);
bc_num_free(&n);
return res;
}
#if BC_ENABLED
/**
@ -87,18 +116,19 @@ static void bc_args_file(const char *file) {
* throws a fatal error.
* @param keyword The keyword to redefine.
*/
static void bc_args_redefine(const char *keyword) {
static void
bc_args_redefine(const char* keyword)
{
size_t i;
BC_SIG_ASSERT_LOCKED;
for (i = 0; i < bc_lex_kws_len; ++i) {
const BcLexKeyword *kw = bc_lex_kws + i;
if (!strcmp(keyword, kw->name)) {
for (i = 0; i < bc_lex_kws_len; ++i)
{
const BcLexKeyword* kw = bc_lex_kws + i;
if (!strcmp(keyword, kw->name))
{
if (BC_LEX_KW_POSIX(kw)) break;
vm.redefined_kws[i] = true;
@ -112,12 +142,17 @@ static void bc_args_redefine(const char *keyword) {
#endif // BC_ENABLED
void bc_args(int argc, char *argv[], bool exit_exprs) {
void
bc_args(int argc, char* argv[], bool exit_exprs, BcBigDig scale)
{
int c;
size_t i;
bool do_exit = false, version = false;
BcOpt opts;
BcBigDig newscale = scale, ibase = BC_BASE, obase = BC_BASE;
#if BC_ENABLE_EXTRA_MATH
char* seed = NULL;
#endif // BC_ENABLE_EXTRA_MATH
BC_SIG_ASSERT_LOCKED;
@ -125,15 +160,17 @@ void bc_args(int argc, char *argv[], bool exit_exprs) {
// This loop should look familiar to anyone who has used getopt() or
// getopt_long() in C.
while ((c = bc_opt_parse(&opts, bc_args_lopt)) != -1) {
switch (c) {
while ((c = bc_opt_parse(&opts, bc_args_lopt)) != -1)
{
switch (c)
{
case 'e':
{
// Barf if not allowed.
if (vm.no_exprs)
{
bc_verr(BC_ERR_FATAL_OPTION, "-e (--expression)");
}
// Add the expressions and set exit.
bc_args_exprs(opts.optarg);
@ -146,13 +183,15 @@ void bc_args(int argc, char *argv[], bool exit_exprs) {
{
// Figure out if exiting on expressions is disabled.
if (!strcmp(opts.optarg, "-")) vm.no_exprs = true;
else {
else
{
// Barf if not allowed.
if (vm.no_exprs)
{
bc_verr(BC_ERR_FATAL_OPTION, "-f (--file)");
}
// Add the expressions and set exit.
// Add the expressions and set exit.
bc_args_file(opts.optarg);
vm.exit_exprs = (exit_exprs || vm.exit_exprs);
}
@ -173,6 +212,12 @@ void bc_args(int argc, char *argv[], bool exit_exprs) {
break;
}
case 'I':
{
ibase = bc_args_builtin(opts.optarg);
break;
}
case 'z':
{
vm.flags |= BC_FLAG_Z;
@ -185,6 +230,12 @@ void bc_args(int argc, char *argv[], bool exit_exprs) {
break;
}
case 'O':
{
obase = bc_args_builtin(opts.optarg);
break;
}
case 'P':
{
vm.flags &= ~(BC_FLAG_P);
@ -197,6 +248,26 @@ void bc_args(int argc, char *argv[], bool exit_exprs) {
break;
}
case 'S':
{
newscale = bc_args_builtin(opts.optarg);
break;
}
#if BC_ENABLE_EXTRA_MATH
case 'E':
{
if (BC_ERR(!bc_num_strValid(opts.optarg)))
{
bc_verr(BC_ERR_FATAL_ARG, opts.optarg);
}
seed = opts.optarg;
break;
}
#endif // BC_ENABLE_EXTRA_MATH
#if BC_ENABLED
case 'g':
{
@ -271,7 +342,8 @@ void bc_args(int argc, char *argv[], bool exit_exprs) {
}
if (version) bc_vm_info(NULL);
if (do_exit) {
if (do_exit)
{
vm.status = (sig_atomic_t) BC_STATUS_QUIT;
BC_JMP;
}
@ -282,9 +354,52 @@ void bc_args(int argc, char *argv[], bool exit_exprs) {
// We need to make sure the files list is initialized. We don't want to
// initialize it if there are no files because it's just a waste of memory.
if (opts.optind < (size_t) argc && vm.files.v == NULL)
{
bc_vec_init(&vm.files, sizeof(char*), BC_DTOR_NONE);
}
// Add all the files to the vector.
for (i = opts.optind; i < (size_t) argc; ++i)
{
bc_vec_push(&vm.files, argv + i);
}
#if BC_ENABLE_EXTRA_MATH
if (seed != NULL)
{
BcNum n;
bc_num_init(&n, strlen(seed));
BC_SIG_UNLOCK;
bc_num_parse(&n, seed, BC_BASE);
bc_program_assignSeed(&vm.prog, &n);
BC_SIG_LOCK;
bc_num_free(&n);
}
#endif // BC_ENABLE_EXTRA_MATH
BC_SIG_UNLOCK;
if (newscale != scale)
{
bc_program_assignBuiltin(&vm.prog, true, false, newscale);
}
if (obase != BC_BASE)
{
bc_program_assignBuiltin(&vm.prog, false, true, obase);
}
// This is last to avoid it affecting the value of the others.
if (ibase != BC_BASE)
{
bc_program_assignBuiltin(&vm.prog, false, false, ibase);
}
BC_SIG_LOCK;
}

5
contrib/bc/src/bc.c
View File

@ -45,8 +45,9 @@
* @param argc The number of arguments.
* @param argv The arguments.
*/
void bc_main(int argc, char *argv[]) {
void
bc_main(int argc, char* argv[])
{
// All of these just set bc-specific items in BcVm.
vm.read_ret = BC_INST_RET;

90
contrib/bc/src/bc_lex.c
View File

@ -46,21 +46,22 @@
* Lexes an identifier, which may be a keyword.
* @param l The lexer.
*/
static void bc_lex_identifier(BcLex *l) {
static void
bc_lex_identifier(BcLex* l)
{
// We already passed the first character, so we need to be sure to include
// it.
const char *buf = l->buf + l->i - 1;
const char* buf = l->buf + l->i - 1;
size_t i;
// This loop is simply checking for keywords.
for (i = 0; i < bc_lex_kws_len; ++i) {
const BcLexKeyword *kw = bc_lex_kws + i;
for (i = 0; i < bc_lex_kws_len; ++i)
{
const BcLexKeyword* kw = bc_lex_kws + i;
size_t n = BC_LEX_KW_LEN(kw);
if (!strncmp(buf, kw->name, n) && !isalnum(buf[n]) && buf[n] != '_') {
if (!strncmp(buf, kw->name, n) && !isalnum(buf[n]) && buf[n] != '_')
{
// If the keyword has been redefined, and redefinition is allowed
// (it is not allowed for builtin libraries), break out of the loop
// and use it as a name. This depends on the argument parser to
@ -87,7 +88,9 @@ static void bc_lex_identifier(BcLex *l) {
// POSIX doesn't allow identifiers that are more than one character, so we
// might have to warn or error here too.
if (BC_ERR(l->str.len - 1 > 1))
{
bc_lex_verr(l, BC_ERR_POSIX_NAME_LEN, l->str.v);
}
}
/**
@ -95,18 +98,19 @@ static void bc_lex_identifier(BcLex *l) {
* to be balanced.
* @param l The lexer.
*/
static void bc_lex_string(BcLex *l) {
static void
bc_lex_string(BcLex* l)
{
// We need to keep track of newlines to increment them properly.
size_t len, nlines, i;
const char *buf;
const char* buf;
char c;
bool got_more;
l->t = BC_LEX_STR;
do {
do
{
nlines = 0;
buf = l->buf;
got_more = false;
@ -115,15 +119,21 @@ static void bc_lex_string(BcLex *l) {
// Fortunately for us, bc doesn't escape quotes. Instead, the equivalent
// is '\q', which makes this loop simpler.
for (i = l->i; (c = buf[i]) && c != '"'; ++i) nlines += (c == '\n');
for (i = l->i; (c = buf[i]) && c != '"'; ++i)
{
nlines += (c == '\n');
}
if (BC_ERR(c == '\0') && !vm.eof && (l->is_stdin || l->is_exprs))
{
got_more = bc_lex_readLine(l);
} while (got_more && c != '"');
}
}
while (got_more && c != '"');
// If the string did not end properly, barf.
if (c != '"') {
if (c != '"')
{
l->i = i;
bc_lex_err(l, BC_ERR_PARSE_STRING);
}
@ -143,16 +153,20 @@ static void bc_lex_string(BcLex *l) {
* @param with The token to assign if it is an assignment operator.
* @param without The token to assign if it is not an assignment operator.
*/
static void bc_lex_assign(BcLex *l, BcLexType with, BcLexType without) {
if (l->buf[l->i] == '=') {
static void
bc_lex_assign(BcLex* l, BcLexType with, BcLexType without)
{
if (l->buf[l->i] == '=')
{
l->i += 1;
l->t = with;
}
else l->t = without;
}
void bc_lex_token(BcLex *l) {
void
bc_lex_token(BcLex* l)
{
// We increment here. This means that all lexing needs to take that into
// account, such as when parsing an identifier. If we don't, the first
// character of every identifier would be missing.
@ -161,8 +175,8 @@ void bc_lex_token(BcLex *l) {
BC_SIG_ASSERT_LOCKED;
// This is the workhorse of the lexer.
switch (c) {
switch (c)
{
case '\0':
case '\n':
case '\t':
@ -182,7 +196,9 @@ void bc_lex_token(BcLex *l) {
// POSIX doesn't allow boolean not.
if (l->t == BC_LEX_OP_BOOL_NOT)
{
bc_lex_verr(l, BC_ERR_POSIX_BOOL, "!");
}
break;
}
@ -213,8 +229,8 @@ void bc_lex_token(BcLex *l) {
// Either we have boolean and or an error. And boolean and is not
// allowed by POSIX.
if (BC_NO_ERR(c2 == '&')) {
if (BC_NO_ERR(c2 == '&'))
{
bc_lex_verr(l, BC_ERR_POSIX_BOOL, "&&");
l->i += 1;
@ -255,7 +271,8 @@ void bc_lex_token(BcLex *l) {
c2 = l->buf[l->i];
// Have to check for increment first.
if (c2 == '+') {
if (c2 == '+')
{
l->i += 1;
l->t = BC_LEX_OP_INC;
}
@ -274,7 +291,8 @@ void bc_lex_token(BcLex *l) {
c2 = l->buf[l->i];
// Have to check for decrement first.
if (c2 == '-') {
if (c2 == '-')
{
l->i += 1;
l->t = BC_LEX_OP_DEC;
}
@ -288,7 +306,8 @@ void bc_lex_token(BcLex *l) {
// If it's alone, it's an alias for last.
if (BC_LEX_NUM_CHAR(c2, true, false)) bc_lex_number(l, c);
else {
else
{
l->t = BC_LEX_KW_LAST;
bc_lex_err(l, BC_ERR_POSIX_DOT);
}
@ -299,7 +318,7 @@ void bc_lex_token(BcLex *l) {
case '/':
{
c2 = l->buf[l->i];
if (c2 =='*') bc_lex_comment(l);
if (c2 == '*') bc_lex_comment(l);
else bc_lex_assign(l, BC_LEX_OP_ASSIGN_DIVIDE, BC_LEX_OP_DIVIDE);
break;
}
@ -361,7 +380,8 @@ void bc_lex_token(BcLex *l) {
c2 = l->buf[l->i];
// Check for shift.
if (c2 == '<') {
if (c2 == '<')
{
l->i += 1;
bc_lex_assign(l, BC_LEX_OP_ASSIGN_LSHIFT, BC_LEX_OP_LSHIFT);
break;
@ -383,7 +403,8 @@ void bc_lex_token(BcLex *l) {
c2 = l->buf[l->i];
// Check for shift.
if (c2 == '>') {
if (c2 == '>')
{
l->i += 1;
bc_lex_assign(l, BC_LEX_OP_ASSIGN_RSHIFT, BC_LEX_OP_RSHIFT);
break;
@ -403,7 +424,8 @@ void bc_lex_token(BcLex *l) {
case '\\':
{
// In bc, a backslash+newline is whitespace.
if (BC_NO_ERR(l->buf[l->i] == '\n')) {
if (BC_NO_ERR(l->buf[l->i] == '\n'))
{
l->i += 1;
l->t = BC_LEX_WHITESPACE;
}
@ -460,8 +482,8 @@ void bc_lex_token(BcLex *l) {
c2 = l->buf[l->i];
// Once again, boolean or is not allowed by POSIX.
if (BC_NO_ERR(c2 == '|')) {
if (BC_NO_ERR(c2 == '|'))
{
bc_lex_verr(l, BC_ERR_POSIX_BOOL, "||");
l->i += 1;

692
contrib/bc/src/bc_parse.c
View File

File diff suppressed because it is too large Load Diff

870
contrib/bc/src/data.c
View File

File diff suppressed because it is too large Load Diff

5
contrib/bc/src/dc.c
View File

@ -45,8 +45,9 @@
* @param argc The number of arguments.
* @param argv The arguments.
*/
void dc_main(int argc, char *argv[]) {
void
dc_main(int argc, char* argv[])
{
// All of these just set dc-specific items in BcVm.
vm.read_ret = BC_INST_POP_EXEC;

70
contrib/bc/src/dc_lex.c
View File

@ -40,7 +40,9 @@
#include <dc.h>
#include <vm.h>
bool dc_lex_negCommand(BcLex *l) {
bool
dc_lex_negCommand(BcLex* l)
{
char c = l->buf[l->i];
return !BC_LEX_NUM_CHAR(c, false, false);
}
@ -50,11 +52,12 @@ bool dc_lex_negCommand(BcLex *l) {
* extended-register extension is implemented.
* @param l The lexer.
*/
static void dc_lex_register(BcLex *l) {
static void
dc_lex_register(BcLex* l)
{
// If extended register is enabled and the character is whitespace...
if (DC_X && isspace(l->buf[l->i - 1])) {
if (DC_X && isspace(l->buf[l->i - 1]))
{
char c;
// Eat the whitespace.
@ -63,18 +66,22 @@ static void dc_lex_register(BcLex *l) {
// Check for a letter or underscore.
if (BC_ERR(!isalpha(c) && c != '_'))
{
bc_lex_verr(l, BC_ERR_PARSE_CHAR, c);
}
// Parse a normal identifier.
l->i += 1;
bc_lex_name(l);
}
else {
else
{
// I don't allow newlines because newlines are used for controlling when
// execution happens, and allowing newlines would just be complex.
if (BC_ERR(l->buf[l->i - 1] == '\n'))
{
bc_lex_verr(l, BC_ERR_PARSE_CHAR, l->buf[l->i - 1]);
}
// Set the lexer string and token.
bc_vec_popAll(&l->str);
@ -90,8 +97,9 @@ static void dc_lex_register(BcLex *l) {
* characters. Oh, and dc strings need to check for escaped brackets.
* @param l The lexer.
*/
static void dc_lex_string(BcLex *l) {
static void
dc_lex_string(BcLex* l)
{
size_t depth, nls, i;
char c;
bool got_more;
@ -100,8 +108,8 @@ static void dc_lex_string(BcLex *l) {
l->t = BC_LEX_STR;
bc_vec_popAll(&l->str);
do {
do
{
depth = 1;
nls = 0;
got_more = false;
@ -111,14 +119,16 @@ static void dc_lex_string(BcLex *l) {
// This is the meat. As long as we don't run into the NUL byte, and we
// have "depth", which means we haven't completely balanced brackets
// yet, we continue eating the string.
for (i = l->i; (c = l->buf[i]) && depth; ++i) {
for (i = l->i; (c = l->buf[i]) && depth; ++i)
{
// Check for escaped brackets and set the depths as appropriate.
if (c == '\\') {
if (c == '\\')
{
c = l->buf[++i];
if (!c) break;
}
else {
else
{
depth += (c == '[');
depth -= (c == ']');
}
@ -129,16 +139,20 @@ static void dc_lex_string(BcLex *l) {
if (depth) bc_vec_push(&l->str, &c);
}
if (BC_ERR(c == '\0' && depth)) {
if (BC_ERR(c == '\0' && depth))
{
if (!vm.eof && (l->is_stdin || l->is_exprs))
{
got_more = bc_lex_readLine(l);
}
if (got_more) bc_vec_popAll(&l->str);
}
} while (got_more && depth);
}
while (got_more && depth);
// Obviously, if we didn't balance, that's an error.
if (BC_ERR(c == '\0' && depth)) {
if (BC_ERR(c == '\0' && depth))
{
l->i = i;
bc_lex_err(l, BC_ERR_PARSE_STRING);
}
@ -153,8 +167,9 @@ static void dc_lex_string(BcLex *l) {
* Lexes a dc token. This is the dc implementation of BcLexNext.
* @param l The lexer.
*/
void dc_lex_token(BcLex *l) {
void
dc_lex_token(BcLex* l)
{
char c = l->buf[l->i++], c2;
size_t i;
@ -162,10 +177,11 @@ void dc_lex_token(BcLex *l) {
// If the last token was a command that needs a register, we need to parse a
// register, so do so.
for (i = 0; i < dc_lex_regs_len; ++i) {
for (i = 0; i < dc_lex_regs_len; ++i)
{
// If the token is a register token, take care of it and return.
if (l->last == dc_lex_regs[i]) {
if (l->last == dc_lex_regs[i])
{
dc_lex_register(l);
return;
}
@ -181,8 +197,8 @@ void dc_lex_token(BcLex *l) {
// This is the workhorse of the lexer when more complicated things are
// needed.
switch (c) {
switch (c)
{
case '\0':
case '\n':
case '\t':
@ -224,7 +240,9 @@ void dc_lex_token(BcLex *l) {
// If the character after is a number, this dot is part of a number.
// Otherwise, it's the BSD dot (equivalent to last).
if (BC_NO_ERR(BC_LEX_NUM_CHAR(c2, true, false)))
{
bc_lex_number(l, c);
}
else bc_lex_invalidChar(l, c);
break;

66
contrib/bc/src/dc_parse.c
View File

@ -50,8 +50,9 @@
* @param p The parser.
* @param var True if the parser is for a variable, false otherwise.
*/
static void dc_parse_register(BcParse *p, bool var) {
static void
dc_parse_register(BcParse* p, bool var)
{
bc_lex_next(&p->l);
if (p->l.t != BC_LEX_NAME) bc_parse_err(p, BC_ERR_PARSE_TOKEN);
@ -62,7 +63,9 @@ static void dc_parse_register(BcParse *p, bool var) {
* Parses a dc string.
* @param p The parser.
*/
static inline void dc_parse_string(BcParse *p) {
static inline void
dc_parse_string(BcParse* p)
{
bc_parse_addString(p);
bc_lex_next(&p->l);
}
@ -75,8 +78,9 @@ static inline void dc_parse_string(BcParse *p) {
* a global.
* @param store True if the operation is a store, false otherwise.
*/
static void dc_parse_mem(BcParse *p, uchar inst, bool name, bool store) {
static void
dc_parse_mem(BcParse* p, uchar inst, bool name, bool store)
{
// Push the instruction.
bc_parse_push(p, inst);
@ -85,7 +89,8 @@ static void dc_parse_mem(BcParse *p, uchar inst, bool name, bool store) {
// Stores use the bc assign infrastructure, but they need to do a swap
// first.
if (store) {
if (store)
{
bc_parse_push(p, BC_INST_SWAP);
bc_parse_push(p, BC_INST_ASSIGN_NO_VAL);
}
@ -98,8 +103,9 @@ static void dc_parse_mem(BcParse *p, uchar inst, bool name, bool store) {
* @param p The parser.
* @param inst The instruction for the condition.
*/
static void dc_parse_cond(BcParse *p, uchar inst) {
static void
dc_parse_cond(BcParse* p, uchar inst)
{
// Push the instruction for the condition and the conditional execution.
bc_parse_push(p, inst);
bc_parse_push(p, BC_INST_EXEC_COND);
@ -110,7 +116,8 @@ static void dc_parse_cond(BcParse *p, uchar inst) {
bc_lex_next(&p->l);
// If the next token is an else, parse the else.
if (p->l.t == BC_LEX_KW_ELSE) {
if (p->l.t == BC_LEX_KW_ELSE)
{
dc_parse_register(p, true);
bc_lex_next(&p->l);
}
@ -124,13 +131,14 @@ static void dc_parse_cond(BcParse *p, uchar inst) {
* @param t The token to parse.
* @param flags The flags that say what is allowed or not.
*/
static void dc_parse_token(BcParse *p, BcLexType t, uint8_t flags) {
static void
dc_parse_token(BcParse* p, BcLexType t, uint8_t flags)
{
uchar inst;
bool assign, get_token = false;
switch (t) {
switch (t)
{
case BC_LEX_OP_REL_EQ:
case BC_LEX_OP_REL_LE:
case BC_LEX_OP_REL_GE:
@ -161,16 +169,18 @@ static void dc_parse_token(BcParse *p, BcLexType t, uint8_t flags) {
// This tells us whether or not the neg is for a command or at the
// beginning of a number. If it's a command, push it. Otherwise,
// fallthrough and parse the number.
if (dc_lex_negCommand(&p->l)) {
if (dc_lex_negCommand(&p->l))
{
bc_parse_push(p, BC_INST_NEG);
get_token = true;
break;
}
bc_lex_next(&p->l);
// Fallthrough.
BC_FALLTHROUGH
}
// Fallthrough.
BC_FALLTHROUGH
case BC_LEX_NUMBER:
{
@ -187,7 +197,9 @@ static void dc_parse_token(BcParse *p, BcLexType t, uint8_t flags) {
{
// Make sure the read is not recursive.
if (BC_ERR(flags & BC_PARSE_NOREAD))
{
bc_parse_err(p, BC_ERR_EXEC_REC_READ);
}
else bc_parse_push(p, BC_INST_READ);
get_token = true;
@ -254,8 +266,9 @@ static void dc_parse_token(BcParse *p, BcLexType t, uint8_t flags) {
if (get_token) bc_lex_next(&p->l);
}
void dc_parse_expr(BcParse *p, uint8_t flags) {
void
dc_parse_expr(BcParse* p, uint8_t flags)
{
BcInst inst;
BcLexType t;
bool need_expr, have_expr = false;
@ -267,10 +280,11 @@ void dc_parse_expr(BcParse *p, uint8_t flags) {
// designed.
// While we don't have EOF...
while ((t = p->l.t) != BC_LEX_EOF) {
while ((t = p->l.t) != BC_LEX_EOF)
{
// Eat newline.
if (t == BC_LEX_NLINE) {
if (t == BC_LEX_NLINE)
{
bc_lex_next(&p->l);
continue;
}
@ -281,7 +295,8 @@ void dc_parse_expr(BcParse *p, uint8_t flags) {
// If the instruction is invalid, that means we have to do some harder
// parsing. So if not invalid, just push the instruction; otherwise,
// parse the token.
if (inst != BC_INST_INVALID) {
if (inst != BC_INST_INVALID)
{
bc_parse_push(p, inst);
bc_lex_next(&p->l);
}
@ -295,11 +310,14 @@ void dc_parse_expr(BcParse *p, uint8_t flags) {
// indicate that it is executing a string.
if (BC_ERR(need_expr && !have_expr)) bc_err(BC_ERR_EXEC_READ_EXPR);
else if (p->l.t == BC_LEX_EOF && (flags & BC_PARSE_NOCALL))
{
bc_parse_push(p, BC_INST_POP_EXEC);
}
}
void dc_parse_parse(BcParse *p) {
void
dc_parse_parse(BcParse* p)
{
assert(p != NULL);
BC_SETJMP_LOCKED(exit);

216
contrib/bc/src/file.c
View File

@ -44,22 +44,26 @@
#include <file.h>
#include <vm.h>
#if !BC_ENABLE_LINE_LIB
/**
* Translates an integer into a string.
* @param val The value to translate.
* @param buf The return parameter.
*/
static void bc_file_ultoa(unsigned long long val, char buf[BC_FILE_ULL_LENGTH])
static void
bc_file_ultoa(unsigned long long val, char buf[BC_FILE_ULL_LENGTH])
{
char buf2[BC_FILE_ULL_LENGTH];
size_t i, len;
// We need to make sure the entire thing is zeroed.
// NOLINTNEXTLINE
memset(buf2, 0, BC_FILE_ULL_LENGTH);
// The i = 1 is to ensure that there is a null byte at the end.
for (i = 1; val; ++i) {
for (i = 1; val; ++i)
{
unsigned long long mod = val % 10;
buf2[i] = ((char) mod) + '0';
@ -69,7 +73,10 @@ static void bc_file_ultoa(unsigned long long val, char buf[BC_FILE_ULL_LENGTH])
len = i;
// Since buf2 is reversed, reverse it into buf.
for (i = 0; i < len; ++i) buf[i] = buf2[len - i - 1];
for (i = 0; i < len; ++i)
{
buf[i] = buf2[len - i - 1];
}
}
/**
@ -80,22 +87,23 @@ static void bc_file_ultoa(unsigned long long val, char buf[BC_FILE_ULL_LENGTH])
* @return A status indicating error or success. We could have a fatal I/O
* error or EOF.
*/
static BcStatus bc_file_output(int fd, const char *buf, size_t n) {
static BcStatus
bc_file_output(int fd, const char* buf, size_t n)
{
size_t bytes = 0;
sig_atomic_t lock;
BC_SIG_TRYLOCK(lock);
// While the number of bytes written is less than intended...
while (bytes < n) {
while (bytes < n)
{
// Write.
ssize_t written = write(fd, buf + bytes, n - bytes);
// Check for error and return, if any.
if (BC_ERR(written == -1)) {
if (BC_ERR(written == -1))
{
BC_SIG_TRYUNLOCK(lock);
return errno == EPIPE ? BC_STATUS_EOF : BC_STATUS_ERROR_FATAL;
@ -109,20 +117,31 @@ static BcStatus bc_file_output(int fd, const char *buf, size_t n) {
return BC_STATUS_SUCCESS;
}
BcStatus bc_file_flushErr(BcFile *restrict f, BcFlushType type)
#endif // !BC_ENABLE_LINE_LIB
BcStatus
bc_file_flushErr(BcFile* restrict f, BcFlushType type)
{
BcStatus s;
BC_SIG_ASSERT_LOCKED;
// If there is stuff to output...
if (f->len) {
#if BC_ENABLE_LINE_LIB
// Just flush and propagate the error.
if (fflush(f->f) == EOF) s = BC_STATUS_ERROR_FATAL;
else s = BC_STATUS_SUCCESS;
#else // BC_ENABLE_LINE_LIB
// If there is stuff to output...
if (f->len)
{
#if BC_ENABLE_HISTORY
// If history is enabled...
if (BC_TTY) {
if (BC_TTY)
{
// If we have been told to save the extras, and there *are*
// extras...
if (f->buf[f->len - 1] != '\n' &&
@ -132,7 +151,10 @@ BcStatus bc_file_flushErr(BcFile *restrict f, BcFlushType type)
size_t i;
// Look for the last newline.
for (i = f->len - 2; i < f->len && f->buf[i] != '\n'; --i);
for (i = f->len - 2; i < f->len && f->buf[i] != '\n'; --i)
{
continue;
}
i += 1;
@ -140,7 +162,8 @@ BcStatus bc_file_flushErr(BcFile *restrict f, BcFlushType type)
bc_vec_string(&vm.history.extras, f->len - i, f->buf + i);
}
// Else clear the extras if told to.
else if (type >= BC_FLUSH_NO_EXTRAS_CLEAR) {
else if (type >= BC_FLUSH_NO_EXTRAS_CLEAR)
{
bc_vec_popAll(&vm.history.extras);
}
}
@ -152,11 +175,14 @@ BcStatus bc_file_flushErr(BcFile *restrict f, BcFlushType type)
}
else s = BC_STATUS_SUCCESS;
#endif // BC_ENABLE_LINE_LIB
return s;
}
void bc_file_flush(BcFile *restrict f, BcFlushType type) {
void
bc_file_flush(BcFile* restrict f, BcFlushType type)
{
BcStatus s;
sig_atomic_t lock;
@ -165,10 +191,11 @@ void bc_file_flush(BcFile *restrict f, BcFlushType type) {
s = bc_file_flushErr(f, type);
// If we have an error...
if (BC_ERR(s)) {
if (BC_ERR(s))
{
// For EOF, set it and jump.
if (s == BC_STATUS_EOF) {
if (s == BC_STATUS_EOF)
{
vm.status = (sig_atomic_t) s;
BC_SIG_TRYUNLOCK(lock);
BC_JMP;
@ -180,23 +207,44 @@ void bc_file_flush(BcFile *restrict f, BcFlushType type) {
BC_SIG_TRYUNLOCK(lock);
}
void bc_file_write(BcFile *restrict f, BcFlushType type,
const char *buf, size_t n)
#if !BC_ENABLE_LINE_LIB
void
bc_file_write(BcFile* restrict f, BcFlushType type, const char* buf, size_t n)
{
sig_atomic_t lock;
BC_SIG_TRYLOCK(lock);
// If we have enough to flush, do it.
if (n > f->cap - f->len) {
if (n > f->cap - f->len)
{
bc_file_flush(f, type);
assert(!f->len);
}
// If the output is large enough to flush by itself, just output it.
// Otherwise, put it into the buffer.
if (BC_UNLIKELY(n > f->cap - f->len)) bc_file_output(f->fd, buf, n);
else {
if (BC_UNLIKELY(n > f->cap - f->len))
{
BcStatus s = bc_file_output(f->fd, buf, n);
if (BC_ERR(s))
{
// For EOF, set it and jump.
if (s == BC_STATUS_EOF)
{
vm.status = (sig_atomic_t) s;
BC_SIG_TRYUNLOCK(lock);
BC_JMP;
}
// Blow up on fatal error. Okay, not blow up, just quit.
else bc_vm_fatalError(BC_ERR_FATAL_IO_ERR);
}
}
else
{
// NOLINTNEXTLINE
memcpy(f->buf + f->len, buf, n);
f->len += n;
}
@ -204,7 +252,10 @@ void bc_file_write(BcFile *restrict f, BcFlushType type,
BC_SIG_TRYUNLOCK(lock);
}
void bc_file_printf(BcFile *restrict f, const char *fmt, ...)
#endif // BC_ENABLE_LINE_LIB
void
bc_file_printf(BcFile* restrict f, const char* fmt, ...)
{
va_list args;
sig_atomic_t lock;
@ -218,27 +269,39 @@ void bc_file_printf(BcFile *restrict f, const char *fmt, ...)
BC_SIG_TRYUNLOCK(lock);
}
void bc_file_vprintf(BcFile *restrict f, const char *fmt, va_list args) {
char *percent;
const char *ptr = fmt;
char buf[BC_FILE_ULL_LENGTH];
void
bc_file_vprintf(BcFile* restrict f, const char* fmt, va_list args)
{
BC_SIG_ASSERT_LOCKED;
#if BC_ENABLE_LINE_LIB
// Just print and propagate the error.
if (BC_ERR(vfprintf(f->f, fmt, args) < 0))
{
bc_vm_fatalError(BC_ERR_FATAL_IO_ERR);
}
#else // BC_ENABLE_LINE_LIB
char* percent;
const char* ptr = fmt;
char buf[BC_FILE_ULL_LENGTH];
// This is a poor man's printf(). While I could look up algorithms to make
// it as fast as possible, and should when I write the standard library for
// a new language, for bc, outputting is not the bottleneck. So we cheese it
// for now.
// Find each percent sign.
while ((percent = strchr(ptr, '%')) != NULL) {
while ((percent = strchr(ptr, '%')) != NULL)
{
char c;
// If the percent sign is not where we are, write what's inbetween to
// the buffer.
if (percent != ptr) {
if (percent != ptr)
{
size_t len = (size_t) (percent - ptr);
bc_file_write(f, bc_flush_none, ptr, len);
}
@ -247,40 +310,42 @@ void bc_file_vprintf(BcFile *restrict f, const char *fmt, va_list args) {
// We only parse some format specifiers, the ones bc uses. If you add
// more, you need to make sure to add them here.
if (c == 'c') {
if (c == 'c')
{
uchar uc = (uchar) va_arg(args, int);
bc_file_putchar(f, bc_flush_none, uc);
}
else if (c == 's') {
char *s = va_arg(args, char*);
else if (c == 's')
{
char* s = va_arg(args, char*);
bc_file_puts(f, bc_flush_none, s);
}
#if BC_DEBUG_CODE
// We only print signed integers in debug code.
else if (c == 'd') {
else if (c == 'd')
{
int d = va_arg(args, int);
// Take care of negative. Let's not worry about overflow.
if (d < 0) {
if (d < 0)
{
bc_file_putchar(f, bc_flush_none, '-');
d = -d;
}
// Either print 0 or translate and print.
if (!d) bc_file_putchar(f, bc_flush_none, '0');
else {
else
{
bc_file_ultoa((unsigned long long) d, buf);
bc_file_puts(f, bc_flush_none, buf);
}
}
#endif // BC_DEBUG_CODE
else {
else
{
unsigned long long ull;
// These are the ones that it expects from here. Fortunately, all of
@ -293,7 +358,8 @@ void bc_file_vprintf(BcFile *restrict f, const char *fmt, va_list args) {
// Either print 0 or translate and print.
if (!ull) bc_file_putchar(f, bc_flush_none, '0');
else {
else
{
bc_file_ultoa(ull, buf);
bc_file_puts(f, bc_flush_none, buf);
}
@ -306,18 +372,42 @@ void bc_file_vprintf(BcFile *restrict f, const char *fmt, va_list args) {
// If we get here, there are no more percent signs, so we just output
// whatever is left.
if (ptr[0]) bc_file_puts(f, bc_flush_none, ptr);
#endif // BC_ENABLE_LINE_LIB
}
void bc_file_puts(BcFile *restrict f, BcFlushType type, const char *str) {
void
bc_file_puts(BcFile* restrict f, BcFlushType type, const char* str)
{
#if BC_ENABLE_LINE_LIB
// This is used because of flushing issues with using bc_file_write() when
// bc is using a line library. It's also using printf() because puts()
// writes a newline.
bc_file_printf(f, "%s", str);
#else // BC_ENABLE_LINE_LIB
bc_file_write(f, type, str, strlen(str));
#endif // BC_ENABLE_LINE_LIB
}
void bc_file_putchar(BcFile *restrict f, BcFlushType type, uchar c) {
void
bc_file_putchar(BcFile* restrict f, BcFlushType type, uchar c)
{
sig_atomic_t lock;
BC_SIG_TRYLOCK(lock);
#if BC_ENABLE_LINE_LIB
if (BC_ERR(fputc(c, f->f) == EOF))
{
// This is here to prevent a stack overflow from unbounded recursion.
if (f->f == stderr) exit(BC_STATUS_ERROR_FATAL);
bc_vm_fatalError(BC_ERR_FATAL_IO_ERR);
}
#else // BC_ENABLE_LINE_LIB
if (f->len == f->cap) bc_file_flush(f, type);
assert(f->len < f->cap);
@ -325,11 +415,25 @@ void bc_file_putchar(BcFile *restrict f, BcFlushType type, uchar c) {
f->buf[f->len] = (char) c;
f->len += 1;
#endif // BC_ENABLE_LINE_LIB
BC_SIG_TRYUNLOCK(lock);
}
void bc_file_init(BcFile *f, int fd, char *buf, size_t cap) {
#if BC_ENABLE_LINE_LIB
void
bc_file_init(BcFile* f, FILE* file)
{
BC_SIG_ASSERT_LOCKED;
f->f = file;
}
#else // BC_ENABLE_LINE_LIB
void
bc_file_init(BcFile* f, int fd, char* buf, size_t cap)
{
BC_SIG_ASSERT_LOCKED;
f->fd = fd;
@ -338,7 +442,11 @@ void bc_file_init(BcFile *f, int fd, char *buf, size_t cap) {
f->cap = cap;
}
void bc_file_free(BcFile *f) {
#endif // BC_ENABLE_LINE_LIB
void
bc_file_free(BcFile* f)
{
BC_SIG_ASSERT_LOCKED;
bc_file_flush(f, bc_flush_none);
}

816
contrib/bc/src/history.c
View File

File diff suppressed because it is too large Load Diff

124
contrib/bc/src/lang.c
View File

@ -41,9 +41,10 @@
#include <program.h>
#include <vm.h>
void bc_const_free(void *constant) {
BcConst *c = constant;
void
bc_const_free(void* constant)
{
BcConst* c = constant;
BC_SIG_ASSERT_LOCKED;
@ -53,8 +54,8 @@ void bc_const_free(void *constant) {
}
#if BC_ENABLED
void bc_func_insert(BcFunc *f, BcProgram *p, char *name,
BcType type, size_t line)
void
bc_func_insert(BcFunc* f, BcProgram* p, char* name, BcType type, size_t line)
{
BcAuto a;
size_t i, idx;
@ -66,15 +67,15 @@ void bc_func_insert(BcFunc *f, BcProgram *p, char *name,
idx = bc_program_search(p, name, type == BC_TYPE_VAR);
// Search through all of the other autos/parameters.
for (i = 0; i < f->autos.len; ++i) {
for (i = 0; i < f->autos.len; ++i)
{
// Get the auto.
BcAuto *aptr = bc_vec_item(&f->autos, i);
BcAuto* aptr = bc_vec_item(&f->autos, i);
// If they match, barf.
if (BC_ERR(idx == aptr->idx && type == aptr->type)) {
const char *array = type == BC_TYPE_ARRAY ? "[]" : "";
if (BC_ERR(idx == aptr->idx && type == aptr->type))
{
const char* array = type == BC_TYPE_ARRAY ? "[]" : "";
bc_error(BC_ERR_PARSE_DUP_LOCAL, line, name, array);
}
@ -89,8 +90,9 @@ void bc_func_insert(BcFunc *f, BcProgram *p, char *name,
}
#endif // BC_ENABLED
void bc_func_init(BcFunc *f, const char *name) {
void
bc_func_init(BcFunc* f, const char* name)
{
BC_SIG_ASSERT_LOCKED;
assert(f != NULL && name != NULL);
@ -104,8 +106,8 @@ void bc_func_init(BcFunc *f, const char *name) {
#if BC_ENABLED
// Only bc needs these things.
if (BC_IS_BC) {
if (BC_IS_BC)
{
bc_vec_init(&f->autos, sizeof(BcAuto), BC_DTOR_NONE);
bc_vec_init(&f->labels, sizeof(size_t), BC_DTOR_NONE);
@ -118,8 +120,9 @@ void bc_func_init(BcFunc *f, const char *name) {
f->name = name;
}
void bc_func_reset(BcFunc *f) {
void
bc_func_reset(BcFunc* f)
{
BC_SIG_ASSERT_LOCKED;
assert(f != NULL);
@ -130,8 +133,8 @@ void bc_func_reset(BcFunc *f) {
bc_vec_popAll(&f->strs);
#if BC_ENABLED
if (BC_IS_BC) {
if (BC_IS_BC)
{
bc_vec_popAll(&f->autos);
bc_vec_popAll(&f->labels);
@ -142,9 +145,10 @@ void bc_func_reset(BcFunc *f) {
}
#ifndef NDEBUG
void bc_func_free(void *func) {
BcFunc *f = (BcFunc*) func;
void
bc_func_free(void* func)
{
BcFunc* f = (BcFunc*) func;
BC_SIG_ASSERT_LOCKED;
assert(f != NULL);
@ -156,8 +160,8 @@ void bc_func_free(void *func) {
bc_vec_free(&f->strs);
#if BC_ENABLED
if (BC_IS_BC) {
if (BC_IS_BC)
{
bc_vec_free(&f->autos);
bc_vec_free(&f->labels);
}
@ -165,8 +169,9 @@ void bc_func_free(void *func) {
}
#endif // NDEBUG
void bc_array_init(BcVec *a, bool nums) {
void
bc_array_init(BcVec* a, bool nums)
{
BC_SIG_ASSERT_LOCKED;
// Set the proper vector.
@ -177,8 +182,9 @@ void bc_array_init(BcVec *a, bool nums) {
bc_array_expand(a, 1);
}
void bc_array_copy(BcVec *d, const BcVec *s) {
void
bc_array_copy(BcVec* d, const BcVec* s)
{
size_t i;
BC_SIG_ASSERT_LOCKED;
@ -196,21 +202,27 @@ void bc_array_copy(BcVec *d, const BcVec *s) {
bc_vec_expand(d, s->cap);
d->len = s->len;
for (i = 0; i < s->len; ++i) {
BcNum *dnum, *snum;
for (i = 0; i < s->len; ++i)
{
BcNum* dnum;
BcNum* snum;
dnum = bc_vec_item(d, i);
snum = bc_vec_item(s, i);
// We have to create a copy of the number as well.
if (BC_PROG_STR(snum)) memcpy(dnum, snum, sizeof(BcNum));
if (BC_PROG_STR(snum))
{
// NOLINTNEXTLINE
memcpy(dnum, snum, sizeof(BcNum));
}
else bc_num_createCopy(dnum, snum);
}
}
void bc_array_expand(BcVec *a, size_t len) {
void
bc_array_expand(BcVec* a, size_t len)
{
assert(a != NULL);
BC_SIG_ASSERT_LOCKED;
@ -218,36 +230,41 @@ void bc_array_expand(BcVec *a, size_t len) {
bc_vec_expand(a, len);
// If this is true, then we have a num array.
if (a->size == sizeof(BcNum) && a->dtor == BC_DTOR_NUM) {
if (a->size == sizeof(BcNum) && a->dtor == BC_DTOR_NUM)
{
// Initialize numbers until we reach the target.
while (len > a->len) {
BcNum *n = bc_vec_pushEmpty(a);
while (len > a->len)
{
BcNum* n = bc_vec_pushEmpty(a);
bc_num_init(n, BC_NUM_DEF_SIZE);
}
}
else {
else
{
assert(a->size == sizeof(BcVec) && a->dtor == BC_DTOR_VEC);
// Recursively initialize arrays until we reach the target. Having the
// second argument of bc_array_init() be true will activate the base
// case, so we're safe.
while (len > a->len) {
BcVec *v = bc_vec_pushEmpty(a);
while (len > a->len)
{
BcVec* v = bc_vec_pushEmpty(a);
bc_array_init(v, true);
}
}
}
void bc_result_clear(BcResult *r) {
void
bc_result_clear(BcResult* r)
{
r->t = BC_RESULT_TEMP;
bc_num_clear(&r->d.n);
}
#if DC_ENABLED
void bc_result_copy(BcResult *d, BcResult *src) {
void
bc_result_copy(BcResult* d, BcResult* src)
{
assert(d != NULL && src != NULL);
BC_SIG_ASSERT_LOCKED;
@ -256,8 +273,8 @@ void bc_result_copy(BcResult *d, BcResult *src) {
d->t = src->t;
// Yes, it depends on what type.
switch (d->t) {
switch (d->t)
{
case BC_RESULT_TEMP:
case BC_RESULT_IBASE:
case BC_RESULT_SCALE:
@ -274,12 +291,14 @@ void bc_result_copy(BcResult *d, BcResult *src) {
case BC_RESULT_ARRAY:
case BC_RESULT_ARRAY_ELEM:
{
// NOLINTNEXTLINE
memcpy(&d->d.loc, &src->d.loc, sizeof(BcLoc));
break;
}
case BC_RESULT_STR:
{
// NOLINTNEXTLINE
memcpy(&d->d.n, &src->d.n, sizeof(BcNum));
break;
}
@ -305,16 +324,17 @@ void bc_result_copy(BcResult *d, BcResult *src) {
}
#endif // DC_ENABLED
void bc_result_free(void *result) {
BcResult *r = (BcResult*) result;
void
bc_result_free(void* result)
{
BcResult* r = (BcResult*) result;
BC_SIG_ASSERT_LOCKED;
assert(r != NULL);
switch (r->t) {
switch (r->t)
{
case BC_RESULT_TEMP:
case BC_RESULT_IBASE:
case BC_RESULT_SCALE:

145
contrib/bc/src/lex.c
View File

@ -42,20 +42,28 @@
#include <vm.h>
#include <bc.h>
void bc_lex_invalidChar(BcLex *l, char c) {
void
bc_lex_invalidChar(BcLex* l, char c)
{
l->t = BC_LEX_INVALID;
bc_lex_verr(l, BC_ERR_PARSE_CHAR, c);
}
void bc_lex_lineComment(BcLex *l) {
void
bc_lex_lineComment(BcLex* l)
{
l->t = BC_LEX_WHITESPACE;
while (l->i < l->len && l->buf[l->i] != '\n') l->i += 1;
while (l->i < l->len && l->buf[l->i] != '\n')
{
l->i += 1;
}
}
void bc_lex_comment(BcLex *l) {
void
bc_lex_comment(BcLex* l)
{
size_t i, nlines = 0;
const char *buf;
const char* buf;
bool end = false, got_more;
char c;
@ -65,8 +73,8 @@ void bc_lex_comment(BcLex *l) {
// This loop is complex because it might need to request more data from
// stdin if the comment is not ended. This loop is taken until the comment
// is finished or we have EOF.
do {
do
{
buf = l->buf;
got_more = false;
@ -74,17 +82,22 @@ void bc_lex_comment(BcLex *l) {
assert(!vm.is_stdin || buf == vm.buffer.v);
// Find the end of the comment.
for (i = l->i; !end; i += !end) {
for (i = l->i; !end; i += !end)
{
// While we don't have an asterisk, eat, but increment nlines.
for (; (c = buf[i]) && c != '*'; ++i) nlines += (c == '\n');
for (; (c = buf[i]) && c != '*'; ++i)
{
nlines += (c == '\n');
}
// If this is true, we need to request more data.
if (BC_ERR(!c || buf[i + 1] == '\0')) {
if (BC_ERR(!c || buf[i + 1] == '\0'))
{
// Read more, if possible.
if (!vm.eof && (l->is_stdin || l->is_exprs))
{
got_more = bc_lex_readLine(l);
}
break;
}
@ -92,11 +105,12 @@ void bc_lex_comment(BcLex *l) {
// If this turns true, we found the end. Yay!
end = (buf[i + 1] == '/');
}
} while (got_more && !end);
}
while (got_more && !end);
// If we didn't find the end, barf.
if (!end) {
if (!end)
{
l->i = i;
bc_lex_err(l, BC_ERR_PARSE_COMMENT);
}
@ -105,17 +119,23 @@ void bc_lex_comment(BcLex *l) {
l->line += nlines;
}
void bc_lex_whitespace(BcLex *l) {
void
bc_lex_whitespace(BcLex* l)
{
char c;
l->t = BC_LEX_WHITESPACE;
// Eat. We don't eat newlines because they can be special.
for (c = l->buf[l->i]; c != '\n' && isspace(c); c = l->buf[++l->i]);
for (c = l->buf[l->i]; c != '\n' && isspace(c); c = l->buf[++l->i])
{
continue;
}
}
void bc_lex_commonTokens(BcLex *l, char c) {
void
bc_lex_commonTokens(BcLex* l, char c)
{
if (!c) l->t = BC_LEX_EOF;
else if (c == '\n') l->t = BC_LEX_NLINE;
else bc_lex_whitespace(l);
@ -128,9 +148,10 @@ void bc_lex_commonTokens(BcLex *l, char c) {
* @param int_only Whether this function should only look for an integer. This
* is used to implement the exponent of scientific notation.
*/
static size_t bc_lex_num(BcLex *l, char start, bool int_only) {
const char *buf = l->buf + l->i;
static size_t
bc_lex_num(BcLex* l, char start, bool int_only)
{
const char* buf = l->buf + l->i;
size_t i;
char c;
bool last_pt, pt = (start == '.');
@ -140,16 +161,20 @@ static size_t bc_lex_num(BcLex *l, char start, bool int_only) {
// thus far, or whether it is a backslash followed by a newline. I can do
// i+1 on the buffer because the buffer must have a nul byte.
for (i = 0; (c = buf[i]) && (BC_LEX_NUM_CHAR(c, pt, int_only) ||
(c == '\\' && buf[i + 1] == '\n')); ++i)
(c == '\\' && buf[i + 1] == '\n'));
++i)
{
// I don't need to test that the next character is a newline because
// the loop condition above ensures that.
if (c == '\\') {
if (c == '\\')
{
i += 2;
// Make sure to eat whitespace at the beginning of the line.
while(isspace(buf[i]) && buf[i] != '\n') i += 1;
while (isspace(buf[i]) && buf[i] != '\n')
{
i += 1;
}
c = buf[i];
@ -173,8 +198,9 @@ static size_t bc_lex_num(BcLex *l, char start, bool int_only) {
return i;
}
void bc_lex_number(BcLex *l, char start) {
void
bc_lex_number(BcLex* l, char start)
{
l->t = BC_LEX_NUMBER;
// Make sure the string is clear.
@ -189,8 +215,8 @@ void bc_lex_number(BcLex *l, char start) {
char c = l->buf[l->i];
// Do we have a number in scientific notation?
if (c == 'e') {
if (c == 'e')
{
#if BC_ENABLED
// Barf for POSIX.
if (BC_IS_POSIX) bc_lex_err(l, BC_ERR_POSIX_EXP_NUM);
@ -202,7 +228,8 @@ void bc_lex_number(BcLex *l, char start) {
c = l->buf[l->i];
// Check for negative specifically because bc_lex_num() does not.
if (c == BC_LEX_NEG_CHAR) {
if (c == BC_LEX_NEG_CHAR)
{
bc_vec_push(&l->str, &c);
l->i += 1;
c = l->buf[l->i];
@ -210,7 +237,9 @@ void bc_lex_number(BcLex *l, char start) {
// We must have a number character, so barf if not.
if (BC_ERR(!BC_LEX_NUM_CHAR(c, false, true)))
{
bc_lex_verr(l, BC_ERR_PARSE_CHAR, c);
}
// Parse the exponent.
l->i += bc_lex_num(l, 0, true);
@ -221,16 +250,20 @@ void bc_lex_number(BcLex *l, char start) {
bc_vec_pushByte(&l->str, '\0');
}
void bc_lex_name(BcLex *l) {
void
bc_lex_name(BcLex* l)
{
size_t i = 0;
const char *buf = l->buf + l->i - 1;
const char* buf = l->buf + l->i - 1;
char c = buf[i];
l->t = BC_LEX_NAME;
// Should be obvious. It's looking for valid characters.
while ((c >= 'a' && c <= 'z') || isdigit(c) || c == '_') c = buf[++i];
while ((c >= 'a' && c <= 'z') || isdigit(c) || c == '_')
{
c = buf[++i];
}
// Set the string to the identifier.
bc_vec_string(&l->str, i, buf);
@ -239,26 +272,33 @@ void bc_lex_name(BcLex *l) {
l->i += i - 1;
}
void bc_lex_init(BcLex *l) {
void
bc_lex_init(BcLex* l)
{
BC_SIG_ASSERT_LOCKED;
assert(l != NULL);
bc_vec_init(&l->str, sizeof(char), BC_DTOR_NONE);
}
void bc_lex_free(BcLex *l) {
void
bc_lex_free(BcLex* l)
{
BC_SIG_ASSERT_LOCKED;
assert(l != NULL);
bc_vec_free(&l->str);
}
void bc_lex_file(BcLex *l, const char *file) {
void
bc_lex_file(BcLex* l, const char* file)
{
assert(l != NULL && file != NULL);
l->line = 1;
vm.file = file;
}
void bc_lex_next(BcLex *l) {
void
bc_lex_next(BcLex* l)
{
BC_SIG_ASSERT_LOCKED;
assert(l != NULL);
@ -278,9 +318,11 @@ void bc_lex_next(BcLex *l) {
// Loop until failure or we don't have whitespace. This
// is so the parser doesn't get inundated with whitespace.
do {
do
{
vm.next(l);
} while (l->t == BC_LEX_WHITESPACE);
}
while (l->t == BC_LEX_WHITESPACE);
}
/**
@ -290,13 +332,16 @@ void bc_lex_next(BcLex *l) {
* @param text The text.
* @param len The length of the text.
*/
static void bc_lex_fixText(BcLex *l, const char *text, size_t len) {
static void
bc_lex_fixText(BcLex* l, const char* text, size_t len)
{
l->buf = text;
l->len = len;
}
bool bc_lex_readLine(BcLex *l) {
bool
bc_lex_readLine(BcLex* l)
{
bool good;
// These are reversed because they should be already locked, but
@ -305,7 +350,8 @@ bool bc_lex_readLine(BcLex *l) {
// Make sure we read from the appropriate place.
if (l->is_stdin) good = bc_vm_readLine(false);
else {
else
{
assert(l->is_exprs);
good = bc_vm_readBuf(false);
}
@ -317,8 +363,9 @@ bool bc_lex_readLine(BcLex *l) {
return good;
}
void bc_lex_text(BcLex *l, const char *text, bool is_stdin, bool is_exprs) {
void
bc_lex_text(BcLex* l, const char* text, bool is_stdin, bool is_exprs)
{
BC_SIG_ASSERT_LOCKED;
assert(l != NULL && text != NULL);

387
contrib/bc/src/library.c
View File

@ -57,8 +57,9 @@
// have to reset the jumps every time to ensure that the locals will be correct
// after jumping.
void bcl_handleSignal(void) {
void
bcl_handleSignal(void)
{
// Signal already in flight, or bc is not executing.
if (vm.sig || !vm.running) return;
@ -69,19 +70,23 @@ void bcl_handleSignal(void) {
if (!vm.sig_lock) BC_JMP;
}
bool bcl_running(void) {
bool
bcl_running(void)
{
return vm.running != 0;
}
BclError bcl_init(void) {
BclError
bcl_init(void)
{
BclError e = BCL_ERROR_NONE;
BC_SIG_LOCK;
vm.refs += 1;
if (vm.refs > 1) {
if (vm.refs > 1)
{
BC_SIG_UNLOCK;
return e;
}
@ -110,7 +115,8 @@ BclError bcl_init(void) {
err:
// This is why we had to set them to NULL.
if (BC_ERR(vm.err)) {
if (BC_ERR(vm.err))
{
if (vm.out.v != NULL) bc_vec_free(&vm.out);
if (vm.jmp_bufs.v != NULL) bc_vec_free(&vm.jmp_bufs);
if (vm.ctxts.v != NULL) bc_vec_free(&vm.ctxts);
@ -123,8 +129,9 @@ BclError bcl_init(void) {
return e;
}
BclError bcl_pushContext(BclContext ctxt) {
BclError
bcl_pushContext(BclContext ctxt)
{
BclError e = BCL_ERROR_NONE;
BC_FUNC_HEADER_LOCK(err);
@ -136,24 +143,30 @@ BclError bcl_pushContext(BclContext ctxt) {
return e;
}
void bcl_popContext(void) {
void
bcl_popContext(void)
{
if (vm.ctxts.len) bc_vec_pop(&vm.ctxts);
}
BclContext bcl_context(void) {
BclContext
bcl_context(void)
{
if (!vm.ctxts.len) return NULL;
return *((BclContext*) bc_vec_top(&vm.ctxts));
}
void bcl_free(void) {
void
bcl_free(void)
{
size_t i;
BC_SIG_LOCK;
vm.refs -= 1;
if (vm.refs) {
if (vm.refs)
{
BC_SIG_UNLOCK;
return;
}
@ -161,7 +174,8 @@ void bcl_free(void) {
bc_rand_free(&vm.rng);
bc_vec_free(&vm.out);
for (i = 0; i < vm.ctxts.len; ++i) {
for (i = 0; i < vm.ctxts.len; ++i)
{
BclContext ctxt = *((BclContext*) bc_vec_item(&vm.ctxts, i));
bcl_ctxt_free(ctxt);
}
@ -177,30 +191,41 @@ void bcl_free(void) {
assert(!vm.running && !vm.sig && !vm.sig_lock);
}
void bcl_gc(void) {
void
bcl_gc(void)
{
BC_SIG_LOCK;
bc_vm_freeTemps();
BC_SIG_UNLOCK;
}
bool bcl_abortOnFatalError(void) {
bool
bcl_abortOnFatalError(void)
{
return vm.abrt;
}
void bcl_setAbortOnFatalError(bool abrt) {
void
bcl_setAbortOnFatalError(bool abrt)
{
vm.abrt = abrt;
}
bool bcl_leadingZeroes(void) {
bool
bcl_leadingZeroes(void)
{
return vm.leading_zeroes;
}
void bcl_setLeadingZeroes(bool leadingZeroes) {
void
bcl_setLeadingZeroes(bool leadingZeroes)
{
vm.leading_zeroes = leadingZeroes;
}
BclContext bcl_ctxt_create(void) {
BclContext
bcl_ctxt_create(void)
{
BclContext ctxt = NULL;
BC_FUNC_HEADER_LOCK(err);
@ -214,10 +239,11 @@ BclContext bcl_ctxt_create(void) {
ctxt->scale = 0;
ctxt->ibase = 10;
ctxt->obase= 10;
ctxt->obase = 10;
err:
if (BC_ERR(vm.err && ctxt != NULL)) {
if (BC_ERR(vm.err && ctxt != NULL))
{
if (ctxt->nums.v != NULL) bc_vec_free(&ctxt->nums);
free(ctxt);
ctxt = NULL;
@ -230,7 +256,9 @@ BclContext bcl_ctxt_create(void) {
return ctxt;
}
void bcl_ctxt_free(BclContext ctxt) {
void
bcl_ctxt_free(BclContext ctxt)
{
BC_SIG_LOCK;
bc_vec_free(&ctxt->free_nums);
bc_vec_free(&ctxt->nums);
@ -238,46 +266,62 @@ void bcl_ctxt_free(BclContext ctxt) {
BC_SIG_UNLOCK;
}
void bcl_ctxt_freeNums(BclContext ctxt) {
void
bcl_ctxt_freeNums(BclContext ctxt)
{
bc_vec_popAll(&ctxt->nums);
bc_vec_popAll(&ctxt->free_nums);
}
size_t bcl_ctxt_scale(BclContext ctxt) {
size_t
bcl_ctxt_scale(BclContext ctxt)
{
return ctxt->scale;
}
void bcl_ctxt_setScale(BclContext ctxt, size_t scale) {
void
bcl_ctxt_setScale(BclContext ctxt, size_t scale)
{
ctxt->scale = scale;
}
size_t bcl_ctxt_ibase(BclContext ctxt) {
size_t
bcl_ctxt_ibase(BclContext ctxt)
{
return ctxt->ibase;
}
void bcl_ctxt_setIbase(BclContext ctxt, size_t ibase) {
void
bcl_ctxt_setIbase(BclContext ctxt, size_t ibase)
{
if (ibase < BC_NUM_MIN_BASE) ibase = BC_NUM_MIN_BASE;
else if (ibase > BC_NUM_MAX_IBASE) ibase = BC_NUM_MAX_IBASE;
ctxt->ibase = ibase;
}
size_t bcl_ctxt_obase(BclContext ctxt) {
size_t
bcl_ctxt_obase(BclContext ctxt)
{
return ctxt->obase;
}
void bcl_ctxt_setObase(BclContext ctxt, size_t obase) {
void
bcl_ctxt_setObase(BclContext ctxt, size_t obase)
{
ctxt->obase = obase;
}
BclError bcl_err(BclNumber n) {
BclError
bcl_err(BclNumber n)
{
BclContext ctxt;
BC_CHECK_CTXT_ERR(ctxt);
// Errors are encoded as (0 - error_code). If the index is in that range, it
// is an encoded error.
if (n.i >= ctxt->nums.len) {
if (n.i >= ctxt->nums.len)
{
if (n.i > 0 - (size_t) BCL_ERROR_NELEMS) return (BclError) (0 - n.i);
else return BCL_ERROR_INVALID_NUM;
}
@ -290,14 +334,15 @@ BclError bcl_err(BclNumber n) {
* @param n The BcNum to insert.
* @return The resulting BclNumber from the insert.
*/
static BclNumber bcl_num_insert(BclContext ctxt, BcNum *restrict n) {
static BclNumber
bcl_num_insert(BclContext ctxt, BcNum* restrict n)
{
BclNumber idx;
// If there is a free spot...
if (ctxt->free_nums.len) {
BcNum *ptr;
if (ctxt->free_nums.len)
{
BcNum* ptr;
// Get the index of the free spot and remove it.
idx = *((BclNumber*) bc_vec_top(&ctxt->free_nums));
@ -307,7 +352,8 @@ static BclNumber bcl_num_insert(BclContext ctxt, BcNum *restrict n) {
ptr = bc_vec_item(&ctxt->nums, idx.i);
memcpy(ptr, n, sizeof(BcNum));
}
else {
else
{
// Just push the number onto the vector.
idx.i = ctxt->nums.len;
bc_vec_push(&ctxt->nums, n);
@ -318,8 +364,9 @@ static BclNumber bcl_num_insert(BclContext ctxt, BcNum *restrict n) {
return idx;
}
BclNumber bcl_num_create(void) {
BclNumber
bcl_num_create(void)
{
BclError e = BCL_ERROR_NONE;
BcNum n;
BclNumber idx;
@ -348,8 +395,9 @@ BclNumber bcl_num_create(void) {
* @param n The index of the number.
* @param num The number to destroy.
*/
static void bcl_num_dtor(BclContext ctxt, BclNumber n, BcNum *restrict num) {
static void
bcl_num_dtor(BclContext ctxt, BclNumber n, BcNum* restrict num)
{
BC_SIG_ASSERT_LOCKED;
assert(num != NULL && num->num != NULL);
@ -358,9 +406,10 @@ static void bcl_num_dtor(BclContext ctxt, BclNumber n, BcNum *restrict num) {
bc_vec_push(&ctxt->free_nums, &n);
}
void bcl_num_free(BclNumber n) {
BcNum *num;
void
bcl_num_free(BclNumber n)
{
BcNum* num;
BclContext ctxt;
BC_CHECK_CTXT_ASSERT(ctxt);
@ -376,10 +425,12 @@ void bcl_num_free(BclNumber n) {
BC_SIG_UNLOCK;
}
BclError bcl_copy(BclNumber d, BclNumber s) {
BclError
bcl_copy(BclNumber d, BclNumber s)
{
BclError e = BCL_ERROR_NONE;
BcNum *dest, *src;
BcNum* dest;
BcNum* src;
BclContext ctxt;
BC_CHECK_CTXT_ERR(ctxt);
@ -404,8 +455,9 @@ BclError bcl_copy(BclNumber d, BclNumber s) {
return e;
}
BclNumber bcl_dup(BclNumber s) {
BclNumber
bcl_dup(BclNumber s)
{
BclError e = BCL_ERROR_NONE;
BcNum *src, dest;
BclNumber idx;
@ -436,9 +488,10 @@ BclNumber bcl_dup(BclNumber s) {
return idx;
}
void bcl_num_destruct(void *num) {
BcNum *n = (BcNum*) num;
void
bcl_num_destruct(void* num)
{
BcNum* n = (BcNum*) num;
assert(n != NULL);
@ -448,9 +501,10 @@ void bcl_num_destruct(void *num) {
bc_num_clear(num);
}
bool bcl_num_neg(BclNumber n) {
BcNum *num;
bool
bcl_num_neg(BclNumber n)
{
BcNum* num;
BclContext ctxt;
BC_CHECK_CTXT_ASSERT(ctxt);
@ -464,9 +518,10 @@ bool bcl_num_neg(BclNumber n) {
return BC_NUM_NEG(num) != 0;
}
void bcl_num_setNeg(BclNumber n, bool neg) {
BcNum *num;
void
bcl_num_setNeg(BclNumber n, bool neg)
{
BcNum* num;
BclContext ctxt;
BC_CHECK_CTXT_ASSERT(ctxt);
@ -480,9 +535,10 @@ void bcl_num_setNeg(BclNumber n, bool neg) {
num->rdx = BC_NUM_NEG_VAL(num, neg);
}
size_t bcl_num_scale(BclNumber n) {
BcNum *num;
size_t
bcl_num_scale(BclNumber n)
{
BcNum* num;
BclContext ctxt;
BC_CHECK_CTXT_ASSERT(ctxt);
@ -496,10 +552,11 @@ size_t bcl_num_scale(BclNumber n) {
return bc_num_scale(num);
}
BclError bcl_num_setScale(BclNumber n, size_t scale) {
BclError
bcl_num_setScale(BclNumber n, size_t scale)
{
BclError e = BCL_ERROR_NONE;
BcNum *nptr;
BcNum* nptr;
BclContext ctxt;
BC_CHECK_CTXT_ERR(ctxt);
@ -526,9 +583,10 @@ BclError bcl_num_setScale(BclNumber n, size_t scale) {
return e;
}
size_t bcl_num_len(BclNumber n) {
BcNum *num;
size_t
bcl_num_len(BclNumber n)
{
BcNum* num;
BclContext ctxt;
BC_CHECK_CTXT_ASSERT(ctxt);
@ -542,10 +600,11 @@ size_t bcl_num_len(BclNumber n) {
return bc_num_len(num);
}
BclError bcl_bigdig(BclNumber n, BclBigDig *result) {
BclError
bcl_bigdig(BclNumber n, BclBigDig* result)
{
BclError e = BCL_ERROR_NONE;
BcNum *num;
BcNum* num;
BclContext ctxt;
BC_CHECK_CTXT_ERR(ctxt);
@ -570,8 +629,9 @@ BclError bcl_bigdig(BclNumber n, BclBigDig *result) {
return e;
}
BclNumber bcl_bigdig2num(BclBigDig val) {
BclNumber
bcl_bigdig2num(BclBigDig val)
{
BclError e = BCL_ERROR_NONE;
BcNum n;
BclNumber idx;
@ -602,11 +662,13 @@ BclNumber bcl_bigdig2num(BclBigDig val) {
* @param req The function to get the size of the result for preallocation.
* @return The result of the operation.
*/
static BclNumber bcl_binary(BclNumber a, BclNumber b, const BcNumBinaryOp op,
const BcNumBinaryOpReq req)
static BclNumber
bcl_binary(BclNumber a, BclNumber b, const BcNumBinaryOp op,
const BcNumBinaryOpReq req)
{
BclError e = BCL_ERROR_NONE;
BcNum *aptr, *bptr;
BcNum* aptr;
BcNum* bptr;
BcNum c;
BclNumber idx;
BclContext ctxt;
@ -652,42 +714,59 @@ static BclNumber bcl_binary(BclNumber a, BclNumber b, const BcNumBinaryOp op,
return idx;
}
BclNumber bcl_add(BclNumber a, BclNumber b) {
BclNumber
bcl_add(BclNumber a, BclNumber b)
{
return bcl_binary(a, b, bc_num_add, bc_num_addReq);
}
BclNumber bcl_sub(BclNumber a, BclNumber b) {
BclNumber
bcl_sub(BclNumber a, BclNumber b)
{
return bcl_binary(a, b, bc_num_sub, bc_num_addReq);
}
BclNumber bcl_mul(BclNumber a, BclNumber b) {
BclNumber
bcl_mul(BclNumber a, BclNumber b)
{
return bcl_binary(a, b, bc_num_mul, bc_num_mulReq);
}
BclNumber bcl_div(BclNumber a, BclNumber b) {
BclNumber
bcl_div(BclNumber a, BclNumber b)
{
return bcl_binary(a, b, bc_num_div, bc_num_divReq);
}
BclNumber bcl_mod(BclNumber a, BclNumber b) {
BclNumber
bcl_mod(BclNumber a, BclNumber b)
{
return bcl_binary(a, b, bc_num_mod, bc_num_divReq);
}
BclNumber bcl_pow(BclNumber a, BclNumber b) {
BclNumber
bcl_pow(BclNumber a, BclNumber b)
{
return bcl_binary(a, b, bc_num_pow, bc_num_powReq);
}
BclNumber bcl_lshift(BclNumber a, BclNumber b) {
BclNumber
bcl_lshift(BclNumber a, BclNumber b)
{
return bcl_binary(a, b, bc_num_lshift, bc_num_placesReq);
}
BclNumber bcl_rshift(BclNumber a, BclNumber b) {
BclNumber
bcl_rshift(BclNumber a, BclNumber b)
{
return bcl_binary(a, b, bc_num_rshift, bc_num_placesReq);
}
BclNumber bcl_sqrt(BclNumber a) {
BclNumber
bcl_sqrt(BclNumber a)
{
BclError e = BCL_ERROR_NONE;
BcNum *aptr;
BcNum* aptr;
BcNum b;
BclNumber idx;
BclContext ctxt;
@ -717,11 +796,13 @@ BclNumber bcl_sqrt(BclNumber a) {
return idx;
}
BclError bcl_divmod(BclNumber a, BclNumber b, BclNumber *c, BclNumber *d) {
BclError
bcl_divmod(BclNumber a, BclNumber b, BclNumber* c, BclNumber* d)
{
BclError e = BCL_ERROR_NONE;
size_t req;
BcNum *aptr, *bptr;
BcNum* aptr;
BcNum* bptr;
BcNum cnum, dnum;
BclContext ctxt;
@ -765,8 +846,8 @@ BclError bcl_divmod(BclNumber a, BclNumber b, BclNumber *c, BclNumber *d) {
if (b.i != a.i) bcl_num_dtor(ctxt, b, bptr);
// If there was an error...
if (BC_ERR(vm.err)) {
if (BC_ERR(vm.err))
{
// Free the results.
if (cnum.num != NULL) bc_num_free(&cnum);
if (dnum.num != NULL) bc_num_free(&dnum);
@ -777,8 +858,8 @@ BclError bcl_divmod(BclNumber a, BclNumber b, BclNumber *c, BclNumber *d) {
BC_FUNC_FOOTER(e);
}
else {
else
{
BC_FUNC_FOOTER(e);
// Insert the results into the context.
@ -791,11 +872,14 @@ BclError bcl_divmod(BclNumber a, BclNumber b, BclNumber *c, BclNumber *d) {
return e;
}
BclNumber bcl_modexp(BclNumber a, BclNumber b, BclNumber c) {
BclNumber
bcl_modexp(BclNumber a, BclNumber b, BclNumber c)
{
BclError e = BCL_ERROR_NONE;
size_t req;
BcNum *aptr, *bptr, *cptr;
BcNum* aptr;
BcNum* bptr;
BcNum* cptr;
BcNum d;
BclNumber idx;
BclContext ctxt;
@ -848,9 +932,11 @@ BclNumber bcl_modexp(BclNumber a, BclNumber b, BclNumber c) {
return idx;
}
ssize_t bcl_cmp(BclNumber a, BclNumber b) {
BcNum *aptr, *bptr;
ssize_t
bcl_cmp(BclNumber a, BclNumber b)
{
BcNum* aptr;
BcNum* bptr;
BclContext ctxt;
BC_CHECK_CTXT_ASSERT(ctxt);
@ -866,9 +952,10 @@ ssize_t bcl_cmp(BclNumber a, BclNumber b) {
return bc_num_cmp(aptr, bptr);
}
void bcl_zero(BclNumber n) {
BcNum *nptr;
void
bcl_zero(BclNumber n)
{
BcNum* nptr;
BclContext ctxt;
BC_CHECK_CTXT_ASSERT(ctxt);
@ -882,9 +969,10 @@ void bcl_zero(BclNumber n) {
bc_num_zero(nptr);
}
void bcl_one(BclNumber n) {
BcNum *nptr;
void
bcl_one(BclNumber n)
{
BcNum* nptr;
BclContext ctxt;
BC_CHECK_CTXT_ASSERT(ctxt);
@ -898,8 +986,9 @@ void bcl_one(BclNumber n) {
bc_num_one(nptr);
}
BclNumber bcl_parse(const char *restrict val) {
BclNumber
bcl_parse(const char* restrict val)
{
BclError e = BCL_ERROR_NONE;
BcNum n;
BclNumber idx;
@ -920,7 +1009,8 @@ BclNumber bcl_parse(const char *restrict val) {
if (neg) val += 1;
if (!bc_num_strValid(val)) {
if (!bc_num_strValid(val))
{
vm.err = BCL_ERROR_PARSE_INVALID_STR;
goto err;
}
@ -946,10 +1036,11 @@ BclNumber bcl_parse(const char *restrict val) {
return idx;
}
char* bcl_string(BclNumber n) {
BcNum *nptr;
char *str = NULL;
char*
bcl_string(BclNumber n)
{
BcNum* nptr;
char* str = NULL;
BclContext ctxt;
BC_CHECK_CTXT_ASSERT(ctxt);
@ -988,10 +1079,11 @@ char* bcl_string(BclNumber n) {
return str;
}
BclNumber bcl_irand(BclNumber a) {
BclNumber
bcl_irand(BclNumber a)
{
BclError e = BCL_ERROR_NONE;
BcNum *aptr;
BcNum* aptr;
BcNum b;
BclNumber idx;
BclContext ctxt;
@ -1038,8 +1130,9 @@ BclNumber bcl_irand(BclNumber a) {
* @param b The return parameter.
* @param places The number of decimal places to generate.
*/
static void bcl_frandHelper(BcNum *restrict b, size_t places) {
static void
bcl_frandHelper(BcNum* restrict b, size_t places)
{
BcNum exp, pow, ten;
BcDig exp_digs[BC_NUM_BIGDIG_LOG10];
BcDig ten_digs[BC_NUM_BIGDIG_LOG10];
@ -1078,8 +1171,9 @@ static void bcl_frandHelper(BcNum *restrict b, size_t places) {
BC_LONGJMP_CONT;
}
BclNumber bcl_frand(size_t places) {
BclNumber
bcl_frand(size_t places)
{
BclError e = BCL_ERROR_NONE;
BcNum n;
BclNumber idx;
@ -1117,8 +1211,8 @@ BclNumber bcl_frand(size_t places) {
* @param b The return parameter.
* @param places The number of decimal places to generate.
*/
static void bcl_ifrandHelper(BcNum *restrict a, BcNum *restrict b,
size_t places)
static void
bcl_ifrandHelper(BcNum* restrict a, BcNum* restrict b, size_t places)
{
BcNum ir, fr;
@ -1148,10 +1242,11 @@ static void bcl_ifrandHelper(BcNum *restrict a, BcNum *restrict b,
BC_LONGJMP_CONT;
}
BclNumber bcl_ifrand(BclNumber a, size_t places) {
BclNumber
bcl_ifrand(BclNumber a, size_t places)
{
BclError e = BCL_ERROR_NONE;
BcNum *aptr;
BcNum* aptr;
BcNum b;
BclNumber idx;
BclContext ctxt;
@ -1191,10 +1286,11 @@ BclNumber bcl_ifrand(BclNumber a, size_t places) {
return idx;
}
BclError bcl_rand_seedWithNum(BclNumber n) {
BclError
bcl_rand_seedWithNum(BclNumber n)
{
BclError e = BCL_ERROR_NONE;
BcNum *nptr;
BcNum* nptr;
BclContext ctxt;
BC_CHECK_CTXT_ERR(ctxt);
@ -1219,8 +1315,9 @@ BclError bcl_rand_seedWithNum(BclNumber n) {
return e;
}
BclError bcl_rand_seed(unsigned char seed[BCL_SEED_SIZE]) {
BclError
bcl_rand_seed(unsigned char seed[BCL_SEED_SIZE])
{
BclError e = BCL_ERROR_NONE;
size_t i;
ulong vals[BCL_SEED_ULONGS];
@ -1228,9 +1325,10 @@ BclError bcl_rand_seed(unsigned char seed[BCL_SEED_SIZE]) {
BC_FUNC_HEADER(err);
// Fill the array.
for (i = 0; i < BCL_SEED_SIZE; ++i) {
ulong val = ((ulong) seed[i]) << (((ulong) CHAR_BIT) *
(i % sizeof(ulong)));
for (i = 0; i < BCL_SEED_SIZE; ++i)
{
ulong val = ((ulong) seed[i])
<< (((ulong) CHAR_BIT) * (i % sizeof(ulong)));
vals[i / sizeof(long)] |= val;
}
@ -1242,12 +1340,15 @@ BclError bcl_rand_seed(unsigned char seed[BCL_SEED_SIZE]) {
return e;
}
void bcl_rand_reseed(void) {
void
bcl_rand_reseed(void)
{
bc_rand_srand(bc_vec_top(&vm.rng.v));
}
BclNumber bcl_rand_seed2num(void) {
BclNumber
bcl_rand_seed2num(void)
{
BclError e = BCL_ERROR_NONE;
BcNum n;
BclNumber idx;
@ -1275,11 +1376,15 @@ BclNumber bcl_rand_seed2num(void) {
return idx;
}
BclRandInt bcl_rand_int(void) {
BclRandInt
bcl_rand_int(void)
{
return (BclRandInt) bc_rand_int(&vm.rng);
}
BclRandInt bcl_rand_bounded(BclRandInt bound) {
BclRandInt
bcl_rand_bounded(BclRandInt bound)
{
if (bound <= 1) return 0;
return (BclRandInt) bc_rand_bounded(&vm.rng, (BcRand) bound);
}

11
contrib/bc/src/main.c
View File

@ -53,9 +53,10 @@
#include <bc.h>
#include <dc.h>
int main(int argc, char *argv[]) {
char *name;
int
main(int argc, char* argv[])
{
char* name;
size_t len = strlen(BC_EXECPREFIX);
#if BC_ENABLE_NLS
@ -67,8 +68,8 @@ int main(int argc, char *argv[]) {
bc_pledge(bc_pledge_start, NULL);
// Sometimes, argv[0] can be NULL. Better make sure to be robust against it.
if (argv[0] != NULL) {
if (argv[0] != NULL)
{
// Figure out the name of the calculator we are using. We can't use
// basename because it's not portable, but yes, this is stripping off
// the directory.

1188
contrib/bc/src/num.c
View File

File diff suppressed because it is too large Load Diff

141
contrib/bc/src/opt.c
View File

@ -53,7 +53,9 @@
* @param i The index to test.
* @return True if @a i is the last index, false otherwise.
*/
static inline bool bc_opt_longoptsEnd(const BcOptLong *longopts, size_t i) {
static inline bool
bc_opt_longoptsEnd(const BcOptLong* longopts, size_t i)
{
return !longopts[i].name && !longopts[i].val;
}
@ -63,11 +65,13 @@ static inline bool bc_opt_longoptsEnd(const BcOptLong *longopts, size_t i) {
* @param c The character to match against.
* @return The name of the long option that matches @a c, or "NULL".
*/
static const char* bc_opt_longopt(const BcOptLong *longopts, int c) {
static const char*
bc_opt_longopt(const BcOptLong* longopts, int c)
{
size_t i;
for (i = 0; !bc_opt_longoptsEnd(longopts, i); ++i) {
for (i = 0; !bc_opt_longoptsEnd(longopts, i); ++i)
{
if (longopts[i].val == c) return longopts[i].name;
}
@ -85,12 +89,13 @@ static const char* bc_opt_longopt(const BcOptLong *longopts, int c) {
* @param use_short True if the short option should be used for error printing,
* false otherwise.
*/
static void bc_opt_error(BcErr err, int c, const char *str, bool use_short) {
if (err == BC_ERR_FATAL_OPTION) {
if (use_short) {
static void
bc_opt_error(BcErr err, int c, const char* str, bool use_short)
{
if (err == BC_ERR_FATAL_OPTION)
{
if (use_short)
{
char short_str[2];
short_str[0] = (char) c;
@ -109,13 +114,17 @@ static void bc_opt_error(BcErr err, int c, const char *str, bool use_short) {
* @param c The character to match against.
* @return The type of the long option as an integer, or -1 if none.
*/
static int bc_opt_type(const BcOptLong *longopts, char c) {
static int
bc_opt_type(const BcOptLong* longopts, char c)
{
size_t i;
if (c == ':') return -1;
for (i = 0; !bc_opt_longoptsEnd(longopts, i) && longopts[i].val != c; ++i);
for (i = 0; !bc_opt_longoptsEnd(longopts, i) && longopts[i].val != c; ++i)
{
continue;
}
if (bc_opt_longoptsEnd(longopts, i)) return -1;
@ -128,11 +137,12 @@ static int bc_opt_type(const BcOptLong *longopts, char c) {
* @param longopts The long options array.
* @return The character for the short option, or -1 if none left.
*/
static int bc_opt_parseShort(BcOpt *o, const BcOptLong *longopts) {
static int
bc_opt_parseShort(BcOpt* o, const BcOptLong* longopts)
{
int type;
char *next;
char *option = o->argv[o->optind];
char* next;
char* option = o->argv[o->optind];
int ret = -1;
// Make sure to clear these.
@ -147,8 +157,8 @@ static int bc_opt_parseShort(BcOpt *o, const BcOptLong *longopts) {
type = bc_opt_type(longopts, option[0]);
next = o->argv[o->optind + 1];
switch (type) {
switch (type)
{
case -1:
case BC_OPT_BC_ONLY:
case BC_OPT_DC_ONLY:
@ -157,23 +167,24 @@ static int bc_opt_parseShort(BcOpt *o, const BcOptLong *longopts) {
if (type == -1 || (type == BC_OPT_BC_ONLY && BC_IS_DC) ||
(type == BC_OPT_DC_ONLY && BC_IS_BC))
{
char str[2] = {0, 0};
char str[2] = { 0, 0 };
str[0] = option[0];
o->optind += 1;
bc_opt_error(BC_ERR_FATAL_OPTION, option[0], str, true);
}
// Fallthrough.
BC_FALLTHROUGH
}
// Fallthrough.
BC_FALLTHROUGH
case BC_OPT_NONE:
{
// If there is something else, update the suboption.
if (option[1]) o->subopt += 1;
else {
else
{
// Go to the next argument.
o->subopt = 0;
o->optind += 1;
@ -187,11 +198,14 @@ static int bc_opt_parseShort(BcOpt *o, const BcOptLong *longopts) {
case BC_OPT_REQUIRED_BC_ONLY:
{
if (BC_IS_DC)
{
bc_opt_error(BC_ERR_FATAL_OPTION, option[0],
bc_opt_longopt(longopts, option[0]), true);
}
// Fallthrough
BC_FALLTHROUGH
}
// Fallthrough
BC_FALLTHROUGH
case BC_OPT_REQUIRED:
{
@ -201,16 +215,18 @@ static int bc_opt_parseShort(BcOpt *o, const BcOptLong *longopts) {
// Use the next characters, if they exist.
if (option[1]) o->optarg = option + 1;
else if (next != NULL) {
else if (next != NULL)
{
// USe the next.
o->optarg = next;
o->optind += 1;
}
// No argument, barf.
else bc_opt_error(BC_ERR_FATAL_OPTION_NO_ARG, option[0],
bc_opt_longopt(longopts, option[0]), true);
else
{
bc_opt_error(BC_ERR_FATAL_OPTION_NO_ARG, option[0],
bc_opt_longopt(longopts, option[0]), true);
}
ret = (int) option[0];
@ -228,15 +244,18 @@ static int bc_opt_parseShort(BcOpt *o, const BcOptLong *longopts) {
* @param option The command-line argument.
* @return True if @a option matches @a name, false otherwise.
*/
static bool bc_opt_longoptsMatch(const char *name, const char *option) {
const char *a = option, *n = name;
static bool
bc_opt_longoptsMatch(const char* name, const char* option)
{
const char* a = option;
const char* n = name;
// Can never match a NULL name.
if (name == NULL) return false;
// Loop through.
for (; *a && *n && *a != '='; ++a, ++n) {
for (; *a && *n && *a != '='; ++a, ++n)
{
if (*a != *n) return false;
}
@ -250,35 +269,40 @@ static bool bc_opt_longoptsMatch(const char *name, const char *option) {
* @param option The option to find the argument of.
* @return A pointer to the argument of the option, or NULL if none.
*/
static char* bc_opt_longoptsArg(char *option) {
static char*
bc_opt_longoptsArg(char* option)
{
// Find the end or equals sign.
for (; *option && *option != '='; ++option);
for (; *option && *option != '='; ++option)
{
continue;
}
if (*option == '=') return option + 1;
else return NULL;
}
int bc_opt_parse(BcOpt *o, const BcOptLong *longopts) {
int
bc_opt_parse(BcOpt* o, const BcOptLong* longopts)
{
size_t i;
char *option;
char* option;
bool empty;
// This just eats empty options.
do {
do
{
option = o->argv[o->optind];
if (option == NULL) return -1;
empty = !strcmp(option, "");
o->optind += empty;
} while (empty);
}
while (empty);
// If the option is just a "--".
if (BC_OPT_ISDASHDASH(option)) {
if (BC_OPT_ISDASHDASH(option))
{
// Consume "--".
o->optind += 1;
return -1;
@ -297,14 +321,14 @@ int bc_opt_parse(BcOpt *o, const BcOptLong *longopts) {
o->optind += 1;
// Loop through the valid long options.
for (i = 0; !bc_opt_longoptsEnd(longopts, i); i++) {
const char *name = longopts[i].name;
for (i = 0; !bc_opt_longoptsEnd(longopts, i); i++)
{
const char* name = longopts[i].name;
// If we have a match...
if (bc_opt_longoptsMatch(name, option)) {
char *arg;
if (bc_opt_longoptsMatch(name, option))
{
char* arg;
// Get the option char and the argument.
o->optopt = longopts[i].val;
@ -335,8 +359,11 @@ int bc_opt_parse(BcOpt *o, const BcOptLong *longopts) {
// All's good if it exists; otherwise, barf.
if (o->optarg != NULL) o->optind += 1;
else bc_opt_error(BC_ERR_FATAL_OPTION_NO_ARG,
o->optopt, name, false);
else
{
bc_opt_error(BC_ERR_FATAL_OPTION_NO_ARG, o->optopt, name,
false);
}
}
return o->optopt;
@ -351,7 +378,9 @@ int bc_opt_parse(BcOpt *o, const BcOptLong *longopts) {
return -1;
}
void bc_opt_init(BcOpt *o, char *argv[]) {
void
bc_opt_init(BcOpt* o, char* argv[])
{
o->argv = argv;
o->optind = 1;
o->subopt = 0;

85
contrib/bc/src/parse.c
View File

@ -44,12 +44,16 @@
#include <program.h>
#include <vm.h>
void bc_parse_updateFunc(BcParse *p, size_t fidx) {
void
bc_parse_updateFunc(BcParse* p, size_t fidx)
{
p->fidx = fidx;
p->func = bc_vec_item(&p->prog->fns, fidx);
}
inline void bc_parse_pushName(const BcParse *p, char *name, bool var) {
inline void
bc_parse_pushName(const BcParse* p, char* name, bool var)
{
bc_parse_pushIndex(p, bc_program_search(p->prog, name, var));
}
@ -60,14 +64,17 @@ inline void bc_parse_pushName(const BcParse *p, char *name, bool var) {
* @param inst The instruction to push.
* @param idx The index to push.
*/
static void bc_parse_update(BcParse *p, uchar inst, size_t idx) {
static void
bc_parse_update(BcParse* p, uchar inst, size_t idx)
{
bc_parse_updateFunc(p, p->fidx);
bc_parse_push(p, inst);
bc_parse_pushIndex(p, idx);
}
void bc_parse_addString(BcParse *p) {
void
bc_parse_addString(BcParse* p)
{
size_t idx;
idx = bc_program_addString(p->prog, p->l.str.v, p->fidx);
@ -77,23 +84,26 @@ void bc_parse_addString(BcParse *p) {
bc_parse_pushIndex(p, idx);
}
static void bc_parse_addNum(BcParse *p, const char *string) {
BcVec *consts = &p->func->consts;
static void
bc_parse_addNum(BcParse* p, const char* string)
{
BcVec* consts = &p->func->consts;
size_t idx;
BcConst *c;
BcVec *slabs;
BcConst* c;
BcVec* slabs;
BC_SIG_ASSERT_LOCKED;
// Special case 0.
if (bc_parse_zero[0] == string[0] && bc_parse_zero[1] == string[1]) {
if (bc_parse_zero[0] == string[0] && bc_parse_zero[1] == string[1])
{
bc_parse_push(p, BC_INST_ZERO);
return;
}
// Special case 1.
if (bc_parse_one[0] == string[0] && bc_parse_one[1] == string[1]) {
if (bc_parse_one[0] == string[0] && bc_parse_one[1] == string[1])
{
bc_parse_push(p, BC_INST_ONE);
return;
}
@ -103,7 +113,8 @@ static void bc_parse_addNum(BcParse *p, const char *string) {
// Get the right slab.
slabs = p->fidx == BC_PROG_MAIN || p->fidx == BC_PROG_READ ?
&vm.main_const_slab : &vm.other_slabs;
&vm.main_const_slab :
&vm.other_slabs;
// Push an empty constant.
c = bc_vec_pushEmpty(consts);
@ -118,15 +129,17 @@ static void bc_parse_addNum(BcParse *p, const char *string) {
bc_parse_update(p, BC_INST_NUM, idx);
}
void bc_parse_number(BcParse *p) {
void
bc_parse_number(BcParse* p)
{
#if BC_ENABLE_EXTRA_MATH
char *exp = strchr(p->l.str.v, 'e');
char* exp = strchr(p->l.str.v, 'e');
size_t idx = SIZE_MAX;
// Do we have a number in scientific notation? If so, add a nul byte where
// the e is.
if (exp != NULL) {
if (exp != NULL)
{
idx = ((size_t) (exp - p->l.str.v));
*exp = 0;
}
@ -136,8 +149,8 @@ void bc_parse_number(BcParse *p) {
#if BC_ENABLE_EXTRA_MATH
// If we have a number in scientific notation...
if (exp != NULL) {
if (exp != NULL)
{
bool neg;
// Figure out if the exponent is negative.
@ -150,8 +163,9 @@ void bc_parse_number(BcParse *p) {
#endif // BC_ENABLE_EXTRA_MATH
}
void bc_parse_text(BcParse *p, const char *text, bool is_stdin, bool is_exprs) {
void
bc_parse_text(BcParse* p, const char* text, bool is_stdin, bool is_exprs)
{
BC_SIG_LOCK;
// Make sure the pointer isn't invalidated.
@ -161,12 +175,14 @@ void bc_parse_text(BcParse *p, const char *text, bool is_stdin, bool is_exprs) {
BC_SIG_UNLOCK;
}
void bc_parse_reset(BcParse *p) {
void
bc_parse_reset(BcParse* p)
{
BC_SIG_ASSERT_LOCKED;
// Reset the function if it isn't main and switch to main.
if (p->fidx != BC_PROG_MAIN) {
if (p->fidx != BC_PROG_MAIN)
{
bc_func_reset(p->func);
bc_parse_updateFunc(p, BC_PROG_MAIN);
}
@ -176,8 +192,8 @@ void bc_parse_reset(BcParse *p) {
p->l.t = BC_LEX_EOF;
#if BC_ENABLED
if (BC_IS_BC) {
if (BC_IS_BC)
{
// Get rid of the bc parser state.
p->auto_part = false;
bc_vec_npop(&p->flags, p->flags.len - 1);
@ -195,14 +211,16 @@ void bc_parse_reset(BcParse *p) {
}
#ifndef NDEBUG
void bc_parse_free(BcParse *p) {
void
bc_parse_free(BcParse* p)
{
BC_SIG_ASSERT_LOCKED;
assert(p != NULL);
#if BC_ENABLED
if (BC_IS_BC) {
if (BC_IS_BC)
{
bc_vec_free(&p->flags);
bc_vec_free(&p->exits);
bc_vec_free(&p->conds);
@ -215,8 +233,9 @@ void bc_parse_free(BcParse *p) {
}
#endif // NDEBUG
void bc_parse_init(BcParse *p, BcProgram *prog, size_t func) {
void
bc_parse_init(BcParse* p, BcProgram* prog, size_t func)
{
#if BC_ENABLED
uint16_t flag = 0;
#endif // BC_ENABLED
@ -226,8 +245,8 @@ void bc_parse_init(BcParse *p, BcProgram *prog, size_t func) {
assert(p != NULL && prog != NULL);
#if BC_ENABLED
if (BC_IS_BC) {
if (BC_IS_BC)
{
// We always want at least one flag set on the flags stack.
bc_vec_init(&p->flags, sizeof(uint16_t), BC_DTOR_NONE);
bc_vec_push(&p->flags, &flag);

1108
contrib/bc/src/program.c
View File

File diff suppressed because it is too large Load Diff

196
contrib/bc/src/rand.c
View File

@ -66,8 +66,9 @@
* @param b The second operand.
* @return The sum, including overflow.
*/
static BcRandState bc_rand_addition(uint_fast64_t a, uint_fast64_t b) {
static BcRandState
bc_rand_addition(uint_fast64_t a, uint_fast64_t b)
{
BcRandState res;
res.lo = a + b;
@ -82,8 +83,9 @@ static BcRandState bc_rand_addition(uint_fast64_t a, uint_fast64_t b) {
* @param b The second operand.
* @return The sum, without overflow.
*/
static BcRandState bc_rand_addition2(BcRandState a, BcRandState b) {
static BcRandState
bc_rand_addition2(BcRandState a, BcRandState b)
{
BcRandState temp, res;
res = bc_rand_addition(a.lo, b.lo);
@ -99,8 +101,9 @@ static BcRandState bc_rand_addition2(BcRandState a, BcRandState b) {
* @param b The second operand.
* @return The product, including overflow.
*/
static BcRandState bc_rand_multiply(uint_fast64_t a, uint_fast64_t b) {
static BcRandState
bc_rand_multiply(uint_fast64_t a, uint_fast64_t b)
{
uint_fast64_t al, ah, bl, bh, c0, c1, c2, c3;
BcRandState carry, res;
@ -128,8 +131,9 @@ static BcRandState bc_rand_multiply(uint_fast64_t a, uint_fast64_t b) {
* @param b The second operand.
* @return The product, without overflow.
*/
static BcRandState bc_rand_multiply2(BcRandState a, BcRandState b) {
static BcRandState
bc_rand_multiply2(BcRandState a, BcRandState b)
{
BcRandState c0, c1, c2, carry;
c0 = bc_rand_multiply(a.lo, b.lo);
@ -150,8 +154,9 @@ static BcRandState bc_rand_multiply2(BcRandState a, BcRandState b) {
* stack of PRNG's.
* @param r The PRNG to mark as modified.
*/
static void bc_rand_setModified(BcRNGData *r) {
static void
bc_rand_setModified(BcRNGData* r)
{
#if BC_RAND_BUILTIN
r->inc |= (BcRandState) 1UL;
#else // BC_RAND_BUILTIN
@ -164,8 +169,9 @@ static void bc_rand_setModified(BcRNGData *r) {
* stack of PRNG's.
* @param r The PRNG to mark as not modified.
*/
static void bc_rand_clearModified(BcRNGData *r) {
static void
bc_rand_clearModified(BcRNGData* r)
{
#if BC_RAND_BUILTIN
r->inc &= ~((BcRandState) 1UL);
#else // BC_RAND_BUILTIN
@ -179,9 +185,14 @@ static void bc_rand_clearModified(BcRNGData *r) {
* @param d The destination PRNG.
* @param s The source PRNG.
*/
static void bc_rand_copy(BcRNGData *d, BcRNGData *s) {
static void
bc_rand_copy(BcRNGData* d, BcRNGData* s)
{
bool unmod = BC_RAND_NOTMODIFIED(d);
// NOLINTNEXTLINE
memcpy(d, s, sizeof(BcRNGData));
if (!unmod) bc_rand_setModified(d);
else if (!BC_RAND_NOTMODIFIED(s)) bc_rand_clearModified(d);
}
@ -193,21 +204,22 @@ static void bc_rand_copy(BcRNGData *d, BcRNGData *s) {
* @param ptr A pointer to the file, as a void pointer.
* @return The random data as an unsigned long.
*/
static ulong bc_rand_frand(void* ptr) {
static ulong
bc_rand_frand(void* ptr)
{
ulong buf[1];
int fd;
ssize_t nread;
assert(ptr != NULL);
fd = *((int*)ptr);
fd = *((int*) ptr);
nread = read(fd, buf, sizeof(ulong));
if (BC_ERR(nread != sizeof(ulong))) bc_vm_fatalError(BC_ERR_FATAL_IO_ERR);
return *((ulong*)buf);
return *((ulong*) buf);
}
#else // _WIN32
@ -216,8 +228,9 @@ static ulong bc_rand_frand(void* ptr) {
* @param ptr An unused parameter.
* @return The random data as an unsigned long.
*/
static ulong bc_rand_winrand(void *ptr) {
static ulong
bc_rand_winrand(void* ptr)
{
ulong buf[1];
NTSTATUS s;
@ -242,8 +255,9 @@ static ulong bc_rand_winrand(void *ptr) {
* @param ptr An unused parameter.
* @return The random data as an unsigned long.
*/
static ulong bc_rand_rand(void *ptr) {
static ulong
bc_rand_rand(void* ptr)
{
size_t i;
ulong res = 0;
@ -251,7 +265,9 @@ static ulong bc_rand_rand(void *ptr) {
// Fill up the unsigned long byte-by-byte.
for (i = 0; i < sizeof(ulong); ++i)
{
res |= ((ulong) (rand() & BC_RAND_SRAND_BITS)) << (i * CHAR_BIT);
}
return res;
}
@ -262,8 +278,9 @@ static ulong bc_rand_rand(void *ptr) {
* @param r The PRNG.
* @return The increment of the PRNG, including the last odd bit.
*/
static BcRandState bc_rand_inc(BcRNGData *r) {
static BcRandState
bc_rand_inc(BcRNGData* r)
{
BcRandState inc;
#if BC_RAND_BUILTIN
@ -280,8 +297,9 @@ static BcRandState bc_rand_inc(BcRNGData *r) {
* Sets up the increment for the PRNG.
* @param r The PRNG whose increment will be set up.
*/
static void bc_rand_setupInc(BcRNGData *r) {
static void
bc_rand_setupInc(BcRNGData* r)
{
#if BC_RAND_BUILTIN
r->inc <<= 1UL;
#else // BC_RAND_BUILTIN
@ -297,8 +315,9 @@ static void bc_rand_setupInc(BcRNGData *r) {
* @param val1 The lower half of the state.
* @param val2 The upper half of the state.
*/
static void bc_rand_seedState(BcRandState *state, ulong val1, ulong val2) {
static void
bc_rand_seedState(BcRandState* state, ulong val1, ulong val2)
{
#if BC_RAND_BUILTIN
*state = ((BcRandState) val1) | ((BcRandState) val2) << (BC_LONG_BIT);
#else // BC_RAND_BUILTIN
@ -315,8 +334,9 @@ static void bc_rand_seedState(BcRandState *state, ulong val1, ulong val2) {
* @param inc1 The lower half of the increment.
* @param inc2 The upper half of the increment.
*/
static void bc_rand_seedRNG(BcRNGData *r, ulong state1, ulong state2,
ulong inc1, ulong inc2)
static void
bc_rand_seedRNG(BcRNGData* r, ulong state1, ulong state2, ulong inc1,
ulong inc2)
{
bc_rand_seedState(&r->state, state1, state2);
bc_rand_seedState(&r->inc, inc1, inc2);
@ -329,8 +349,9 @@ static void bc_rand_seedRNG(BcRNGData *r, ulong state1, ulong state2,
* @param fulong The function to fill an unsigned long.
* @param ptr The parameter to pass to @a fulong.
*/
static void bc_rand_fill(BcRNGData *r, BcRandUlong fulong, void *ptr) {
static void
bc_rand_fill(BcRNGData* r, BcRandUlong fulong, void* ptr)
{
ulong state1, state2, inc1, inc2;
state1 = fulong(ptr);
@ -346,7 +367,9 @@ static void bc_rand_fill(BcRNGData *r, BcRandUlong fulong, void *ptr) {
* Executes the "step" portion of a PCG udpate.
* @param r The PRNG.
*/
static void bc_rand_step(BcRNGData *r) {
static void
bc_rand_step(BcRNGData* r)
{
BcRandState temp = bc_rand_mul2(r->state, bc_rand_multiplier);
r->state = bc_rand_add2(temp, bc_rand_inc(r));
}
@ -356,7 +379,9 @@ static void bc_rand_step(BcRNGData *r) {
* @param r The PRNG.
* @return The new output from the PRNG.
*/
static BcRand bc_rand_output(BcRNGData *r) {
static BcRand
bc_rand_output(BcRNGData* r)
{
return BC_RAND_ROT(BC_RAND_FOLD(r->state), BC_RAND_ROTAMT(r->state));
}
@ -366,9 +391,10 @@ static BcRand bc_rand_output(BcRNGData *r) {
* @param r The PRNG stack.
* @param rng The PRNG on the top of the stack. Must have been seeded.
*/
static void bc_rand_seedZeroes(BcRNG *r, BcRNGData *rng, size_t idx) {
BcRNGData *rng2;
static void
bc_rand_seedZeroes(BcRNG* r, BcRNGData* rng, size_t idx)
{
BcRNGData* rng2;
// Just return if there are none to do.
if (r->v.len <= idx) return;
@ -377,18 +403,21 @@ static void bc_rand_seedZeroes(BcRNG *r, BcRNGData *rng, size_t idx) {
rng2 = bc_vec_item_rev(&r->v, idx);
// Does it need seeding? Then it, and maybe more, do.
if (BC_RAND_ZERO(rng2)) {
if (BC_RAND_ZERO(rng2))
{
size_t i;
// Seed the ones that need seeding.
for (i = 1; i < r->v.len; ++i)
{
bc_rand_copy(bc_vec_item_rev(&r->v, i), rng);
}
}
}
void bc_rand_srand(BcRNGData *rng) {
void
bc_rand_srand(BcRNGData* rng)
{
int fd = 0;
BC_SIG_LOCK;
@ -398,16 +427,18 @@ void bc_rand_srand(BcRNGData *rng) {
// Try /dev/urandom first.
fd = open("/dev/urandom", O_RDONLY);
if (BC_NO_ERR(fd >= 0)) {
if (BC_NO_ERR(fd >= 0))
{
bc_rand_fill(rng, bc_rand_frand, &fd);
close(fd);
}
else {
else
{
// Try /dev/random second.
fd = open("/dev/random", O_RDONLY);
if (BC_NO_ERR(fd >= 0)) {
if (BC_NO_ERR(fd >= 0))
{
bc_rand_fill(rng, bc_rand_frand, &fd);
close(fd);
}
@ -418,7 +449,10 @@ void bc_rand_srand(BcRNGData *rng) {
#endif // _WIN32
// Fallback to rand() until the thing is seeded.
while (BC_ERR(BC_RAND_ZERO(rng))) bc_rand_fill(rng, bc_rand_rand, NULL);
while (BC_ERR(BC_RAND_ZERO(rng)))
{
bc_rand_fill(rng, bc_rand_rand, NULL);
}
BC_SIG_UNLOCK;
}
@ -429,21 +463,22 @@ void bc_rand_srand(BcRNGData *rng) {
* @param r The PRNG stack.
* @param rng The PRNG that will be used to seed the others.
*/
static void bc_rand_propagate(BcRNG *r, BcRNGData *rng) {
static void
bc_rand_propagate(BcRNG* r, BcRNGData* rng)
{
// Just return if there are none to do.
if (r->v.len <= 1) return;
// If the PRNG has not been modified...
if (BC_RAND_NOTMODIFIED(rng)) {
if (BC_RAND_NOTMODIFIED(rng))
{
size_t i;
bool go = true;
// Find the first PRNG that is modified and seed the others.
for (i = 1; go && i < r->v.len; ++i) {
BcRNGData *rng2 = bc_vec_item_rev(&r->v, i);
for (i = 1; go && i < r->v.len; ++i)
{
BcRNGData* rng2 = bc_vec_item_rev(&r->v, i);
go = BC_RAND_NOTMODIFIED(rng2);
@ -457,10 +492,11 @@ static void bc_rand_propagate(BcRNG *r, BcRNGData *rng) {
else bc_rand_seedZeroes(r, rng, 1);
}
BcRand bc_rand_int(BcRNG *r) {
BcRand
bc_rand_int(BcRNG* r)
{
// Get the actual PRNG.
BcRNGData *rng = bc_vec_top(&r->v);
BcRNGData* rng = bc_vec_top(&r->v);
BcRand res;
// Make sure the PRNG is seeded.
@ -478,22 +514,26 @@ BcRand bc_rand_int(BcRNG *r) {
return res;
}
BcRand bc_rand_bounded(BcRNG *r, BcRand bound) {
BcRand
bc_rand_bounded(BcRNG* r, BcRand bound)
{
// Calculate the threshold below which we have to try again.
BcRand rand, threshold = (0 - bound) % bound;
do {
do
{
rand = bc_rand_int(r);
} while (rand < threshold);
}
while (rand < threshold);
return rand % bound;
}
void bc_rand_seed(BcRNG *r, ulong state1, ulong state2, ulong inc1, ulong inc2)
void
bc_rand_seed(BcRNG* r, ulong state1, ulong state2, ulong inc1, ulong inc2)
{
// Get the actual PRNG.
BcRNGData *rng = bc_vec_top(&r->v);
BcRNGData* rng = bc_vec_top(&r->v);
// Seed and set up the PRNG's increment.
bc_rand_seedState(&rng->inc, inc1, inc2);
@ -502,7 +542,9 @@ void bc_rand_seed(BcRNG *r, ulong state1, ulong state2, ulong inc1, ulong inc2)
// If the state is 0, use the increment as the state. Otherwise, seed it
// with the state.
if (!state1 && !state2) {
if (!state1 && !state2)
{
// NOLINTNEXTLINE
memcpy(&rng->state, &rng->inc, sizeof(BcRandState));
bc_rand_step(rng);
}
@ -519,8 +561,9 @@ void bc_rand_seed(BcRNG *r, ulong state1, ulong state2, ulong inc1, ulong inc2)
* @return The increment without the odd bit and with being shifted one bit
* down.
*/
static BcRandState bc_rand_getInc(BcRNGData *r) {
static BcRandState
bc_rand_getInc(BcRNGData* r)
{
BcRandState res;
#if BC_RAND_BUILTIN
@ -535,10 +578,11 @@ static BcRandState bc_rand_getInc(BcRNGData *r) {
return res;
}
void bc_rand_getRands(BcRNG *r, BcRand *s1, BcRand *s2, BcRand *i1, BcRand *i2)
void
bc_rand_getRands(BcRNG* r, BcRand* s1, BcRand* s2, BcRand* i1, BcRand* i2)
{
BcRandState inc;
BcRNGData *rng = bc_vec_top(&r->v);
BcRNGData* rng = bc_vec_top(&r->v);
if (BC_ERR(BC_RAND_ZERO(rng))) bc_rand_srand(rng);
@ -554,30 +598,38 @@ void bc_rand_getRands(BcRNG *r, BcRand *s1, BcRand *s2, BcRand *i1, BcRand *i2)
*i2 = BC_RAND_CHOP(inc);
}
void bc_rand_push(BcRNG *r) {
BcRNGData *rng = bc_vec_pushEmpty(&r->v);
void
bc_rand_push(BcRNG* r)
{
BcRNGData* rng = bc_vec_pushEmpty(&r->v);
// Make sure the PRNG is properly zeroed because that marks it as needing to
// be seeded.
// NOLINTNEXTLINE
memset(rng, 0, sizeof(BcRNGData));
// If there is another item, copy it too.
if (r->v.len > 1) bc_rand_copy(rng, bc_vec_item_rev(&r->v, 1));
}
void bc_rand_pop(BcRNG *r, bool reset) {
void
bc_rand_pop(BcRNG* r, bool reset)
{
bc_vec_npop(&r->v, reset ? r->v.len - 1 : 1);
}
void bc_rand_init(BcRNG *r) {
void
bc_rand_init(BcRNG* r)
{
BC_SIG_ASSERT_LOCKED;
bc_vec_init(&r->v, sizeof(BcRNGData), BC_DTOR_NONE);
bc_rand_push(r);
}
#if BC_RAND_USE_FREE
void bc_rand_free(BcRNG *r) {
void
bc_rand_free(BcRNG* r)
{
BC_SIG_ASSERT_LOCKED;
bc_vec_free(&r->v);
}

85
contrib/bc/src/read.c
View File

@ -54,12 +54,14 @@
#include <vm.h>
/**
* A portability file open function.
* A portability file open function. This is copied to gen/strgen.c. Make sure
* to update that if this changes.
* @param path The path to the file to open.
* @param mode The mode to open in.
*/
static int bc_read_open(const char* path, int mode) {
static int
bc_read_open(const char* path, int mode)
{
int fd;
#ifndef _WIN32
@ -77,20 +79,23 @@ static int bc_read_open(const char* path, int mode) {
* @param buf The buffer to test.
* @param size The size of the buffer.
*/
static bool bc_read_binary(const char *buf, size_t size) {
static bool
bc_read_binary(const char* buf, size_t size)
{
size_t i;
for (i = 0; i < size; ++i) {
for (i = 0; i < size; ++i)
{
if (BC_ERR(BC_READ_BIN_CHAR(buf[i]))) return true;
}
return false;
}
bool bc_read_buf(BcVec *vec, char *buf, size_t *buf_len) {
char *nl;
bool
bc_read_buf(BcVec* vec, char* buf, size_t* buf_len)
{
char* nl;
// If nothing there, return.
if (!*buf_len) return false;
@ -99,8 +104,8 @@ bool bc_read_buf(BcVec *vec, char *buf, size_t *buf_len) {
nl = strchr(buf, '\n');
// If a newline exists...
if (nl != NULL) {
if (nl != NULL)
{
// Get the size of the data up to, and including, the newline.
size_t nllen = (size_t) ((nl + 1) - buf);
@ -110,6 +115,7 @@ bool bc_read_buf(BcVec *vec, char *buf, size_t *buf_len) {
// buffer up.
bc_vec_npush(vec, nllen, buf);
*buf_len -= nllen;
// NOLINTNEXTLINE
memmove(buf, nl + 1, *buf_len + 1);
return true;
@ -122,8 +128,9 @@ bool bc_read_buf(BcVec *vec, char *buf, size_t *buf_len) {
return false;
}
BcStatus bc_read_chars(BcVec *vec, const char *prompt) {
BcStatus
bc_read_chars(BcVec* vec, const char* prompt)
{
bool done = false;
assert(vec != NULL && vec->size == sizeof(char));
@ -134,20 +141,22 @@ BcStatus bc_read_chars(BcVec *vec, const char *prompt) {
bc_vec_popAll(vec);
// Handle the prompt, if desired.
if (BC_PROMPT) {
if (BC_PROMPT)
{
bc_file_puts(&vm.fout, bc_flush_none, prompt);
bc_file_flush(&vm.fout, bc_flush_none);
}
// Try reading from the buffer, and if successful, just return.
if (bc_read_buf(vec, vm.buf, &vm.buf_len)) {
if (bc_read_buf(vec, vm.buf, &vm.buf_len))
{
bc_vec_pushByte(vec, '\0');
return BC_STATUS_SUCCESS;
}
// Loop until we have something.
while (!done) {
while (!done)
{
ssize_t r;
BC_SIG_LOCK;
@ -157,11 +166,11 @@ BcStatus bc_read_chars(BcVec *vec, const char *prompt) {
BC_VM_STDIN_BUF_SIZE - vm.buf_len);
// If there was an error...
if (BC_UNLIKELY(r < 0)) {
if (BC_UNLIKELY(r < 0))
{
// If interupted...
if (errno == EINTR) {
if (errno == EINTR)
{
// Jump out if we are supposed to quit, which certain signals
// will require.
if (vm.status == (sig_atomic_t) BC_STATUS_QUIT) BC_JMP;
@ -191,7 +200,8 @@ BcStatus bc_read_chars(BcVec *vec, const char *prompt) {
BC_SIG_UNLOCK;
// If we read nothing, make sure to terminate the string and return EOF.
if (r == 0) {
if (r == 0)
{
bc_vec_pushByte(vec, '\0');
return BC_STATUS_EOF;
}
@ -214,27 +224,33 @@ BcStatus bc_read_chars(BcVec *vec, const char *prompt) {
return BC_STATUS_SUCCESS;
}
BcStatus bc_read_line(BcVec *vec, const char *prompt) {
BcStatus
bc_read_line(BcVec* vec, const char* prompt)
{
BcStatus s;
#if BC_ENABLE_HISTORY
// Get a line from either history or manual reading.
if (BC_TTY && !vm.history.badTerm)
{
s = bc_history_line(&vm.history, vec, prompt);
}
else s = bc_read_chars(vec, prompt);
#else // BC_ENABLE_HISTORY
s = bc_read_chars(vec, prompt);
#endif // BC_ENABLE_HISTORY
if (BC_ERR(bc_read_binary(vec->v, vec->len - 1)))
{
bc_verr(BC_ERR_FATAL_BIN_FILE, bc_program_stdin_name);
}
return s;
}
char* bc_read_file(const char *path) {
char*
bc_read_file(const char* path)
{
BcErr e = BC_ERR_FATAL_IO_ERR;
size_t size, to_read;
struct stat pstat;
@ -242,12 +258,16 @@ char* bc_read_file(const char *path) {
char* buf;
char* buf2;
// This has been copied to gen/strgen.c. Make sure to change that if this
// changes.
BC_SIG_ASSERT_LOCKED;
assert(path != NULL);
#ifndef NDEBUG
// Need this to quiet MSan.
// NOLINTNEXTLINE
memset(&pstat, 0, sizeof(struct stat));
#endif // NDEBUG
@ -261,7 +281,8 @@ char* bc_read_file(const char *path) {
if (BC_ERR(fstat(fd, &pstat) == -1)) goto malloc_err;
// Make sure it's not a directory.
if (BC_ERR(S_ISDIR(pstat.st_mode))) {
if (BC_ERR(S_ISDIR(pstat.st_mode)))
{
e = BC_ERR_FATAL_PATH_DIR;
goto malloc_err;
}
@ -272,20 +293,22 @@ char* bc_read_file(const char *path) {
buf2 = buf;
to_read = size;
do {
do
{
// Read the file. We just bail if a signal interrupts. This is so that
// users can interrupt the reading of big files if they want.
ssize_t r = read(fd, buf2, to_read);
if (BC_ERR(r < 0)) goto read_err;
to_read -= (size_t) r;
buf2 += (size_t) r;
} while (to_read);
}
while (to_read);
// Got to have a nul byte.
buf[size] = '\0';
if (BC_ERR(bc_read_binary(buf, size))) {
if (BC_ERR(bc_read_binary(buf, size)))
{
e = BC_ERR_FATAL_BIN_FILE;
goto read_err;
}

248
contrib/bc/src/vector.c
View File

@ -42,8 +42,9 @@
#include <lang.h>
#include <vm.h>
void bc_vec_grow(BcVec *restrict v, size_t n) {
void
bc_vec_grow(BcVec* restrict v, size_t n)
{
size_t cap, len;
sig_atomic_t lock;
@ -52,9 +53,13 @@ void bc_vec_grow(BcVec *restrict v, size_t n) {
// If this is true, we might overflow.
if (len > SIZE_MAX / 2) cap = len;
else {
else
{
// Keep doubling until larger.
while (cap < len) cap += cap;
while (cap < len)
{
cap += cap;
}
}
BC_SIG_TRYLOCK(lock);
@ -65,8 +70,9 @@ void bc_vec_grow(BcVec *restrict v, size_t n) {
BC_SIG_TRYUNLOCK(lock);
}
void bc_vec_init(BcVec *restrict v, size_t esize, BcDtorType dtor) {
void
bc_vec_init(BcVec* restrict v, size_t esize, BcDtorType dtor)
{
BC_SIG_ASSERT_LOCKED;
assert(v != NULL && esize);
@ -79,13 +85,14 @@ void bc_vec_init(BcVec *restrict v, size_t esize, BcDtorType dtor) {
v->dtor = (BcSize) dtor;
}
void bc_vec_expand(BcVec *restrict v, size_t req) {
void
bc_vec_expand(BcVec* restrict v, size_t req)
{
assert(v != NULL);
// Only expand if necessary.
if (v->cap < req) {
if (v->cap < req)
{
sig_atomic_t lock;
BC_SIG_TRYLOCK(lock);
@ -97,8 +104,9 @@ void bc_vec_expand(BcVec *restrict v, size_t req) {
}
}
void bc_vec_npop(BcVec *restrict v, size_t n) {
void
bc_vec_npop(BcVec* restrict v, size_t n)
{
sig_atomic_t lock;
assert(v != NULL && n <= v->len);
@ -106,22 +114,27 @@ void bc_vec_npop(BcVec *restrict v, size_t n) {
BC_SIG_TRYLOCK(lock);
if (!v->dtor) v->len -= n;
else {
else
{
const BcVecFree d = bc_vec_dtors[v->dtor];
size_t esize = v->size;
size_t len = v->len - n;
// Loop through and manually destruct every element.
while (v->len > len) d(v->v + (esize * --v->len));
while (v->len > len)
{
d(v->v + (esize * --v->len));
}
}
BC_SIG_TRYUNLOCK(lock);
}
void bc_vec_npopAt(BcVec *restrict v, size_t n, size_t idx) {
char* ptr, *data;
void
bc_vec_npopAt(BcVec* restrict v, size_t n, size_t idx)
{
char* ptr;
char* data;
sig_atomic_t lock;
assert(v != NULL);
@ -133,23 +146,28 @@ void bc_vec_npopAt(BcVec *restrict v, size_t n, size_t idx) {
BC_SIG_TRYLOCK(lock);
if (v->dtor) {
if (v->dtor)
{
size_t i;
const BcVecFree d = bc_vec_dtors[v->dtor];
// Destroy every popped item.
for (i = 0; i < n; ++i) d(bc_vec_item(v, idx + i));
for (i = 0; i < n; ++i)
{
d(bc_vec_item(v, idx + i));
}
}
v->len -= n;
// NOLINTNEXTLINE
memmove(ptr, data, (v->len - idx) * v->size);
BC_SIG_TRYUNLOCK(lock);
}
void bc_vec_npush(BcVec *restrict v, size_t n, const void *data) {
void
bc_vec_npush(BcVec* restrict v, size_t n, const void* data)
{
sig_atomic_t lock;
size_t esize;
@ -163,20 +181,24 @@ void bc_vec_npush(BcVec *restrict v, size_t n, const void *data) {
esize = v->size;
// Copy the elements in.
// NOLINTNEXTLINE
memcpy(v->v + (esize * v->len), data, esize * n);
v->len += n;
BC_SIG_TRYUNLOCK(lock);
}
inline void bc_vec_push(BcVec *restrict v, const void *data) {
inline void
bc_vec_push(BcVec* restrict v, const void* data)
{
bc_vec_npush(v, 1, data);
}
void* bc_vec_pushEmpty(BcVec *restrict v) {
void*
bc_vec_pushEmpty(BcVec* restrict v)
{
sig_atomic_t lock;
void *ptr;
void* ptr;
assert(v != NULL);
@ -193,20 +215,24 @@ void* bc_vec_pushEmpty(BcVec *restrict v) {
return ptr;
}
inline void bc_vec_pushByte(BcVec *restrict v, uchar data) {
inline void
bc_vec_pushByte(BcVec* restrict v, uchar data)
{
assert(v != NULL && v->size == sizeof(uchar));
bc_vec_npush(v, 1, &data);
}
void bc_vec_pushIndex(BcVec *restrict v, size_t idx) {
void
bc_vec_pushIndex(BcVec* restrict v, size_t idx)
{
uchar amt, nums[sizeof(size_t) + 1];
assert(v != NULL);
assert(v->size == sizeof(uchar));
// Encode the index.
for (amt = 0; idx; ++amt) {
for (amt = 0; idx; ++amt)
{
nums[amt + 1] = (uchar) idx;
idx &= ((size_t) ~(UCHAR_MAX));
idx >>= sizeof(uchar) * CHAR_BIT;
@ -218,17 +244,18 @@ void bc_vec_pushIndex(BcVec *restrict v, size_t idx) {
bc_vec_npush(v, amt + 1, nums);
}
void bc_vec_pushAt(BcVec *restrict v, const void *data, size_t idx) {
void
bc_vec_pushAt(BcVec* restrict v, const void* data, size_t idx)
{
assert(v != NULL && data != NULL && idx <= v->len);
BC_SIG_ASSERT_LOCKED;
// Do the easy case.
if (idx == v->len) bc_vec_push(v, data);
else {
char *ptr;
else
{
char* ptr;
size_t esize;
// Grow if necessary.
@ -238,13 +265,16 @@ void bc_vec_pushAt(BcVec *restrict v, const void *data, size_t idx) {
ptr = v->v + esize * idx;
// NOLINTNEXTLINE
memmove(ptr + esize, ptr, esize * (v->len++ - idx));
// NOLINTNEXTLINE
memcpy(ptr, data, esize);
}
}
void bc_vec_string(BcVec *restrict v, size_t len, const char *restrict str) {
void
bc_vec_string(BcVec* restrict v, size_t len, const char* restrict str)
{
sig_atomic_t lock;
assert(v != NULL && v->size == sizeof(char));
@ -256,6 +286,7 @@ void bc_vec_string(BcVec *restrict v, size_t len, const char *restrict str) {
bc_vec_popAll(v);
bc_vec_expand(v, bc_vm_growSize(len, 1));
// NOLINTNEXTLINE
memcpy(v->v, str, len);
v->len = len;
@ -264,8 +295,9 @@ void bc_vec_string(BcVec *restrict v, size_t len, const char *restrict str) {
BC_SIG_TRYUNLOCK(lock);
}
void bc_vec_concat(BcVec *restrict v, const char *restrict str) {
void
bc_vec_concat(BcVec* restrict v, const char* restrict str)
{
sig_atomic_t lock;
assert(v != NULL && v->size == sizeof(char));
@ -283,8 +315,9 @@ void bc_vec_concat(BcVec *restrict v, const char *restrict str) {
BC_SIG_TRYUNLOCK(lock);
}
void bc_vec_empty(BcVec *restrict v) {
void
bc_vec_empty(BcVec* restrict v)
{
sig_atomic_t lock;
assert(v != NULL && v->size == sizeof(char));
@ -299,9 +332,10 @@ void bc_vec_empty(BcVec *restrict v) {
}
#if BC_ENABLE_HISTORY
void bc_vec_replaceAt(BcVec *restrict v, size_t idx, const void *data) {
char *ptr;
void
bc_vec_replaceAt(BcVec* restrict v, size_t idx, const void* data)
{
char* ptr;
BC_SIG_ASSERT_LOCKED;
@ -311,29 +345,38 @@ void bc_vec_replaceAt(BcVec *restrict v, size_t idx, const void *data) {
if (v->dtor) bc_vec_dtors[v->dtor](ptr);
// NOLINTNEXTLINE
memcpy(ptr, data, v->size);
}
#endif // BC_ENABLE_HISTORY
inline void* bc_vec_item(const BcVec *restrict v, size_t idx) {
inline void*
bc_vec_item(const BcVec* restrict v, size_t idx)
{
assert(v != NULL && v->len && idx < v->len);
return v->v + v->size * idx;
}
inline void* bc_vec_item_rev(const BcVec *restrict v, size_t idx) {
inline void*
bc_vec_item_rev(const BcVec* restrict v, size_t idx)
{
assert(v != NULL && v->len && idx < v->len);
return v->v + v->size * (v->len - idx - 1);
}
inline void bc_vec_clear(BcVec *restrict v) {
inline void
bc_vec_clear(BcVec* restrict v)
{
BC_SIG_ASSERT_LOCKED;
v->v = NULL;
v->len = 0;
v->dtor = BC_DTOR_NONE;
}
void bc_vec_free(void *vec) {
BcVec *v = (BcVec*) vec;
void
bc_vec_free(void* vec)
{
BcVec* v = (BcVec*) vec;
BC_SIG_ASSERT_LOCKED;
bc_vec_popAll(v);
free(v->v);
@ -350,14 +393,15 @@ void bc_vec_free(void *vec) {
* @return The index of the item with @a name, or where the item would be
* if it does not exist.
*/
static size_t bc_map_find(const BcVec *restrict v, const char *name) {
static size_t
bc_map_find(const BcVec* restrict v, const char* name)
{
size_t low = 0, high = v->len;
while (low < high) {
while (low < high)
{
size_t mid = (low + high) / 2;
const BcId *id = bc_vec_item(v, mid);
const BcId* id = bc_vec_item(v, mid);
int result = strcmp(name, id->name);
if (!result) return mid;
@ -368,11 +412,12 @@ static size_t bc_map_find(const BcVec *restrict v, const char *name) {
return low;
}
bool bc_map_insert(BcVec *restrict v, const char *name,
size_t idx, size_t *restrict i)
bool
bc_map_insert(BcVec* restrict v, const char* name, size_t idx,
size_t* restrict i)
{
BcId id;
BcVec *slabs;
BcVec* slabs;
BC_SIG_ASSERT_LOCKED;
@ -383,7 +428,9 @@ bool bc_map_insert(BcVec *restrict v, const char *name,
assert(*i <= v->len);
if (*i != v->len && !strcmp(name, ((BcId*) bc_vec_item(v, *i))->name))
{
return false;
}
#if BC_ENABLED
slabs = BC_IS_DC ? &vm.main_slabs : &vm.other_slabs;
@ -399,8 +446,9 @@ bool bc_map_insert(BcVec *restrict v, const char *name,
return true;
}
size_t bc_map_index(const BcVec *restrict v, const char *name) {
size_t
bc_map_index(const BcVec* restrict v, const char* name)
{
size_t i;
assert(v != NULL && name != NULL);
@ -412,15 +460,18 @@ size_t bc_map_index(const BcVec *restrict v, const char *name) {
// Make sure the item exists.
return strcmp(name, ((BcId*) bc_vec_item(v, i))->name) ?
BC_VEC_INVALID_IDX : i;
BC_VEC_INVALID_IDX :
i;
}
#if DC_ENABLED
const char* bc_map_name(const BcVec *restrict v, size_t idx) {
const char*
bc_map_name(const BcVec* restrict v, size_t idx)
{
size_t i, len = v->len;
for (i = 0; i < len; ++i) {
for (i = 0; i < len; ++i)
{
BcId* id = (BcId*) bc_vec_item(v, i);
if (id->idx == idx) return id->name;
}
@ -435,7 +486,9 @@ const char* bc_map_name(const BcVec *restrict v, size_t idx) {
* Initializes a single slab.
* @param s The slab to initialize.
*/
static void bc_slab_init(BcSlab *s) {
static void
bc_slab_init(BcSlab* s)
{
s->s = bc_vm_malloc(BC_SLAB_SIZE);
s->len = 0;
}
@ -449,9 +502,10 @@ static void bc_slab_init(BcSlab *s) {
* @return A pointer to the new string in the slab, or NULL if it could not
* be added.
*/
static char* bc_slab_add(BcSlab *s, const char *str, size_t len) {
char *ptr;
static char*
bc_slab_add(BcSlab* s, const char* str, size_t len)
{
char* ptr;
assert(s != NULL);
assert(str != NULL);
@ -461,6 +515,7 @@ static char* bc_slab_add(BcSlab *s, const char *str, size_t len) {
ptr = (char*) (s->s + s->len);
// NOLINTNEXTLINE
bc_strcpy(ptr, len, str);
s->len += len;
@ -468,13 +523,16 @@ static char* bc_slab_add(BcSlab *s, const char *str, size_t len) {
return ptr;
}
void bc_slab_free(void *slab) {
void
bc_slab_free(void* slab)
{
free(((BcSlab*) slab)->s);
}
void bc_slabvec_init(BcVec* v) {
BcSlab *slab;
void
bc_slabvec_init(BcVec* v)
{
BcSlab* slab;
assert(v != NULL);
@ -485,12 +543,13 @@ void bc_slabvec_init(BcVec* v) {
bc_slab_init(slab);
}
char* bc_slabvec_strdup(BcVec *v, const char *str) {
char *s;
char*
bc_slabvec_strdup(BcVec* v, const char* str)
{
char* s;
size_t len;
BcSlab slab;
BcSlab *slab_ptr;
BcSlab* slab_ptr;
BC_SIG_ASSERT_LOCKED;
@ -501,8 +560,8 @@ char* bc_slabvec_strdup(BcVec *v, const char *str) {
len = strlen(str) + 1;
// If the len is greater than 128, then just allocate it with malloc.
if (BC_UNLIKELY(len >= BC_SLAB_SIZE)) {
if (BC_UNLIKELY(len >= BC_SLAB_SIZE))
{
// SIZE_MAX is a marker for these standalone allocations.
slab.len = SIZE_MAX;
slab.s = bc_vm_strdup(str);
@ -518,8 +577,8 @@ char* bc_slabvec_strdup(BcVec *v, const char *str) {
s = bc_slab_add(slab_ptr, str, len);
// If it couldn't be added, add a slab and try again.
if (BC_UNLIKELY(s == NULL)) {
if (BC_UNLIKELY(s == NULL))
{
slab_ptr = bc_vec_pushEmpty(v);
bc_slab_init(slab_ptr);
@ -531,15 +590,16 @@ char* bc_slabvec_strdup(BcVec *v, const char *str) {
return s;
}
void bc_slabvec_clear(BcVec *v) {
BcSlab *s;
void
bc_slabvec_clear(BcVec* v)
{
BcSlab* s;
bool again;
// This complicated loop exists because of standalone allocations over 128
// bytes.
do {
do
{
// Get the first slab.
s = bc_vec_item(v, 0);
@ -552,8 +612,8 @@ void bc_slabvec_clear(BcVec *v) {
// Pop the standalone allocation, not the one after it.
if (again) bc_vec_npopAt(v, 1, 0);
} while(again);
}
while (again);
// If we get here, we know that the first slab is a valid slab. We want to
// pop all of the other slabs.
@ -566,17 +626,19 @@ void bc_slabvec_clear(BcVec *v) {
#if BC_DEBUG_CODE
void bc_slabvec_print(BcVec *v, const char *func) {
void
bc_slabvec_print(BcVec* v, const char* func)
{
size_t i;
BcSlab *s;
BcSlab* s;
bc_file_printf(&vm.ferr, "%s\n", func);
for (i = 0; i < v->len; ++i) {
for (i = 0; i < v->len; ++i)
{
s = bc_vec_item(v, i);
bc_file_printf(&vm.ferr, "%zu { s = %zu, len = %zu }\n",
i, (uintptr_t) s->s, s->len);
bc_file_printf(&vm.ferr, "%zu { s = %zu, len = %zu }\n", i,
(uintptr_t) s->s, s->len);
}
bc_file_puts(&vm.ferr, bc_flush_none, "\n");

548
contrib/bc/src/vm.c
View File

File diff suppressed because it is too large Load Diff

69
contrib/bc/tests/bcl.c
View File

@ -43,12 +43,15 @@
* Takes an error code and aborts if it actually is an error.
* @param e The error code.
*/
static void err(BclError e) {
static void
err(BclError e)
{
if (e != BCL_ERROR_NONE) abort();
}
int main(void) {
int
main(void)
{
BclError e;
BclContext ctxt;
size_t scale;
@ -135,15 +138,13 @@ int main(void) {
res = bcl_string(n5);
if (strcmp(res, "-351137.0060159482"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "-351137.0060159482")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(n6);
if (strcmp(res, ".00000152374405414"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, ".00000152374405414")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
@ -156,8 +157,7 @@ int main(void) {
res = bcl_string(bcl_dup(n4));
if (strcmp(res, "94538.1346457028"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "94538.1346457028")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
@ -178,8 +178,7 @@ int main(void) {
res = bcl_string(bcl_dup(n4));
if (strcmp(res, "94538"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "94538")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
@ -195,8 +194,7 @@ int main(void) {
res = bcl_string(bcl_dup(n4));
if (strcmp(res, "94538"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "94538")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
@ -235,8 +233,7 @@ int main(void) {
bcl_num_free(n);
// Test leading zeroes.
if (bcl_leadingZeroes())
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (bcl_leadingZeroes()) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
n = bcl_parse("0.01");
err(bcl_err(n));
@ -251,84 +248,70 @@ int main(void) {
err(bcl_err(n4));
res = bcl_string(bcl_dup(n));
if (strcmp(res, ".01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, ".01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(bcl_dup(n2));
if (strcmp(res, "-.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "-.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(bcl_dup(n3));
if (strcmp(res, "1.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "1.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(bcl_dup(n4));
if (strcmp(res, "-1.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "-1.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
bcl_setLeadingZeroes(true);
if (!bcl_leadingZeroes())
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (!bcl_leadingZeroes()) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
res = bcl_string(bcl_dup(n));
if (strcmp(res, "0.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "0.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(bcl_dup(n2));
if (strcmp(res, "-0.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "-0.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(bcl_dup(n3));
if (strcmp(res, "1.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "1.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(bcl_dup(n4));
if (strcmp(res, "-1.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "-1.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
bcl_setLeadingZeroes(false);
if (bcl_leadingZeroes())
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (bcl_leadingZeroes()) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
res = bcl_string(n);
if (strcmp(res, ".01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, ".01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(n2);
if (strcmp(res, "-.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "-.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(n3);
if (strcmp(res, "1.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "1.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);
res = bcl_string(n4);
if (strcmp(res, "-1.01"))
err(BCL_ERROR_FATAL_UNKNOWN_ERR);
if (strcmp(res, "-1.01")) err(BCL_ERROR_FATAL_UNKNOWN_ERR);
free(res);

10
contrib/bc/tests/history.py
View File

@ -251,7 +251,7 @@ def test_sigint_sigquit(exe, args, env):
try:
send(child, "\t")
expect(child, " ")
expect(child, "\t")
send(child, "\x03")
# send(child, "\x1c")
wait(child)
@ -320,7 +320,7 @@ def test_sigint(exe, args, env):
try:
send(child, "\t")
expect(child, " ")
expect(child, "\t")
send(child, "\x03")
wait(child)
except pexpect.TIMEOUT:
@ -355,7 +355,7 @@ def test_sigtstp(exe, args, env):
try:
send(child, "\t")
expect(child, " ")
expect(child, "\t")
send(child, "\x13")
time.sleep(1)
if not child.isalive():
@ -395,7 +395,7 @@ def test_sigstop(exe, args, env):
try:
send(child, "\t")
expect(child, " ")
expect(child, "\t")
send(child, "\x14")
time.sleep(1)
if not child.isalive():
@ -678,7 +678,7 @@ def test_bc7(exe, args, env):
send(child, "\x1b[0;4\x1b[0A")
send(child, "\n")
expect(child, prompt)
send(child, " ")
send(child, "\t")
send(child, "\x1bb\x1bb\x1bb\x1bb\x1bb\x1bb\x1bb\x1bb\x1bb\x1bb\x1bb\x1bb")
send(child, "\x1bf\x1bf\x1bf\x1bf\x1bf\x1bf\x1bf\x1bf\x1bf\x1bf\x1bf\x1bf")
send(child, "\n")

58
contrib/bc/tests/other.sh
View File

@ -62,6 +62,8 @@ else
halt="q"
fi
mkdir -p "$outputdir"
# For tests later.
num=100000000000000000000000000000000000000000000000000000000000000000000000000000
num2="$num"
@ -143,7 +145,7 @@ if [ "$d" = "bc" ]; then
redefine_res="$outputdir/bc_outputs/redefine.txt"
redefine_out="$outputdir/bc_outputs/redefine_results.txt"
outdir=$(dirname "$easter_out")
outdir=$(dirname "$redefine_out")
if [ ! -d "$outdir" ]; then
mkdir -p "$outdir"
@ -416,6 +418,60 @@ checkerrtest "$d" "$err" "colon long option" "$out2" "$d"
printf 'pass\n'
printf 'Running %s builtin variable arg tests...' "$d"
if [ "$extra_math" -ne 0 ]; then
out=$(printf '14\n15\n16\n17.25\n')
printf '%s\n' "$out" > "$out1"
if [ "$d" = "bc" ]; then
data=$(printf 's=scale;i=ibase;o=obase;t=seed@2;ibase=A;obase=A;s;i;o;t;')
else
data=$(printf 'J2@OIKAiAopRpRpRpR')
fi
printf '%s\n' "$data" | "$exe" "$@" -S14 -I15 -O16 -E17.25 > "$out2"
checktest "$d" "$?" "builtin variable args" "$out1" "$out2"
printf '%s\n' "$data" | "$exe" "$@" --scale=14 --ibase=15 --obase=16 --seed=17.25 > "$out2"
checktest "$d" "$?" "builtin variable long args" "$out1" "$out2"
else
out=$(printf '14\n15\n16\n')
printf '%s\n' "$out" > "$out1"
if [ "$d" = "bc" ]; then
data=$(printf 's=scale;i=ibase;o=obase;ibase=A;obase=A;s;i;o;')
else
data=$(printf 'OIKAiAopRpRpR')
fi
printf '%s\n' "$data" | "$exe" "$@" -S14 -I15 -O16 > "$out2"
checktest "$d" "$?" "builtin variable args" "$out1" "$out2"
printf '%s\n' "$data" | "$exe" "$@" --scale=14 --ibase=15 --obase=16 > "$out2"
checktest "$d" "$?" "builtin variable long args" "$out1" "$out2"
fi
printf 'scale\n' | "$exe" "$@" --scale=18923c.rlg > /dev/null 2> "$out2"
err="$?"
checkerrtest "$d" "$err" "invalid command-line arg for builtin variable" "$out2" "$d"
if [ "$extra_math" -ne 0 ]; then
printf 'seed\n' | "$exe" "$@" --seed=18923c.rlg > /dev/null 2> "$out2"
err="$?"
checkerrtest "$d" "$err" "invalid command-line arg for seed" "$out2" "$d"
fi
printf 'pass\n'
printf 'Running %s directory test...' "$d"
"$exe" "$@" "$testdir" > /dev/null 2> "$out2"

41
contrib/bc/vs/bc.vcxproj
View File

@ -102,7 +102,7 @@
<ClCompile>
<WarningLevel>Level3</WarningLevel>
<SDLCheck>true</SDLCheck>
<PreprocessorDefinitions>BC_ENABLED=1;DC_ENABLED=1;BC_ENABLE_EXTRA_MATH=1;BC_ENABLE_HISTORY=0;BC_ENABLE_NLS=0;BC_DEBUG_CODE=0;BC_ENABLE_LIBRARY=0;BUILD_TYPE=HN;BC_DEFAULT_BANNER=1;BC_DEFAULT_SIGINT_RESET=0;DC_DEFAULT_SIGINT_RESET=0;BC_DEFAULT_TTY_MODE=1;DC_DEFAULT_TTY_MODE=1;BC_DEFAULT_PROMPT=1;DC_DEFAULT_PROMPT=1;BC_DEFAULT_EXPR_EXIT=1;DC_DEFAULT_EXPR_EXIT=1;WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<PreprocessorDefinitions>BC_ENABLED=1;DC_ENABLED=1;BC_ENABLE_EXTRA_MATH=1;BC_ENABLE_HISTORY=1;BC_ENABLE_NLS=0;BC_DEBUG_CODE=0;BC_ENABLE_LIBRARY=0;BC_ENABLE_EDITLINE=0;BC_ENABLE_READLINE=0;BUILD_TYPE=N;BC_DEFAULT_BANNER=1;BC_DEFAULT_SIGINT_RESET=0;DC_DEFAULT_SIGINT_RESET=0;BC_DEFAULT_TTY_MODE=1;DC_DEFAULT_TTY_MODE=1;BC_DEFAULT_PROMPT=1;DC_DEFAULT_PROMPT=1;BC_DEFAULT_EXPR_EXIT=1;DC_DEFAULT_EXPR_EXIT=1;WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<AdditionalIncludeDirectories>..\include</AdditionalIncludeDirectories>
<RuntimeLibrary>MultiThreadedDebug</RuntimeLibrary>
<ConformanceMode>true</ConformanceMode>
@ -123,7 +123,7 @@
<FunctionLevelLinking>true</FunctionLevelLinking>
<IntrinsicFunctions>true</IntrinsicFunctions>
<SDLCheck>true</SDLCheck>
<PreprocessorDefinitions>BC_ENABLED=1;DC_ENABLED=1;BC_ENABLE_EXTRA_MATH=1;BC_ENABLE_HISTORY=0;BC_ENABLE_NLS=0;BC_DEBUG_CODE=0;BC_ENABLE_LIBRARY=0;BUILD_TYPE=HN;BC_DEFAULT_BANNER=1;BC_DEFAULT_SIGINT_RESET=0;DC_DEFAULT_SIGINT_RESET=0;BC_DEFAULT_TTY_MODE=1;DC_DEFAULT_TTY_MODE=1;BC_DEFAULT_PROMPT=1;DC_DEFAULT_PROMPT=1;BC_DEFAULT_EXPR_EXIT=1;DC_DEFAULT_EXPR_EXIT=1;WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<PreprocessorDefinitions>BC_ENABLED=1;DC_ENABLED=1;BC_ENABLE_EXTRA_MATH=1;BC_ENABLE_HISTORY=1;BC_ENABLE_NLS=0;BC_DEBUG_CODE=0;BC_ENABLE_LIBRARY=0;BC_ENABLE_EDITLINE=0;BC_ENABLE_READLINE=0;BUILD_TYPE=N;BC_DEFAULT_BANNER=1;BC_DEFAULT_SIGINT_RESET=0;DC_DEFAULT_SIGINT_RESET=0;BC_DEFAULT_TTY_MODE=1;DC_DEFAULT_TTY_MODE=1;BC_DEFAULT_PROMPT=1;DC_DEFAULT_PROMPT=1;BC_DEFAULT_EXPR_EXIT=1;DC_DEFAULT_EXPR_EXIT=1;WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<AdditionalIncludeDirectories>..\include</AdditionalIncludeDirectories>
<RuntimeLibrary>MultiThreaded</RuntimeLibrary>
<ConformanceMode>true</ConformanceMode>
@ -144,7 +144,7 @@
<ClCompile>
<WarningLevel>Level3</WarningLevel>
<SDLCheck>true</SDLCheck>
<PreprocessorDefinitions>BC_ENABLED=1;DC_ENABLED=1;BC_ENABLE_EXTRA_MATH=1;BC_ENABLE_HISTORY=0;BC_ENABLE_NLS=0;BC_DEBUG_CODE=0;BC_ENABLE_LIBRARY=0;BUILD_TYPE=HN;BC_DEFAULT_BANNER=1;BC_DEFAULT_SIGINT_RESET=0;DC_DEFAULT_SIGINT_RESET=0;BC_DEFAULT_TTY_MODE=1;DC_DEFAULT_TTY_MODE=1;BC_DEFAULT_PROMPT=1;DC_DEFAULT_PROMPT=1;BC_DEFAULT_EXPR_EXIT=1;DC_DEFAULT_EXPR_EXIT=1;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<PreprocessorDefinitions>BC_ENABLED=1;DC_ENABLED=1;BC_ENABLE_EXTRA_MATH=1;BC_ENABLE_HISTORY=1;BC_ENABLE_NLS=0;BC_DEBUG_CODE=0;BC_ENABLE_LIBRARY=0;BC_ENABLE_EDITLINE=0;BC_ENABLE_READLINE=0;BUILD_TYPE=N;BC_DEFAULT_BANNER=1;BC_DEFAULT_SIGINT_RESET=0;DC_DEFAULT_SIGINT_RESET=0;BC_DEFAULT_TTY_MODE=1;DC_DEFAULT_TTY_MODE=1;BC_DEFAULT_PROMPT=1;DC_DEFAULT_PROMPT=1;BC_DEFAULT_EXPR_EXIT=1;DC_DEFAULT_EXPR_EXIT=1;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<AdditionalIncludeDirectories>..\include</AdditionalIncludeDirectories>
<RuntimeLibrary>MultiThreadedDebug</RuntimeLibrary>
<ConformanceMode>true</ConformanceMode>
@ -164,7 +164,7 @@
<WarningLevel>Level3</WarningLevel>
<IntrinsicFunctions>true</IntrinsicFunctions>
<SDLCheck>true</SDLCheck>
<PreprocessorDefinitions>BC_ENABLED=1;DC_ENABLED=1;BC_ENABLE_EXTRA_MATH=1;BC_ENABLE_HISTORY=0;BC_ENABLE_NLS=0;BC_DEBUG_CODE=0;BC_ENABLE_LIBRARY=0;BUILD_TYPE=HN;BC_DEFAULT_BANNER=1;BC_DEFAULT_SIGINT_RESET=0;DC_DEFAULT_SIGINT_RESET=0;BC_DEFAULT_TTY_MODE=1;DC_DEFAULT_TTY_MODE=1;BC_DEFAULT_PROMPT=1;DC_DEFAULT_PROMPT=1;BC_DEFAULT_EXPR_EXIT=1;DC_DEFAULT_EXPR_EXIT=1;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<PreprocessorDefinitions>BC_ENABLED=1;DC_ENABLED=1;BC_ENABLE_EXTRA_MATH=1;BC_ENABLE_HISTORY=1;BC_ENABLE_NLS=0;BC_DEBUG_CODE=0;BC_ENABLE_LIBRARY=0;BC_ENABLE_EDITLINE=0;BC_ENABLE_READLINE=0;BUILD_TYPE=N;BC_DEFAULT_BANNER=1;BC_DEFAULT_SIGINT_RESET=0;DC_DEFAULT_SIGINT_RESET=0;BC_DEFAULT_TTY_MODE=1;DC_DEFAULT_TTY_MODE=1;BC_DEFAULT_PROMPT=1;DC_DEFAULT_PROMPT=1;BC_DEFAULT_EXPR_EXIT=1;DC_DEFAULT_EXPR_EXIT=1;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
<AdditionalIncludeDirectories>..\include</AdditionalIncludeDirectories>
<RuntimeLibrary>MultiThreaded</RuntimeLibrary>
<FunctionLevelLinking>true</FunctionLevelLinking>
@ -228,6 +228,7 @@
<ClCompile Include="..\src\dc_lex.c" />
<ClCompile Include="..\src\dc_parse.c" />
<ClCompile Include="..\src\file.c" />
<ClCompile Include="..\src\history.c" />
<ClCompile Include="..\src\lang.c" />
<ClCompile Include="..\src\lex.c" />
<ClCompile Include="..\src\library.c" />
@ -244,50 +245,50 @@
<ItemGroup>
<CustomBuild Include="..\gen\lib.bc">
<FileType>Document</FileType>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(OutDir)strgen.exe %(Identity) src2\lib.c bc_lib bc_lib_name BC_ENABLED 1</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(OutDir)strgen.exe %(Identity) src2\lib.c 0 bc_lib bc_lib_name BC_ENABLED 1</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">src2\lib.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(OutDir)strgen.exe %(Identity) src2\lib.c bc_lib bc_lib_name BC_ENABLED 1</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(OutDir)strgen.exe %(Identity) src2\lib.c 0 bc_lib bc_lib_name BC_ENABLED 1</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">src2\lib.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(OutDir)strgen.exe %(Identity) src2\lib.c bc_lib bc_lib_name BC_ENABLED 1</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(OutDir)strgen.exe %(Identity) src2\lib.c 0 bc_lib bc_lib_name BC_ENABLED 1</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">src2\lib.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(OutDir)strgen.exe %(Identity) src2\lib.c bc_lib bc_lib_name BC_ENABLED 1</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(OutDir)strgen.exe %(Identity) src2\lib.c 0 bc_lib bc_lib_name BC_ENABLED 1</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Release|x64'">src2\lib.c</Outputs>
</CustomBuild>
</ItemGroup>
<ItemGroup>
<CustomBuild Include="..\gen\lib2.bc">
<FileType>Document</FileType>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(OutDir)strgen.exe %(Identity) src2\lib2.c bc_lib2 bc_lib2_name BC_ENABLED 1</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(OutDir)strgen.exe %(Identity) src2\lib2.c 0 bc_lib2 bc_lib2_name BC_ENABLED 1</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">src2\lib2.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(OutDir)strgen.exe %(Identity) src2\lib2.c bc_lib2 bc_lib2_name BC_ENABLED 1</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(OutDir)strgen.exe %(Identity) src2\lib2.c 0 bc_lib2 bc_lib2_name BC_ENABLED 1</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">src2\lib2.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(OutDir)strgen.exe %(Identity) src2\lib2.c bc_lib2 bc_lib2_name BC_ENABLED 1</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(OutDir)strgen.exe %(Identity) src2\lib2.c 0 bc_lib2 bc_lib2_name BC_ENABLED 1</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">src2\lib2.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(OutDir)strgen.exe %(Identity) src2\lib2.c bc_lib2 bc_lib2_name BC_ENABLED 1</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(OutDir)strgen.exe %(Identity) src2\lib2.c 0 bc_lib2 bc_lib2_name BC_ENABLED 1</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Release|x64'">src2\lib2.c</Outputs>
</CustomBuild>
</ItemGroup>
<ItemGroup>
<CustomBuild Include="..\gen\dc_help.txt">
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(OutDir)strgen.exe %(Identity) src2\dc_help.c dc_help "" DC_ENABLED</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(OutDir)strgen.exe %(Identity) src2\dc_help.c 0 dc_help "" DC_ENABLED</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">src2\dc_help.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(OutDir)strgen.exe %(Identity) src2\dc_help.c dc_help "" DC_ENABLED</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(OutDir)strgen.exe %(Identity) src2\dc_help.c 0 dc_help "" DC_ENABLED</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">src2\dc_help.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(OutDir)strgen.exe %(Identity) src2\dc_help.c dc_help "" DC_ENABLED</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(OutDir)strgen.exe %(Identity) src2\dc_help.c 0 dc_help "" DC_ENABLED</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">src2\dc_help.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(OutDir)strgen.exe %(Identity) src2\dc_help.c dc_help "" DC_ENABLED</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(OutDir)strgen.exe %(Identity) src2\dc_help.c 0 dc_help "" DC_ENABLED</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Release|x64'">src2\dc_help.c</Outputs>
</CustomBuild>
</ItemGroup>
<ItemGroup>
<CustomBuild Include="..\gen\bc_help.txt">
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(OutDir)strgen.exe %(Identity) src2\bc_help.c bc_help "" BC_ENABLED</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(OutDir)strgen.exe %(Identity) src2\bc_help.c 0 bc_help "" BC_ENABLED</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">src2\bc_help.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(OutDir)strgen.exe %(Identity) src2\bc_help.c bc_help "" BC_ENABLED</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(OutDir)strgen.exe %(Identity) src2\bc_help.c 0 bc_help "" BC_ENABLED</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">src2\bc_help.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(OutDir)strgen.exe %(Identity) src2\bc_help.c bc_help "" BC_ENABLED</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">$(OutDir)strgen.exe %(Identity) src2\bc_help.c 0 bc_help "" BC_ENABLED</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">src2\bc_help.c</Outputs>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(OutDir)strgen.exe %(Identity) src2\bc_help.c bc_help "" BC_ENABLED</Command>
<Command Condition="'$(Configuration)|$(Platform)'=='Release|x64'">$(OutDir)strgen.exe %(Identity) src2\bc_help.c 0 bc_help "" BC_ENABLED</Command>
<Outputs Condition="'$(Configuration)|$(Platform)'=='Release|x64'">src2\bc_help.c</Outputs>
</CustomBuild>
</ItemGroup>

11
usr.bin/gh-bc/Makefile
View File

@ -11,6 +11,8 @@ SRCS= args.c bc.c bc_lex.c bc_parse.c data.c dc.c dc_lex.c dc_parse.c file.c hi
SRCS+= lang.c lex.c main.c num.c opt.c parse.c program.c rand.c read.c vector.c vm.c
SRCS+= bc_help.c dc_help.c lib.c lib2.c
LIBADD= edit
MAN= bc.1 dc.1
LINKS= ${BINDIR}/bc ${BINDIR}/dc
@ -39,6 +41,7 @@ CFLAGS+= -DBC_DEFAULT_PROMPT=0
CFLAGS+= -DBC_DEFAULT_SIGINT_RESET
CFLAGS+= -DBC_DEFAULT_TTY_MODE
CFLAGS+= -DBC_ENABLED
CFLAGS+= -DBC_ENABLE_EDITLINE
CFLAGS+= -DBC_ENABLE_EXTRA_MATH
CFLAGS+= -DBC_ENABLE_LIBRARY=0
CFLAGS+= -DBC_ENABLE_LONG_OPTIONS
@ -104,16 +107,16 @@ NLSLINKS_pt_PT.ISO8859-1+= pt_PT.ISO8859-15
.endif
lib.c: lib.bc Makefile
cd ${BCDIR} && sh gen/strgen.sh gen/lib.bc ${.OBJDIR}/lib.c bc_lib bc_lib_name 1 1
cd ${BCDIR} && sh gen/strgen.sh gen/lib.bc ${.OBJDIR}/lib.c 0 bc_lib bc_lib_name 1 1
lib2.c: lib2.bc Makefile
cd ${BCDIR} && sh gen/strgen.sh gen/lib2.bc ${.OBJDIR}/lib2.c bc_lib2 bc_lib2_name 1 1
cd ${BCDIR} && sh gen/strgen.sh gen/lib2.bc ${.OBJDIR}/lib2.c 0 bc_lib2 bc_lib2_name 1 1
bc_help.c: bc_help.txt Makefile
cd ${BCDIR} && sh gen/strgen.sh gen/bc_help.txt ${.OBJDIR}/bc_help.c bc_help
cd ${BCDIR} && sh gen/strgen.sh gen/bc_help.txt ${.OBJDIR}/bc_help.c 0 bc_help
dc_help.c: dc_help.txt Makefile
cd ${BCDIR} && sh gen/strgen.sh gen/dc_help.txt ${.OBJDIR}/dc_help.c dc_help
cd ${BCDIR} && sh gen/strgen.sh gen/dc_help.txt ${.OBJDIR}/dc_help.c 0 dc_help
bc.1:
${CP} ${BCDIR}/manuals/${MAN_SRC_BC} ${.OBJDIR}/bc.1