diff options
Diffstat (limited to 'man/man1/strjoin.1')
| -rw-r--r-- | man/man1/strjoin.1 | 43 |
1 files changed, 26 insertions, 17 deletions
diff --git a/man/man1/strjoin.1 b/man/man1/strjoin.1 index dd32f46..2e01e33 100644 --- a/man/man1/strjoin.1 +++ b/man/man1/strjoin.1 @@ -12,29 +12,38 @@ strjoin \- join words with a word is the command line equivalent of .BR python (1)'s .B str.join(...) -and java (1)'s +and +.BR java (1)'s .BR Stream<String>.collect(Collectors.joining(...)) . -It is practically identical to -.B IFS=,;echo "$*" +For most purposes, +it is functionally almost identical to +.RS +.B strjoin(){ declare IFS=$1;shift;echo \(dq$*\(dq;} +.RE in .BR bash (1), -without having to set and reset the -.I IFS -variable. - +except the separator can be more than one character, +and also, lines to be joined can be read from +.BR stdin (3), +similar to +.BR paste (1)\ \-s , +except that with +.BR strjoin , +the separator can be more than one character. +.P The first parameter is the separator that goes between the words. All other parameters are the words. (They don't have to be single words, but they are treated as such.) -This is useful for constructing paths, -like for example -.BR java (1) -classpaths for -.BR jar (1) -manifest files, -but also tab-separated value records, -and tons of other things. - .SH EXAMPLES -.B strjoin , foo bar baz +.TP +.B strjoin\ ++\ foo\ bar\ baz +Prints \(lqfoo++bar++baz\(rq. +.TP +.BR printf\ \(aq%s\en\(aq\ foo\ bar\ baz\ |\ strjoin\ -- +Prints \(lqfoo--bar--baz\(rq, reading the words from stdin. +Useful for making lists of file names, for example. + +.SH SEE ALSO +.BR paste (1),\ tr (1) |