Welcome to Logicode!

Logicode is a minimalistic language that is mainly based on Logisim.

Because of that, the only built-in commands are AND, OR and NOT, and you make the rest.

The three logic gates are represented like so:

• a&b: AND of a and b.
• a|b: OR of a and b.
• !a: NOT of a.

There are more built-ins:

• ?: Random bit, either 0 or 1.
• #: Begins a line for comments.

You can make extra things from these commands, like circuits and variables.

To create a circuit, you have to do this:

circ circuit_name(arg1, arg2...)->{what the function does}

circ is the circuit "declaration", and everything after the -> is interpreted as code.

Normal circuits have 1 bit as output, but if more bits are required, use the + symbol to separate bits.

Like this:

circ circuit_name(arg1, arg2...)->{1st bit}+{2nd bit}+...

To create a variable:

var var_name=value

var is the variable declaration.

To create a condition:

cond arg->{executed if arg = 1}/{executed if arg = 0}

cond is the variable declaration, arg is either a value of 0 or 1, and the / is the separator of the two executing strings.

There is also output as well:

out out_value

out is the output declaration, and you can include the built-in commands, as well as self-made circuits, into the output to be processed.

circ xor(a,b)->(!(a&b))&(a|b) var test=xor(1,1) out !(test) Output: 1 

The circuit xor calculates the XOR of two bits, and test is declared as the XOR of 1 and 1 (which is 0).

Then, the out outputs the NOT of test, which is 1.

Expanding on the previous example:

circ xor(a,b)->(!(a&b))&(a|b) circ ha(a,b)->(a&b)+(xor(a,b)) out ha(1,?) Output: 10 

The circuit xor is the same as before, and the circuit ha is a half-adder of two bits (so it takes two arguments), and outputs two bits.

The out outputs the half-adding of 1 and ?, which is either 01 or 10 (depending on what the ? gives).