{"id":10956,"date":"2025-06-23T02:00:00","date_gmt":"2025-06-23T06:00:00","guid":{"rendered":"https:\/\/www.both.org\/?p=10956"},"modified":"2025-06-20T14:35:34","modified_gmt":"2025-06-20T18:35:34","slug":"a-beginners-guide-to-dc","status":"publish","type":"post","link":"https:\/\/www.both.org\/?p=10956","title":{"rendered":"A beginner’s guide to dc"},"content":{"rendered":"
\r\n
\r\n \r\n <\/i>\r\n <\/a>\r\n <\/span>\r\n<\/div><\/div>\n

Imagine it’s the 1970s and you’re writing a program to simulate a physical event. (This was a common use case for computers at the time, especially using the FORTRAN programming language.) Your subroutine requires using a tricky constant value, which you’ve worked out using algebra as the square root of 480 divided by 3<\/em>.<\/p>\n\n\n\n

You could<\/em> enter that calculation into the program, and let the FORTRAN program calculate SQRT(480.)\/3.<\/code> each time. But calculating a square root can be slow, especially on 1970s hardware. It will be faster to enter that value as a constant in the program itself. How would you calculate the square root of 480 divided by 3<\/em> so you can enter that as a number<\/em> in the program?<\/p>\n\n\n\n

Old-style calculators<\/h2>\n\n\n\n

In 2025, you’d probably use the calculator app on your phone. Before the era of the smartphone, you’d probably use a pocket calculator, like the Texas Instruments TI-36X calculator that I used throughout my undergraduate physics program in the 1990s.<\/p>\n\n\n\n

But in the 1970s, the “pocket calculator” was an expensive device; the Hewlett Packard HP-35 calculator<\/a> was introduced in the early 1970s and cost $395 (that’s over $3000 in today’s dollars, which is quite an investment). Pocket calculators became less expensive over time, such as the mid to late 1970s, although less expensive scientific pocket calculators became available later, around the late 1970s to early 1980s.<\/p>\n\n\n\n

Instead, a programmer in the 1970s would likely use a desktop calculator<\/em> to calculate the square root of 480 divided by 3<\/em>. A desktop calculator was a big machine that sat on your desk (hence its name) and was dedicated to performing all kinds of calculations. These were still expensive, but less so than a pocket scientific calculator.<\/p>\n\n\n\n

Calculators at the time typically used Reverse Polish Notation<\/em> (RPN) where you entered numbers separately, then<\/em> pressed a key to perform an operation. Entering values was done on a stack<\/em>, which was “first in, last out.” That is, adding two numbers like 2+4<\/strong> required entering the value 2<\/strong> into the stack (called “pushing”), then entering the value 4<\/strong> into the stack, then pressing the “+” key. This took the two most recent values (2<\/strong> and 4<\/strong>) off the stack (called “popping”) and added them, then pushed the answer (6<\/strong>) back onto the stack.<\/p>\n\n\n\n

The desktop calculator: dc<\/h2>\n\n\n\n

In the early 1970s, one of the first programs written for the PDP-11 at Bell Labs was dc<\/strong>, the “desktop calculator” program created by Lorinda Cherry and Robert Morris. It is also one of the oldest original Unix programs, and it’s still available on Linux today. I mostly use dc<\/strong> to perform quick calculations while I’m at the command line.<\/p>\n\n\n\n

Not surprisingly, dc<\/strong> uses RPN like every other calculator from the 1970s. This may seem strange if you aren’t used to RPN, but it gets easier after you’ve used it for a while. The key to using RPN in dc<\/strong> is to enter each number and operation, surrounded by whitespace like a space, tab, or new line. For example, to calculate 2+4<\/strong>, you push the values 2<\/strong> and 4<\/strong> onto the stack, then enter “+” to add them. For example:<\/p>\n\n\n\n

$ dc\n2\n4\n+<\/code><\/pre>\n\n\n\n
This pops 2<\/strong> and 4<\/strong> off the stack, adds them, and pushes 6<\/strong> back onto the stack. But you’ll notice that dc<\/strong> doesn’t print the result. That’s because when dc<\/strong> was created, Bell Labs used the TeleType terminal, which printed everything on paper (not a screen). And printing on a TeleType is loud and slow. If dc<\/strong> didn’t need to print something, it didn’t. The user might have more calculations to do with this value, so it doesn’t print the result until you use the “p” command. Let’s add the “p” command to the session, but this time I’ll enter the values and operation on the first line, to show you can use any whitespace to separate the values:<\/p>\n\n\n\n
$ dc\n2 4 +\np\n6<\/code><\/pre>\n\n\n\n
If that’s the only calculation you need to do, you can quit the program by entering the “q” command, or pressing ctrl+D<\/em> on the keyboard.<\/p>\n\n\n\n
Sample calculations with dc<\/h2>\n\n\n\n
Let’s do a few sample calculations with dc<\/strong> to see how it works. Remember, to see the results, you need to add the “p” command, which I’ll include.<\/p>\n\n\n\n
We’ve already seen an example of addition, so let’s start with subtraction. To subtract 7 from 72, you push 72 and 7 onto the stack, in that order<\/em>, then use the “-” command to subtract them.<\/p>\n\n\n\n
72 7 -\np\n65<\/code><\/pre>\n\n\n\n
Printing a value with “p” doesn’t change the stack, which now contains only the value 65. If we needed to subtract another number from this value, such as 65-12<\/strong>, we can push the number 12 onto the stack, then use the “-” command to subtract 12 from 65:<\/p>\n\n\n\n
12 -\np\n53<\/code><\/pre>\n\n\n\n
If we needed to subtract two different<\/em> numbers, such as 22-9<\/strong>, we can enter those two values into the stack and use the “-” command again. The stack will actually have three<\/em> values in it (53, 22, and 9) but the basic arithmetic commands (“+”, “-“, “*<\/code>” and “\/”) only operate on the two most recent entries<\/em>:<\/p>\n\n\n\n
22 9 -\np\n13<\/code><\/pre>\n\n\n\n
Values on the stack<\/h2>\n\n\n\n
After the “-” command, the stack now has two values in it: 53 (left over from the previous calculation) and 13 (from this calculation). If you want to see the contents of the stack, use the “f” command:<\/p>\n\n\n\n
f\n13\n53<\/code><\/pre>\n\n\n\n
These values are actually shown in reverse<\/em> order, which we can see if we use “-” one more time. This will subtract 13 from 53.<\/p>\n\n\n\n
- p\n40\n<\/code><\/pre>\n\n\n\n
We can use the “f” command one more time to show that only one value is left in the stack after subtracting these two values:<\/p>\n\n\n\n
f\n40<\/code><\/pre>\n\n\n\n
Adjusting the precision<\/h2>\n\n\n\n
Let’s say you want to divide two values, such as 42 by 6. You use the “\/” command to divide the two most recent entries in the stack. I’ll start this session with the “c” command to clear the stack, and “f” to show that there’s nothing in there, then I’ll enter and print the division calculation:<\/p>\n\n\n\n
c\nf\n42 6 \/\np\n7<\/code><\/pre>\n\n\n\n
This result is as you would expect, because 6 times 7 really is<\/em> the value 42. The division is even, without any remainder. But what happens when you divide two numbers that don’t produce a nice value like that? Let’s try it by dividing 1 by 4, which should give 0.25:<\/p>\n\n\n\n
c\n1 4 \/\np\n0<\/code><\/pre>\n\n\n\n
Oh no! That gives a zero value. This is because dc<\/strong> is an arbitrary precision<\/em> calculator, and you can adjust the precision to any number of decimal places. By default, the precision is zero, which works only for integer values. To set the precision to some other value, like 5 decimal places, enter the number 5 into the stack and use the “k” command. If you repeat the calculation, you’ll get the expected result:<\/p>\n\n\n\n
5 k\n1 4 \/\np\n.25000<\/code><\/pre>\n\n\n\n
Calculating with dc<\/h2>\n\n\n\n
To get started with dc<\/strong>, I recommend you stick to the basics. These basic operations are enough to solve the calculations that I need to do on a day-to-day basis:<\/p>\n\n\n\n
operation<\/th>what it does<\/th><\/tr><\/thead>
+<\/code><\/td>Addition<\/td><\/tr>
-<\/code><\/td>Subtraction<\/td><\/tr>
*<\/code><\/td>Multiplication<\/td><\/tr>
\/<\/code><\/td>Division<\/td><\/tr>
%<\/code><\/td>Modulo (remainder after division) such as 13 4 %<\/code> to calculate 1<\/code><\/td><\/tr>
^<\/code><\/td>Exponent, such as 4 2 ^<\/code> to calculate 4 squared<\/em><\/td><\/tr>
v<\/code><\/td>Square root (you might also need to set the precision)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Use these commands to interact with the calculator, such as to clear the stack or manipulate values. Again, as you get started with dc<\/strong>, keep it to the basics:<\/p>\n\n\n\n
command<\/th>what it does<\/th><\/tr><\/thead>
c<\/code><\/td>clear the stack<\/td><\/tr>
d<\/code><\/td>duplicate the value on the stack, such as 3 d *<\/code> to calculate 3 squared<\/em><\/td><\/tr>
r<\/code><\/td>reverse the two “top” entries on the stack<\/td><\/tr>
k<\/code><\/td>set the precision (number of decimal places)<\/td><\/tr>
q<\/code><\/td>quit<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
So let’s go back to the original problem: calculate the square root of 480 divided by 3<\/em>. That is not a round number, so we should first set the precision with the “k” command. Calculate the square root of 480, divide that result by 3, then print the result. I’ll group the calculations and commands on separate lines, but these could all be entered on separate lines or all on one line:<\/p>\n\n\n\n
$ dc\n8 k\n480 v\n3 \/\np\n7.30296743<\/code><\/pre>\n\n\n\n
Let’s verify that result: if I enter that calculation into a calculator app on my phone, the square root of 480 is about 21.9089023. And 21.9089023 divided by 3 is 7.3029674334.<\/p>\n\n\n\n
The dc<\/strong> command is a handy tool to use when you are working at the command line and need to calculate a value quickly. The calculator app on my phone, or the calculator app on my desktop system, is convenient most of the time\u2014but if I’m working at the command line and just need to calculate something, pulling up a separate app is a distraction. Using dc<\/strong> keeps me at the command line, where I’m already doing my work.<\/p>\n\n\n\n
I’ve only covered the basics of dc<\/strong> here. If you want to do more with it, use man dc<\/strong> to explore the manual page.<\/p>\n","protected":false},"excerpt":{"rendered":"
Learn the basics of this handy command line calculator.<\/p>\n","protected":false},"author":33,"featured_media":9839,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[100,5],"tags":[104,91],"class_list":["post-10956","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-command-line","category-linux","tag-command-line","tag-linux"],"modified_by":"Jim Hall","_links":{"self":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/10956","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/users\/33"}],"replies":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10956"}],"version-history":[{"count":3,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/10956\/revisions"}],"predecessor-version":[{"id":10959,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/10956\/revisions\/10959"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/media\/9839"}],"wp:attachment":[{"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10956"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10956"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10956"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}