on 140ac0e help sign in
454 lines 9.5 kB history raw
1# 4n: virtualization
2### `++mack`
4Nock subject to unit
6Accepts a nock subject-formula cell and wraps it into a `++unit`.
7`fol` is pure nock, meaning that nock `11` operations result in a block,
8producing a `~`.
10Accepts
11-------
13`sub` is a subject noun.
15`fol` is a formula noun, which is generally a `++nock`.
17Produces
18--------
20The `++unit` of a noun.
22Source
23------
25 ++ mack
26 |= {sub/* fol/*}
27 ^- (unit)
28 =+ ton=(mink [sub fol] |=({* *} ~))
29 ?.(?=({$0 *} ton) ~ [~ p.ton])
30 ::
33Examples
34--------
36 > (mack [[1 2 3] [0 1]])
37 [~ [1 2 3]]
38 > (mack [41 4 0 1])
39 [~ 42]
40 > (mack [4 0 4])
41 ~
42 > (mack [[[0 2] [1 3]] 4 4 4 4 0 5])
43 [~ 6]
44 > ;;((unit @tas) (mack [[1 %yes %no] 6 [0 2] [0 6] 0 7]))
45 [~ %no]
49***
50### `++mink`
52Mock interpreter
54Bottom-level mock (virtual nock) interpreter. Produces a
55`++tone`, a nock computation result. If nock 11 is invoked, `sky`
56computes on the subject and produces a `++unit` result. An empty
57result becomes a `%1` `++tone`, indicating a block.
59Accepts
60-------
62`sub` is the subject as a noun.
64`fol` is the formula as a noun.
66`sky` is an `%iron` gate invoked with nock operator 11.
68Produces
69--------
71A `++tone`.
73Source
74------
76 ++ mink
77 ~/ %mink
78 |= {{sub/* fol/*} gul/$-({* *} (unit (unit)))}
79 =+ tax=*(list {@ta *})
80 |- ^- tone
81 ?@ fol
82 [%2 tax]
83 ?: ?=(^ -.fol)
84 =+ hed=$(fol -.fol)
85 ?: ?=($2 -.hed)
86 hed
87 =+ tal=$(fol +.fol)
88 ?- -.tal
89 $0 ?-(-.hed $0 [%0 p.hed p.tal], $1 hed)
90 $1 ?-(-.hed $0 tal, $1 [%1 (weld p.hed p.tal)])
91 $2 tal
92 ==
93 ?+ fol
94 [%2 tax]
95 ::
96 {$0 b/@}
97 ?: =(0 b.fol) [%2 tax]
98 ?: =(1 b.fol) [%0 sub]
99 ?: ?=(@ sub) [%2 tax]
100 =+ [now=(cap b.fol) lat=(mas b.fol)]
101 $(b.fol lat, sub ?:(=(2 now) -.sub +.sub))
102 ::
103 {$1 b/*}
104 [%0 b.fol]
105 ::
106 {$2 b/{^ *}}
107 =+ ben=$(fol b.fol)
108 ?. ?=($0 -.ben) ben
109 ?>(?=(^ p.ben) $(sub -.p.ben, fol +.p.ben))
110 ::?>(?=(^ p.ben) $([sub fol] p.ben)
111 ::
112 {$3 b/*}
113 =+ ben=$(fol b.fol)
114 ?. ?=($0 -.ben) ben
115 [%0 .?(p.ben)]
116 ::
117 {$4 b/*}
118 =+ ben=$(fol b.fol)
119 ?. ?=($0 -.ben) ben
120 ?. ?=(@ p.ben) [%2 tax]
121 [%0 .+(p.ben)]
122 ::
123 {$5 b/*}
124 =+ ben=$(fol b.fol)
125 ?. ?=($0 -.ben) ben
126 ?. ?=(^ p.ben) [%2 tax]
127 [%0 =(-.p.ben +.p.ben)]
128 ::
129 {$6 b/* c/* d/*}
130 $(fol =>(fol [2 [0 1] 2 [1 c d] [1 0] 2 [1 2 3] [1 0] 4 4 b]))
131 ::
132 {$7 b/* c/*} $(fol =>(fol [2 b 1 c]))
133 {$8 b/* c/*} $(fol =>(fol [7 [[0 1] b] c]))
134 {$9 b/* c/*} $(fol =>(fol [7 c 0 b]))
135 {$10 @ c/*} $(fol c.fol)
136 {$10 {b/* c/*} d/*}
137 =+ ben=$(fol c.fol)
138 ?. ?=($0 -.ben) ben
139 ?: ?=(?($hunk $hand $lose $mean $spot) b.fol)
140 $(fol d.fol, tax [[b.fol p.ben] tax])
141 $(fol d.fol)
142 ::
143 {$11 b/* c/*}
144 =+ ref=$(fol b.fol)
145 =+ ben=$(fol c.fol)
146 ?. ?=($0 -.ref) ref
147 ?. ?=($0 -.ben) ben
148 =+ val=(gul p.ref p.ben)
149 ?~(val [%1 p.ben ~] ?~(u.val [%2 [[%hunk (mush p.ben)] tax]] [%0 u.u.val]))
150 ==
151 ::
154Examples
155--------
157 > (mink [20 [4 0 1]] $~)
158 [%0 p=21]
159 > (mink [[90 5 3] [0 3]] $~)
160 [%0 p=[5 3]]
161 > (mink 20^[4 0 1] $~)
162 [%0 p=21]
163 > (mink [90 5 3]^[0 3] $~)
164 [%0 p=[5 3]]
165 > (mink [0]^[11 1 20] $~)
166 [%1 p=~[20]]
167 > (mink [0]^[11 1 20] |=(a=* `[40 a]))
168 [%0 p=[40 20]]
169 > (mink [5]^[0 2] $~)
170 [%2 p=~]
171 > (mink [5]^[10 yelp/[0 1] 0 0] $~)
172 [%2 p=~[[~.yelp 5]]]
175***
176### `++mock`
178Compute formula on subject with hint
180Produces a `++toon`, which is either a sucessful, blocked, or
181crashed result. If nock 11 is invoked, `sky` computes on the subject and
182produces a `++unit` result. An empty result becomes a `%1` `++tune`,
183indicating a block.
185Accepts
186-------
188`sub` is the subject as a noun.
190`fol` is the formula as a noun.
192`sky` is an %iron gate invoked with nock operator 11.
194Produces
195--------
197The `++unit` of a noun.
199Source
200------
202 ++ mock
203 |= {{sub/* fol/*} gul/$-({* *} (unit (unit)))}
204 (mook (mink [sub fol] gul))
205 ::
208Examples
209--------
211 > (mock [5 4 0 1] ,~)
212 [%0 p=6]
213 > (mock [~ 11 1 0] |=(* `999))
214 [%0 p=999]
215 > (mock [~ 0 1.337] ,~)
216 [%2 p=~]
217 > (mock [~ 11 1 1.337] ,~)
218 [%1 p=~[1.337]]
219 > (mock [[[4 4 4 4 0 3] 10] 11 9 2 0 1] |=(* `[+<]))
220 [%0 p=14]
221 > (mock [[[4 4 4 4 0 3] 10] 11 9 2 0 1] |=(* `[<+<>]))
222 [%0 p=[49 52 0]]
223 > ;;(tape +:(mock [[[4 4 4 4 0 3] 10] 11 9 2 0 1] |=(* `[<+<>])))
224 "14"
228***
229### `++mong`
231Slam gate with sample
233Produces a `++toon` computation result from slamming `gat` with
234`sam`, using `sky` to compute or block on nock 11 when applicable.
236Accepts
237-------
239`gat` is a noun that is generally a `gate`.
241`sam` is a `sample` noun.
243`sky` is an %iron gate invoked with nock operator 11.
245Produces
246--------
248A `++toon`.
250Source
251------
253 ++ mong
254 |= {{gat/* sam/*} gul/$-({* *} (unit (unit)))}
255 ^- toon
256 ?. &(?=(^ gat) ?=(^ +.gat))
257 [%2 ~]
258 (mock [[-.gat [sam +>.gat]] -.gat] gul)
259 ::
261Examples
262--------
264 > (mong [|=(@ 20) ~] ,~)
265 [%0 p=20]
266 > (mong [|=(@ !!) ~] ,~)
267 [%2 p=~]
268 > (mong [|=(a/@ (add 20 a)) ~] ,~)
269 [%0 p=20]
270 > (mong [|=(a/[@ @] (add 20 -.a)) ~] ,~)
271 [%2 p=~]
272 > (mong [|=(a/[@ @] (add 20 -.a)) [4 6]] ,~)
273 [%0 p=24]
274 > (mong [|=(a/@ .^(a)) ~] ,~)
275 [%1 p=~[0]]
276 > (mong [|=(a/@ .^(a)) ~] ,[~ %42])
277 [%0 p=42]
278 > (mong [|=(a/@ .^(a)) ~] |=(a/* [~ a 6]))
279 [%0 p=[0 6]]
280 > (mong [|=(a/@ .^(a)) 8] |=(a/* [~ a 6]))
281 [%0 p=[8 6]]
285***
286### `++mook`
288Intelligently render crash annotation
290Converts a `%2` `++tone` nock stack trace to a list of `++tank`.
291Each may be a tank, cord, `++spot`, or trapped tank.
293Accepts
294-------
296`ton` is a `++tone`.
298Produces
299--------
301A `++toon`.
303Source
304------
306 ++ mook
307 |= ton/tone
308 ^- toon
309 ?. ?=({$2 *} ton) ton
310 :- %2
311 :: =. p.ton (moop p.ton)
312 =+ yel=(lent p.ton)
313 =. p.ton
314 ?. (gth yel 256) p.ton
315 %+ weld
316 (scag 128 p.ton)
317 ^- (list {@ta *})
318 :_ (slag (sub yel 128) p.ton)
319 :- %lose
320 %+ rap 3
321 "[skipped {(scow %ud (sub yel 256))} frames]"
322 |- ^- (list tank)
323 ?~ p.ton ~
324 =+ rep=$(p.ton t.p.ton)
325 ?+ -.i.p.ton rep
326 $hunk [(tank +.i.p.ton) rep]
327 $lose [[%leaf (rip 3 (@ +.i.p.ton))] rep]
328 $hand [[%leaf (scow %p (mug +.i.p.ton))] rep]
329 $mean :_ rep
330 ?@ +.i.p.ton [%leaf (rip 3 (@ +.i.p.ton))]
331 =+ mac=(mack +.i.p.ton +<.i.p.ton)
332 ?~(mac [%leaf "####"] (tank u.mac))
333 $spot :_ rep
334 =+ sot=(spot +.i.p.ton)
335 :+ %rose [":" ~ ~]
336 :~ (smyt p.sot)
337 => [ud=|=(a/@u (scow %ud a)) q.sot]
338 leaf+"<[{(ud p.p)} {(ud q.p)}].[{(ud p.q)} {(ud q.q)}]>"
339 == ==
340 ::
342Examples
343--------
345 > (mook [%0 5 4 5 1])
346 [%0 p=[5 4 5 1]]
347 > (mook [%2 ~[[%hunk %rose ["<" "," ">"] ~[[%leaf "err"]]]]])
348 [%2 p=~[[%rose p=[p="<" q="," r=">"] q=[i=[%leaf p="err"] t=~]]]]
349 > (mook [%2 ~[[%malformed %elem] [%lose 'do print']]])
350 [%2 p=~[[%leaf p="do print"]]]
351 > (mook [%2 ~[[%mean |.(>(add 5 6)<)]]])
352 [%2 p=~[[%leaf p="11"]]]
353 > (mook [%2 ~[[%spot /b/repl [1 1]^[1 2]] [%mean |.(!!)]]])
354 [%2 p=~[[%leaf p="/b/repl/:<[1 1].[1 2]>"] [%leaf p="####"]]]
358***
359### `++mule`
361Typed virtual
363Kicks a `++trap`, producing its results or any errors that occur along
364the way. Used to lazily compute stack traces.
366Accepts
367-------
369`taq` is a `++trap`, generally producing a list of `++tank`s.
371Produces
372--------
374XX
376Source
377------
379 ++ mule :: typed virtual
380 ~/ %mule
381 |* taq/_|.(**)
382 =+ mud=(mute taq)
383 ?- -.mud
384 $& [%& p=$:taq] :: XX transition
385 $| [%| p=p.mud]
386 ==
387 ::
390Examples
391--------
393 > (mule |.(leaf/"hello"))
394 [%.y p=[%leaf "hello"]]
395 > (mule |.(!!))
396 [%.n p=~]
397 > (mule |.(.^(a//=pals/1)))
398 [ %.n
399 p
400 ~[
401 [ %rose
402 p=[p="/" q="/" r="/"]
403 q
404 [ i=[%leaf p="a"]
405 t=[i=[%leaf p="~zod"] t=[i=[%leaf p="pals"] t=[i=[%leaf p="1"] t=~]]]
406 ]
407 ]
408 ]
409 ]
413***
414### `++mute`
416Untyped virtual
418Kicks a `++trap`, producing its result as a noun or the tanks of any
419error that occurs. Similar to `++mule`, but preserves no type
420information.
422Accepts
423-------
425`taq` is a `++trap`.
426Produces
427--------
429Either a noun or a `++list` of `++tank`.
431Source
432------
434 ++ mute :: untyped virtual
435 |= taq/_^?(|.(**))
436 ^- (each * (list tank))
437 =+ ton=(mock [taq 9 2 0 1] |=({* *} ~))
438 ?- -.ton
439 $0 [%& p.ton]
440 $1 [%| (turn p.ton |=(a/* (smyt (path a))))]
441 $2 [%| p.ton]
442 ==
445Examples
446--------
448 > (mute |.(leaf/"hello"))
449 [%.y p=[1.717.658.988 104 101 108 108 111 0]]
450 > (mute |.(!!))
451 [%.n p=~]
454***