lmorg
commented
1 year ago Was there any specific ones you've missed? I ask because some of these exist already:
string collect [-a | --allow-empty] [-N | --no-trim-newlines] [STRING ...]
That's Murex's default behaviour
string escape [-n | --no-quoted] [--style=] [STRING ...] string unescape [--style=] [STRING ...]
» builtins -> regexp m/^!?esc/
[
"!escape",
"!eschtml",
"!escurl",
"escape",
"esccli",
"eschtml",
"escurl"
]Escaping are the ones without the bang prefix, whereas unescaping are the ones with the bang.
string join [-q | --quiet] [-n | --no-empty] SEP [STRING ...] string join0 [-q | --quiet] [STRING ...]
This doesn't currently exist but it's a good suggestion
string length [-q | --quiet] [STRING ...]
» %[one two three]
[
"one",
"two",
"three"
]
» %[one two three] -> count
3(There's also an alias len, for backwards compatibility with much older versions of Murex)
string lower [-q | --quiet] [STRING ...] string upper [-q | --quiet] [STRING ...]
These don't currently exist but it's a good suggestion.
string match [-a | --all] [-e | --entire] [-i | --ignore-case] [-g | --groups-only] [-r | --regex] [-n | --index] [-q | --quiet] [-v | --invert] PATTERN [STRING ...]
match: https://murex.rocks/docs/commands/match.htmlregexp: https://murex.rocks/docs/commands/regexp.html (with themorfflag)
string pad [-r | --right] [(-c | --char) CHAR] [(-w | --width) INTEGER] [STRING ...] string repeat [(-n | --count) COUNT] [(-m | --max) MAX] [-N | --no-newline] [-q | --quiet] [STRING ...]
These doesn't currently exist but they're a good suggestion too
string replace [-a | --all] [-f | --filter] [-i | --ignore-case] [-r | --regex] [-q | --quiet] PATTERN REPLACE [STRING ...]
regexp: https://murex.rocks/docs/commands/regexp.html (with thesflag)
string shorten [(-c | --char) CHARS] [(-m | --max) INTEGER] [-N | --no-newline] [-l | --left] [-q | --quiet] [STRING ...]
right kind of does this. It doesn't add the ellipsis nor check for wide characters though. Maybe there is a case for flag that would check character width instead of number of characters?
string split [(-f | --fields) FIELDS] [(-m | --max) MAX] [-n | --no-empty] [-q | --quiet] [-r | --right] SEP [STRING ...] string split0 [(-f | --fields) FIELDS] [(-m | --max) MAX] [-n | --no-empty] [-q | --quiet] [-r | --right] [STRING ...]
jsplit does this. It's not as feature rich as this but it supports regexp. Murex's type system also negates some of the need for manual splitting. Also regexp with the f flag could work here too.
string sub [(-s | --start) START] [(-e | --end) END] [(-l | --length) LENGTH] [-q | --quiet] [STRING ...]
left and right are supposed to solve this. However if you want something midway through a string then you have to pipe one into the other...which is a tad verbose :(
I had thought about creating another data-type called bytes which would basically be a byte array. That way you could index and range over the bytes with []. But it wasn't something I certain of implementing because it might lead some people to think it was a performant way of handling strings (like in C-like languages) whereas it could actually be a lot slower due to the way how Murex generally expects higher level abstracts. It's something to consider still though.
string trim [-l | --left] [-r | --right] [(-c | --chars) CHARS] [-q | --quiet] [STRING ...]
This doesn't exist verbatim but regexp 's/^\s+/' and regexp 's/\s+$/' would work in the meantime. I had given some thought in the past about when to trim things and when not to so it's a little weird I never thought to add this myself.
I also need to give some thought about how to make these builtins better discoverable and thus also how newer builtins should be named. At present there are dozens of commands in the root namespace and it's not obvious what is available (unlike Fish that has a string builtin with a lot of functionality grouped inside it)
orefalo
Describe the problem: Murex needs built-in string manipulation functions.
Why? Because no Unix system is the same, and having built-ins is not only fast and convenient but it also ensures compatibility.
Documentation: For reference, here are the sting primitives from
fishhttps://fishshell.com/docs/current/cmds/string.html