urbit/pub/docs/dev/hoon/runes/ts/tshp.md
Galen Wolfe-Pauly bb495844be doc -> docs
2015-10-20 10:51:45 -07:00

63 lines
1.0 KiB
Markdown

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 [twig]()s.
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.