git.iko.soy/urbit.org
on master help sign in
Merge pull request #613 from pkova/master

Add documentation for ++join

commitf7b725a24fb40022d778d1248fc37cfdfed94702 authorrmariani <robert@tlon.io> dateMon 12 Aug 2019, 11:01 (7 years ago) parentb47906257c691c
2 files changed+42−1
compare with master
unifiedsplit
reference/library/2b.md+39 reference/library/_index.md+3−1
reference/library/2b.md+39
@@ -236,6 +236,45 @@ a `list`.
236236 ~[1 2 3]
237237```
238238
239+---
240+
241+### `++join`
242+
243+Constructs a new `list`, placing `sep` between every element of `lit`.
244+
245+#### Accepts
246+
247+`sep` is a `noun`.
248+
249+`lit` is a `list`.
250+
251+#### Produces
252+
253+a `list`.
254+
255+#### Source
256+
257+```
258+ ++ join
259+ |* [sep=* lit=(list)]
260+ =. sep `_?>(?=(^ lit) i.lit)`sep
261+ ?~ lit ~
262+ =| out=(list _?>(?=(^ lit) i.lit))
263+ |- ^+ out
264+ ?~ t.lit
265+ (flop [i.lit out])
266+ $(out [sep i.lit out], lit t.lit)
267+```
268+
269+#### Examples
270+
271+```
272+ > (join ' ' "hoon")
273+ "h o o n"
274+
275+ > (join 0 `(list @)`~[1 2 3])
276+ ~[1 0 2 0 3]
277+```
239278
240279---
241280### `++lent`
reference/library/_index.md+3−1
@@ -121,7 +121,7 @@ Can be navigated [alphabetically](#alphabetical) or [by section](#by-section).
121121<a class="tooltip" href='/docs/reference/library/2i/#del-by' title="Delete (map)"><code>+-del:by</code></a>
122122<a class="tooltip" href='/docs/reference/library/2h/#del-in' title="Delete (set)"><code>+-del:in</code></a>
123123<a class="tooltip" href='/docs/reference/library/2j/#del-ju' title="Delete (jug)"><code>+-del:ju</code></a>
124− <a class="tooltip" href='/docs/reference/library/4i/#dem' title="Decimal to atom"><code>++dem</code></a>
124+<a class="tooltip" href='/docs/reference/library/4i/#dem' title="Decimal to atom"><code>++dem</code></a>
125125<a class="tooltip" href='/docs/reference/library/4j/#dem-ag' title="Parse decmal with dots"><code>++dem:ag</code></a>
126126<a class="tooltip" href='/docs/reference/library/3b/#den-fl' title="Denormalizes (floating point)"><code>++den:fl</code></a>
127127<a class="tooltip" href='/docs/reference/library/2i/#dep-by' title="Difference as patch (map)"><code>+-dep:by</code></a>
@@ -304,6 +304,7 @@ Can be navigated [alphabetically](#alphabetical) or [by section](#by-section).
304304<a class="tooltip" href='/docs/reference/library/2o/#jar' title="Mold generator (jar)"><code>++jar</code></a>
305305<a class="tooltip" href='/docs/reference/library/3c/#jes-yo' title="Maximum 64-bit timestamp"><code>++jes:yo</code></a>
306306<a class="tooltip" href='/docs/reference/library/4f/#jest' title="Match a cord"><code>++jest</code></a>
307+<a class="tooltip" href='/docs/reference/library/2b/#join' title="Add separator between list elements"><code>++join</code></a>
307308<a class="tooltip" href='/docs/reference/library/2j/#ju' title="Jug operations"><code>++ju</code></a>
308309<a class="tooltip" href='/docs/reference/library/2o/#jug' title="Mold generator (jug)"><code>++jug</code></a>
309310<a class="tooltip" href='/docs/reference/library/4f/#just' title="Match a single character"><code>++just</code></a>
@@ -867,6 +868,7 @@ Can be navigated [alphabetically](#alphabetical) or [by section](#by-section).
867868<a class="tooltip" href='/docs/reference/library/2b/#flop' title="Reverse list"><code>++flop</code></a>
868869<a class="tooltip" href='/docs/reference/library/2b/#gulf' title="List from range"><code>++gulf</code></a>
869870<a class="tooltip" href='/docs/reference/library/2b/#homo' title="Homogenize list"><code>++homo</code></a>
871+<a class="tooltip" href='/docs/reference/library/2b/#join' title="Add separator between list elements"><code>++join</code></a>
870872<a class="tooltip" href='/docs/reference/library/2b/#lent' title="List length"><code>++lent</code></a>
871873<a class="tooltip" href='/docs/reference/library/2b/#levy' title="Logical AND on list"><code>++levy</code></a>
872874<a class="tooltip" href='/docs/reference/library/2b/#lien' title="Logical OR on list"><code>++lien</code></a>