DarwinBotsManual
Open the app EspañolES

addstore

Adds a number to what is already in a cell, without having to read it first.

Facts

Word
addstore
Family
Writing to memory
Integer stack
pops 2, pushes 0
What it does
Pops an address and a value, and adds the value to that cell, with circular wraparound at ±32000. With address 0 the value stays on the stack.
Cost
Store divided by the divisor of each one, only if it writes
Cost divisor
÷ 5
Runs
in the body of a gene (start or else), and only if the top of the boolean stack is true or the stack is empty
Marks ties
yes

v d addstore adds v to cell d. It is equivalent to *d v add d store, with fewer words and at one fifth of the cost of a store.

WordStack after
22
502 50
addstore(empty); cell 50 ends up 2 higher

It is good for accumulating: adding up what an eye sees, keeping a total, or growing a command a little at a time.

' speeds up gradually: asks for 2 more each cycle, up to 40
cond
start
 2 50 addstore
 40 50 ceilstore
 *50 .up store
stop

Cell 50 holds 2, 4, 6… and from cycle 20 on it stays at 40, the ceiling set by ceilstore. .up receives that value every cycle.

With a negative v it subtracts, so -3 50 addstore does the same as 3 50 substore. The result is clipped to ±32000, just like in store, and with address 0 the value stays on the stack unused.

Unlike inc, addstore does notify the tie system when you write to .tieang1 or .tielen1: to add 1 to a tie's angle, 1 .tieang1 addstore is the right way.