#
*Subtractor*

Library: |
Arithmetic |

Introduced: |
2.0 Beta 11 |

Appearance: |

## Behavior

This component subtracts values coming in via the west inputs (the upper minus the lower) and outputs the difference on the east output. The component is designed so that it can be cascaded with other subtractors to provide subtract more bits than is possible with a single subtractor: The borrow-in input provides a one-bit value to be borrowed out of the difference (if the borrow-in input is specified), and a borrow-out output indicates whether the component needs to borrow an upper-order bit to complete the subtraction without underflow (assuming unsigned subtraction).

Internally, the subtractor simply performs a bitwise NOT on the
subtrahend, and add this to the minuend along with the NOT of the
borrow-in input. (The *minuend* is the first operand (upper
input) to the subtraction, and the *subtrahend* is the second
(lower input). I happen to like the antiquated terms.)

If either of the operands contains some floating bits or some error bits, then the component will perform a partial subtraction. That is, it will compute as many low-order bits as possible. But above the floating or error bit, the result will have floating or error bits.

## Pins

- West edge, north end (input, bit width matches Data Bits attribute)
- The minuend of the subtraction; that is, the number from which to subtract.
- West edge, south end (input, bit width matches Data Bits attribute)
- The subtrahend of the subtraction; that is, the number to subtract from the minuend.
- North edge, labeled
`b in`(input, bit width 1) - If 1, then 1 is borrowed out of the difference. If the value is unknown (i.e., floating), then it is assumed to be 0.
- East edge (output, bit width matches Data Bits attribute)
- The lower
`dataBits`bits of the difference of the two values coming in the west edge, minus the`b`_{in}bit. - South edge, labeled
`b out`(output, bit width 1) - The borrow bit computed for the difference. If the values subtracted as unsigned values yield a negative value, then this bit will be 1; otherwise, it will be 0.

## Attributes

When the component is selected or being added,
Alt-0 through Alt-9 alter its Data Bits

attribute.

- Data Bits
- The bit width of the values to be subtracted and of the result.

## Poke Tool Behavior

None.

## Text Tool Behavior

None.