adf3d95 · urbit.org · git.iko.soy

docs/system/hoon/library/src/2q/mold/char.md+3−3

compare with master

unifiedsplit

@@ -2,14 +2,14 @@

2

3Char

4

5−A single character. [odor]() [`@tD`]() designates a single unicode byte. All

5+A single character. odor `@tD` designates a single unicode byte. All

6−parsers consume [`++tape`]()s, which are lists of `++char`.

6+parsers consume `++tape`s, which are lists of `++char`.

7

8

9Source

10------

11

12− ++ char ,@tD :: UTF-8 byte

12+ ++ char @tD :: UTF-8 byte

13

14Examples

15--------

docs/system/hoon/library/src/2q/mold/cord.md+4−4

@@ -2,19 +2,19 @@

2

3UTF-8 text

4

5−One of Hoon's two string types (the other being [`++tape`]()). A cord is an

5+One of Hoon's two string types (the other being `++tape`). A cord is an

6−atom of UTF-8 text. [`++trip`]() and [`++crip`]() convert between cord and

6+atom of UTF-8 text. `++trip` and `++crip` convert between cord and

7`++tape`.

8

9Source

10------

11

12− ++ cord ,@t :: text atom (UTF-8)

12+ ++ cord @t :: text atom (UTF-8)

13

14Examples

15--------

16

17−Odor [`@t`]() designates a Unicode atom, little-endian: the first character

17+Odor `@t` designates a Unicode atom, little-endian: the first character

18in the text is the low byte.

19

20 ~zod/try=> `@ux`'foobar'

docs/system/hoon/library/src/2q/mold/date.md+4−3

@@ -3,17 +3,18 @@

3Point in time

4

5A boolean designating AD or BC, a year atom, a month

6−atom, and a [`++tarp`](), which is a day atom and a time.

6+atom, and a `++tarp`, which is a day atom and a time.

7

8Source

9------

10

11− ++ date ,[[a=? y=@ud] m=@ud t=tarp] :: parsed date

11+ ++ date {{a/? y/@ud} m/@ud t/tarp} :: parsed date

12+

12

13

13Examples

14Examples

14--------

15--------

15

16

16−See also: [`++year`](), [`++yore`]() [`++stud`](), [`++dust`]()

17+See also: `++year`, `++yore` `++stud`, `++dust`

17

18

18 ~zod/try=> `date`(yore ~2014.6.6..21.09.15..0a16)

19 ~zod/try=> `date`(yore ~2014.6.6..21.09.15..0a16)

19 [[a=%.y y=2.014] m=6 t=[d=6 h=21 m=9 s=15 f=~[0xa16]]]

20 [[a=%.y y=2.014] m=6 t=[d=6 h=21 m=9 s=15 f=~[0xa16]]]

docs/system/hoon/library/src/2q/mold/tank.md+8−8

@@ -10,16 +10,16 @@ list of `++tank` delimted by the strings in `p`.

10Source

11------

12

13− ++ tank $% [%leaf p=tape] :: printing formats

13+ ++ tank $% {$leaf p/tape} :: printing formats

14− $: %palm :: backstep list

14+ $: $palm :: backstep list

15− p=[p=tape q=tape r=tape s=tape] ::

15+ p/{p/tape q/tape r/tape s/tape} ::

16− q=(list tank) ::

16+ q/(list tank) ::

17 == ::

18− $: %rose :: flat list

18+ $: $rose :: flat list

19− p=[p=tape q=tape r=tape] :: mid open close

19+ p/{p/tape q/tape r/tape} :: mid open close

20− q=(list tank) ::

20+ q/(list tank) ::

21 == ::

22− ==

22+ == ::

23

24Examples

25--------

docs/system/hoon/library/src/2q/mold/tape.md+1−1

@@ -3,7 +3,7 @@

3

4List of chars

5

6−One of Hoon's two string types, the other being [`++cord`](). A tape is a

6+One of Hoon's two string types, the other being `++cord`. A tape is a

7list of chars.

8

9Source

docs/system/hoon/library/src/2q/mold/tarp.md+4−4

