Lesson 11

Specialized Stack and Arithmetic Operations

This is a good time to learn several other basic Mops operations. They're rather simple, so we may as well get them out of the way now. We won't be saying too much about them here, but you might want to experiment with them for a bit to get a feeling for how they work.

One group of operations compares the values of the two topmost items in the parameter stack. The result of the comparison is placed on the stack. Here they are:

MIN	( n1 n2 -- n-min )	Leaves the smaller of ‘n1’ and ‘n2’ on the stack.
MAX	( n1 n2 -- n-max )	Leaves the larger of ‘n1’ and ‘n2’ on the stack.

The next group manipulates the signs of integers, whether positive or negative. One returns the absolute (positive) value of the topmost number in the stack. The other changes the sign of the topmost number in the stack: if the original is positive, the operation changes it to negative, and vice versa. Here are these two operations:

ABS	( n -- |n| )	Leaves the absolute value of ‘n’ on the stack.
NEGATE	( n -- n )	Changes the sign of the topmost number on the stack.

Next is a list of simple arithmetic shortcuts. Their meanings should be self-evident.

1+	( n -- n+1 )	Adds 1 to the number on the stack.
1-	( n -- n-1 )	Subtracts 1 from the number on the stack.
2+	( n -- n+2 )	Adds 2 to the number on the stack.
2-	( n -- n-2 )	Subtracts 2 from the number on the stack.
2*	( n -- 2n )	Multiplies the number on the stack by 2.
2/	( n -- n/2 )	Divides the number on the stack by 2.
3+	( n -- n+3 )	Adds 3 to the number on the stack.
3-	( n -- n-3 )	Subtracts 3 from the number on the stack.
4+	( n -- n+4 )	Adds 4 to the number on the stack.
4-	( n -- n-4 )	Subtracts 4 from the number on the stack.
4*	( n -- 4n )	Multiplies the number on the stack by 4.
4/	( n -- n/4 )	Divides the number on the stack by 4.

The application of these shortcuts will become more apparent the more you program in Mops. The addition and subtraction shortcuts, for example, come in handy when you need to increment or decrement a counter of some kind.

Displaying Text

So far in this tutorial, we've used the . (dot) command to display a number on the screen. But, many times in a program, you will probably also want to display text on the screen. It may be to display a heading of some kind, or to make your program more user-friendly by describing what a purely numeric answer is supposed to represent. In the latter case, you are usually combining the display of an unchanging text message with a numeric answer which can change from execution to execution. For the text itself, we can use the Mops word ." (pronouced "dot-quote"), followed by the desired text message, and followed by a final quotation mark (")

In Mops, like many computer languages, quotation marks fall into a broad category of symbols which are known as delimiters, because they delimit or set the limits for something”in this case, a text message. The text within this set of delimiters is called a text string, or just string. With normal Mops words, spaces, tabs, or carriage returns are the delimiters. However for message strings we usually want to be able to include spaces as part of the string, so we use " as a delimiter instead. However, since ." is a Mops word, it must itself be delimited by a space. This space is not included as part of the string, but the first character after the space is the first character of the string (even if it is a space). Here is an example:

 : HI  ." Hello, this is Mops operating on the Mac."  cr ;
 

Now, when you type HI at the Mops prompt, the message between the quotes appears on the screen. Again, observe that the space immediately after the ." is not part of the message, but just serves to delimit ." as a word that Mops can recognize. If the space wasn't there, Mops would try to interpret "."hello," as a word, which certainly isn't what we want.

One of the nice things about Mops is that you can use previously defined words inside the definitions of new words. Therefore, you could take the HI word we just defined and incorporate it inside yet another Mops definition. For example,

 : GREETING  hi ." How are you?" cr ;
 

produces not only the message of HI, but an additional text string whenever you type GREETING at a Mops prompt.

Now combine your knowledge of arithmetic operations and text strings to "humanize" the arithmetic word, ADD, from our previous lesson. Here's the new definition:

 : ADD  ( n1 n2 --  )  + ." The sum is: " . cr ;
 

Or, if ADD is still defined from our last lesson (and you want to be tricky), we can also do:

 : ADD  ( n1 n2 --  )  ." The sum is: " add ;
 

To use the new word, issue the command at the Mops prompt like this:

10 20 add
The sum is: 30 

Explicit Stack Manipulations

While named input parameters and local variables will disguise many stack manipulations for you, there may be occasions when the order of items in the stack requires an explicit move of some values for a particular operation. Conversely, the stack may have a number on it that you simply don't need anymore, and want to dispose of. In these cases, you can choose from a series of stack manipulation operations.

Here are three stack manipulation operators that you should keep in mind:

SWAP	( n1 n2 -- n2 n1 )	Switches the order of the topmost two items in the parameters stack.
DUP	( n -- n n )	Duplicates the topmost stack item and places the new copy on top.
DROP	( n -- )	Removes the topmost stack item. If another item is next in line, it becomes the topmost item.

SWAP is used, for example, in a more complex definition, when two values are on the stack but their order is wrong for a subtraction or division. In fact, it could have been used in a less elegant definition for the problem cited in Lesson 3:

  5 * 12 * 50
 -------------
      40
 

By putting the divisor at the bottom of the stack (the first one in), you can perform all the multiplications and then switch the order of the two remaining numbers on the stack so they divide properly. The revised operation would be:

40 5 12 50 * * swap /

The word definition that calculates this would be:

 : FORMULA3  ( denom num1 num2 num3 -- solution )
             * * swap / ;
 

DUP is sometimes useful for particular arithmetic applications. An example of how DUP works is to use it to calculate the square of a number. Instead of pushing two identical values on the stack, you need to push only one, duplicate it, and then multiply the two values on the stack like this:

4 dup *

Calculating the cube of a number could, likewise, be performed like this:

4 dup dup * *

Therefore, you could set up a Mops word, CUBED, to perform the cube calculation:

 : CUBED  ( n -- )  dup dup * * . cr ;
 

Then you could type '3 cubed' from the Mops prompt, and the answer would appear on the screen like this:

3 cubed
27

Experiment with the other stack manipulation operators described above. Place a few numbers in the parameter stack, issue the commands, and see what happens in the stack display of the Mops window. If you need to, you can combine two or more stack manipulation operators in the same Mops word definition as your arithmetic needs arise.

But overall, named input parameters and local variables are the preferred way of handling values on the stack in a complex definition, and programs that use them tend be easier to trace and debug than programs that use explicit stack manipulations (sometimes referred to as stack gymnastics). And because named parameters and local variables are more intuitive, there is less chance of making a mistake in the first place.

---

Lesson 10	Tutorial	Lesson 12
Documentation