git.iko.soy/urbit.org
on 5e6a67f help sign in
urbit.org/docs/programming/reference/zuse/gate/foal.md
43 lines 790 B history raw
2### `++foal`
4Write high-level change
6Produces a [`++toro`](), a change intended for whatever file is located
7at `pax`. Handled by `%clay`.
9Accepts
10-------
12`pax` is a [`++path`]().
14`val` is a value as a [noun]().
16Produces
17--------
19A [`++toro`]().
21Source
22------
24 ++ foal :: high-level write
25 |= [pax=path val=*]
26 ^- toro
27 ?> ?=([* * * *] pax)
28 [i.t.pax [%& [*cart [[t.t.t.pax (feel pax val)] ~]]]]
29 ::
31Examples
32--------
34 ~zod/try=> + %/mek 'a'
35 + /~zod/try/4/mek
36 ~zod/try=> (foal %/mek 'b')
37 [ p=~.try
38 q
39 [%.y q=[p=[p=0v0 q=0v0] q=~[[p=/mek q=[%mut p=[p=%a q=[%a p=97 q=98]]]]]]]
40 ]
41 ~zod/try=> (feel %/mek 'b')
42 [%mut p=[p=%a q=[%a p=97 q=98]]]