@@ -2,18 +2,18 @@

2

3Day through second

4

5−The remaining part of a [`++date`](): day, hour, minute, second and a list

5+The remaining part of a `++date`: day, hour, minute, second and a list

6−of [`@ux`]() for precision.

6+of `@ux` for precision.

7

8Source

9------

10

11− @ud h=@ud m=@ud s=@ud f=(list ,@ux)] :: parsed time

11+ ++ tarp {d/@ud h/@ud m/@ud s/@ud f/(list @ux)} :: parsed time

12+

12

13

13Examples

14Examples

14--------

15--------

15

16

16−See also: [`++date`](), [`++yell`[]()/`++yule`]()

17

18 ~zod/try=> -<-

19 ~2014.9.20..00.43.33..b52a

docs/system/hoon/library/src/2q/mold/term.md+3−3

@@ -4,15 +4,15 @@ Hoon constants

4

5A restricted text atom for Hoon constants. The only characters permitted are

6lowercase ASCII, `-`, and `0-9`, the latter two of which can neither be the first or last

7−character. The syntax for [`@tas`]() is the text itself, always preceded by `%`.

7+character. The syntax for `@tas` is the text itself, always preceded by `%`.

8−This means a term is always [cubical](). The empty `@tas` has a special syntax,

8+This means a term is always cubical. The empty `@tas` has a special syntax,

9`$`.

10

11

12Source

13------

14

15− ++ term ,@tas :: Hoon ASCII subset

15+ ++ term @tas :: Hoon ASCII subset

16

17Examples

18--------

docs/system/hoon/library/src/2q/mold/wain.md+2−22

@@ -2,33 +2,13 @@

2

3 ++ wain (list cord) :: text lines (no \n)

4

5−A list of lines. A `++wain` is used instead of a single [`++cord`]() with

5+A list of lines. A `++wain` is used instead of a single `++cord` with

6`\n`.

7

8−See also: [`++lore`](), [`++role`]()

8+See also: `++lore`, `++role`

9

10 ~zod/try=> `wain`/som/del/rok

11 <|som del rok|>

12− ~zod/try=> `wain`(lore ^:@t/=main=/bin/tree/hoon)

13− <|

14− !:

15− :: /===/bin/tree/hoon

16− |= ^

17− |= [pax=path fla=$|(~ [%full ~])]

18− =- ~[te/-]~

19− =+ len=(lent pax)

20− =+ rend=?~(fla |=(a=path +:(spud (slag len a))) spud)

21− |- ^- wain

22− =+ ark=;;(arch .^(cy/pax))

23− =- ?~ q.ark -

24− [(crip (rend pax)) -]

25− %- zing

26− %- turn :_ |=(a=@t ^$(pax (weld pax `path`/[a])))

27− %- sort :_ aor

28− %- turn :_ |=([a=@t ~] a)

29− (~(tap by r.ark))

30− |>

31−

32

12

33

13

34***

14***

docs/system/hoon/library/src/2q/mold/wall.md+5−11

@@ -3,7 +3,7 @@

3List of lines

4

5

6−A `++wall` is used instead of a single [`++tape`]() with

6+A `++wall` is used instead of a single `++tape` with

7`\n`.

8

9Source

@@ -14,20 +14,14 @@ Source

14Examples

15--------

16

17−See also: [`++wash`]()

17+See also: `++wash`

18

19− ~zod/try=> `wall`(wash [0 20] leaf/<(bex 256)>)

19+ ~zod/try=> `wall`(wash [0 20] leaf+<(bex 256)>)

20 <<

21− "\/115.792.089.237.\/"

21+ "115.792.089.237.316.195.423.570.985.008.687.907.853.269.984.665.640.564.039.457.584.007.913.129.639.936"

22− " 316.195.423.570."

23− " 985.008.687.907."

24− " 853.269.984.665."

25− " 640.564.039.457."

26− " 584.007.913.129."

27− " 639.936"

28− "\/ \/"

29 >>

22 >>

30

23

31

24

32

25

26+

33***

27***