From 2afb23928e1984d475cc460e1672e8f6fa0e4dbe Mon Sep 17 00:00:00 2001 From: Marshall Lochbaum Date: Wed, 11 Aug 2021 17:21:31 -0400 Subject: Allow clicking on header to get fragment link --- docs/doc/join.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/doc/join.html') diff --git a/docs/doc/join.html b/docs/doc/join.html index 414f19b0..220c6631 100644 --- a/docs/doc/join.html +++ b/docs/doc/join.html @@ -4,9 +4,9 @@ BQN: Join and Join To
(github) / BQN / doc
-

Join and Join To

+

Join and Join To

The glyph ∾ combines arrays along an existing axis, a concept that other languages might call "concatenation" or "catenation" but BQN names "Join". The one-argument form Join and two-argument form Join To are parallel to the functions that combine arrays along a new axis, Merge (>) and Couple (≍).

-

Join To

+

Join To

Join To connects its two arguments together, for example to join two strings:

↗️
    "abcd" ∾ "EFG"
 "abcdEFG"
@@ -50,7 +50,7 @@
 ⟨ 3 'c' ⟩

This case is unusual because the rank of the result is higher than that of either argument. It's also identical to Couple (≍); Couple should be preferred because it doesn't require a special case for this situation. See coupling units.

-

Join

+

Join

The monadic form of ∾, called simply Join, is more complicated than Join To because it really takes not just one argument but an entire array of them. Join is an extension of the monadic function Raze from A+ and J to arbitrary argument ranks. It has the same relationship to Join to, the dyadic function sharing the same glyph, as Merge (>) does to Couple (≍): a≍b is >a‿b and a∾b is ∾a‿b. While Merge and Couple combine arrays (the elements of Merge's argument, or the arguments themselves for Couple) along a new leading axis, Join and Join to combine them along the existing leading axis. Both Merge and Join can also be called on a higher-rank array, causing Merge to add multiple leading axes while Join combines elements along multiple existing axes.

Join can be used to combine several strings into a single string, like array.join() in Javascript (but it doesn't force the result to be a string).

↗️
    ∾"time"‿"to"‿"join"‿"some"‿"words"
-- 
cgit v1.2.3