urbit/pub/docs/dev/hoon/runes/ts/tshp.md

tishep, =-, %tshp

Push on, inverse

=- is a synthetic rune that pushes q on the subject and sends it to p. =- is the inverse of =+. Use =- when your computation, q is lengthier and =- makes for more readable code.

See also

tislus, =+, %tsls

Produces

Twig: [%tshp p=twig q=twig]

Sample

p and q are twigs.

Tall form

=-  p
    q

Wide form

=-(p q)

Irregular form

None

Examples

~zod/try=> =-  [%a a]
               [a=1]
[%a 1]

In this simple example we push [a=1] on to our subject, and produce [%a a] which pulls the value of a from the subject producing [%a 1].

~zod/try=> 
=cor  |=  [a=@ b=@]
      =-  [[%a a] [%b b]]
      [a b]=[(add a 2) (add a b)]
new var %cor
~zod/try=> (cor 2 4)
[[%a 4] %b 6]

Here we create a gate cor that takes two atoms a and b. We use =- to put the product of our computation first.