Content deleted Content added
mNo edit summary |
Stevebroshar (talk | contribs) there is a language, but's primarily a program, a tool, software |
||
| (46 intermediate revisions by 30 users not shown) | |||
Line 1:
{{Short description|Arbitrary-precision calculator supporting interactive and scripted use}}{{Not to be confused with|B programming language|C programming language}}{{more footnotes|date=June 2013}}
{{lowercase|title=bc programming language}}
{{Infobox
| name = bc
| logo =
Line 7:
| screenshot size =
| caption =
| developer = [[Robert Morris (cryptographer)|Robert Morris]] and [[Lorinda Cherry]] of [[Bell Labs]]
| released = {{Release year|df=yes|1975}}
| latest release version =
| latest release date =
| operating system = [[Unix]], [[Unix-like]],
| platform = [[Cross-platform]]
| genre = [[Command (computing)|Command]]
| license =
| website =
}}
'''bc''', for ''basic calculator''
==Overview==
A typical interactive usage is typing the command <code>bc</code> on a [[Unix]] [[Command-line interface#Command prompt|command prompt]] and entering a mathematical expression, such as {{code|(1 + 3) * 2}}, whereupon {{samp|8}} will be output. While bc can work with arbitrary precision, it actually defaults to zero digits after the decimal point, so the expression {{code|2/3}} yields {{samp|0}} (results are truncated, not rounded). This can surprise new bc users unaware of this fact. The {{code|-l}} option to bc sets the default ''scale'' (digits after the decimal point) to 20 and adds several additional mathematical functions to the language.
==History==
bc first appeared in [[Version 6 Unix]] in 1975.
In 1991, [[POSIX]] rigorously defined and standardized bc.
==
===POSIX bc===
The POSIX standardized bc language is traditionally written as a program in the [[dc (computer program)|dc]] programming language to provide a higher level of access to the features of the dc language without the complexities of dc's terse syntax.
Line 33 ⟶ 37:
All numbers and variable contents are [[arbitrary-precision]] numbers whose precision (in decimal places) is determined by the global '''<code>scale</code>''' variable.
The [[
Output is generated by deliberately not assigning the result of a calculation to a variable.
Line 39 ⟶ 43:
Comments may be added to bc code by use of the C '''<code>/*</code>''' and '''<code>*/</code>''' (start and end comment) symbols.
===
==== Exactly as C ====▼
The following POSIX bc [[Operator (programming)|operators]] behave exactly like their C counterparts:
Line 51 ⟶ 54:
( ) [ ] { }
====
The [[Modulus operator|modulus]] operators, <code>%</code> and <code>%=</code> behave exactly like their C counterparts only when the global '''<code>scale</code>''' variable is set to 0, i.e. all calculations are integer-only. Otherwise the computation is done with the appropriate scale. <code>a%b</code> is defined as <code>a-(a/b)*b</code>. Examples:
<
$ bc
bc 1.06
Line 65 ⟶ 68:
scale=20; 5%3
.00000000000000000002
</syntaxhighlight>
====
The operators
Line 76 ⟶ 79:
Of particular note, the use of the <code>^</code> operator with negative numbers does not follow the C operator precedence. <code>-2^2</code> gives the answer of 4 under bc rather than −4.
====
The [[bitwise operation|bitwise]], [[Boolean logic|
& | ^ && ||
Line 87 ⟶ 90:
are not available in POSIX bc.
===
The '''<code>sqrt()</code>''' function for calculating [[square root]]s is POSIX bc's only built-in mathematical function. Other functions are available in an external standard library.
The '''<code>scale()</code>''' function for determining the precision (as with the '''<code>scale</code>''' variable) of its argument and the '''<code>length()</code>''' function for determining the number of significant decimal digits in its argument are also built-in.
===
bc's standard math library (defined with the '''-l''' option) contains functions for calculating [[sine]], [[cosine]], [[arctangent]], [[natural logarithm]], the [[exponential function]] and the two parameter [[Bessel function]] ''J''. Most standard mathematical functions (including the other inverse trigonometric functions) can be constructed using these. See external links for implementations of many other functions.
{| class="wikitable"
|+The bc standard library<ref name=":0">{{
!bc command
!Function
Line 127 ⟶ 130:
The '''-l''' option changes the scale to 20,<ref name=":0" /> so things such as modulo may work unexpectedly. For example, writing <code>bc -l</code> and then the command <code>print 3%2</code> outputs 0. But writing <code>scale=0</code> after <code>bc -l</code> and then the command <code>print 3%2</code> will output 1.
==
[[Plan 9 from Bell Labs|Plan 9]] bc is identical to POSIX bc but for an additional '''<code>print</code>''' statement.
==
GNU bc derives from the POSIX standard and includes many
GNU bc variables, arrays and function names may contain more than one character, some more operators have been included from C, and notably, an '''<code>if</code>''' clause may be followed by an '''<code>else</code>'''.
Line 143 ⟶ 146:
The value of the last calculation is always stored within the additional built-in '''<code>last</code>''' variable.
===
The following [[logical operator]]s are additional to those in POSIX bc:
Line 150 ⟶ 153:
They are available for use in conditional statements (such as within an '''<code>if</code>''' statement). Note, however, that there are still no equivalent bitwise or assignment operations.
===
All functions available in GNU bc are inherited from POSIX. No further functions are provided as standard with the GNU distribution.
==
Since the bc <code>^</code> operator only allows an integer power to its right, one of the first functions a bc user might write is a power function with a floating-point exponent. Both of the below assume the standard library has been included:
===
<syntaxhighlight lang="bc">
/* A function to return the integer part of x */
Line 177 ⟶ 180:
</syntaxhighlight>
===
Calculate [[pi]] using the builtin [[Inverse trigonometric functions|arctangent]] function, {{mono|a()}}:
<syntaxhighlight lang="console" highlight="3">
Line 186 ⟶ 189:
</syntaxhighlight>
===
Because the syntax of bc is similar to that of [[C (programming language)|C]], published numerical functions written in C can often be translated into bc quite easily, which immediately provides the arbitrary precision of bc. For example, in the [[Journal of Statistical Software]] (July 2004, Volume 11, Issue 5), [[George Marsaglia]] published the following C code for the [[normal distribution|cumulative normal distribution]]:
Line 199 ⟶ 202:
</syntaxhighlight>
With some necessary changes to accommodate bc's different syntax, and
<syntaxhighlight lang="bc">
Line 212 ⟶ 215:
</syntaxhighlight>
==
bc can be used non-interactively, with input through a [[Pipeline (Unix)|pipe]]. This is useful inside [[shell script]]s. For example:
<
$ result=$(echo "scale=2; 5 * 7 /3;" | bc)
$ echo $result
11.66
</syntaxhighlight>
In contrast, note that the [[Bash (Unix shell)|bash shell]] only performs integer arithmetic, e.g.:
<
$ result=$((5 * 7 /3))
$ echo $result
11
</syntaxhighlight>
One can also use the [[Here document|here-string]] idiom (in bash, ksh, csh):
<
$ bc -l <<< "5*7/3"
11.66666666666666666666
</syntaxhighlight>
==
* [[dc (computer program)|dc programming language]]
* [[C (programming language)|C programming language]]
* [[hoc (programming language)|hoc programming language]]
==
{{Reflist}}
{{Refbegin}}
Line 242 ⟶ 245:
* [https://www.gnu.org/software/bc/manual/html_mono/bc.html GNU bc manual page]
* [https://web.archive.org/web/20090501204511/http://manpages.ubuntu.com/manpages/jaunty/en/man1/bc.1posix.html POSIX bc manual page]
* {{man|1|bc|Plan 9}}
* [http://plan9.bell-labs.com/7thEdMan/vol2/bc 7th Edition Unix bc manual page] {{Webarchive|url=https://web.archive.org/web/20061008193920/http://plan9.bell-labs.com/7thEdMan/vol2/bc |date=2006-10-08 }}
* [http://compilers.iecc.com/comparch/article/95-09-015 A comp.compilers article on the design and implementation of C-bc]
* [http://minnie.tuhs.org/cgi-bin/utree.pl?file=V6/usr/source/s1/bc.y 6th Edition Unix bc source code], the first release of bc, from May 1975, compiling bc syntax into dc syntax
* [http://ftp.gnu.org/gnu/bc/ GNU bc source code]
{{Refend}}
==
{{Wikibooks|Guide to Unix|Commands}}
* [https://doi.acm.org/10.1145/152923.152925 Dittmer, I. 1993. Error in Unix commands dc and bc for multiple-precision-arithmetic. SIGNUM Newsl. 28, 2 (Apr. 1993), 8–11.]
* [http://www.phodd.net
* [https://www.gnu.org/software/bc/ GNU bc] (and an [http://alpha.gnu.org/gnu/bc/ alpha version]) from the Free Software Foundation
* [https://web.archive.org/web/20160222234922/http://gnuwin32.sourceforge.net/packages/bc.htm bc for Windows] from [[GnuWin32]]
* [https://github.com/gavinhoward/bc Gavin Howard bc] - another open source implementation of bc by Gavin Howard with GNU and BSD extensions
* [https://web.archive.org/web/20160304084708/http://x-bc.sourceforge.net/ X-bc] - A Graphical User Interface to bc
** [https://web.archive.org/web/20160304092132/http://x-bc.sourceforge.net/
** [https://web.archive.org/web/20160304081309/http://x-bc.sourceforge.net/scientific_constants_bc.html scientific_constants.bc] - contains particle masses, basic constants, such as speed of light in the vacuum and the gravitational constant
{{
{{Plan 9 commands}}
[[Category:Software calculators]]
Line 265 ⟶ 272:
[[Category:Standard Unix programs]]
[[Category:Unix SUS2008 utilities]]
[[Category:Plan 9 commands]]
| |||