mirror of
https://github.com/nushell/nushell.git
synced 2025-05-22 15:45:35 +00:00
cd058db046
Adds new substr function to str plugin with tests and documentation Function takes a start/end location as a string in the form "##,##", both sides of comma are optional, and behaves like Rust's own index operator [##..##].
51 lines
3.8 KiB
Markdown
51 lines
3.8 KiB
Markdown
# str
|
|
|
|
Consumes either a single value or a table and converts the provided data to a string and optionally applies a change.
|
|
|
|
## Examples
|
|
|
|
```shell
|
|
> shells
|
|
━━━┯━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
# │ │ name │ path
|
|
───┼───┼────────────┼────────────────────────────────
|
|
0 │ X │ filesystem │ /home/TUX/stuff/expr/stuff
|
|
1 │ │ filesystem │ /
|
|
━━━┷━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
> shells | str path --upcase
|
|
━━━┯━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
# │ │ name │ path
|
|
───┼───┼────────────┼────────────────────────────────
|
|
0 │ X │ filesystem │ /HOME/TUX/STUFF/EXPR/STUFF
|
|
1 │ │ filesystem │ /
|
|
━━━┷━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
> shells | str path --downcase
|
|
━━━┯━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
# │ │ name │ path
|
|
───┼───┼────────────┼────────────────────────────────
|
|
0 │ X │ filesystem │ /home/tux/stuff/expr/stuff
|
|
1 │ │ filesystem │ /
|
|
━━━┷━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
> shells | str # --to-int
|
|
━━━┯━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
# │ │ name │ path
|
|
───┼───┼────────────┼────────────────────────────────
|
|
0 │ X │ filesystem │ /home/TUX/stuff/expr/stuff
|
|
1 │ │ filesystem │ /
|
|
━━━┷━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
> shells | str # --substring "21, 99"
|
|
━━━┯━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
# │ │ name │ path
|
|
───┼───┼────────────┼────────────────────────────────
|
|
0 │ X │ filesystem │ stuff
|
|
1 │ │ filesystem │
|
|
━━━┷━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
> shells | str # --substring "6,"
|
|
━━━┯━━━┯━━━━━━━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
# │ │ name │ path
|
|
───┼───┼────────────┼────────────────────────────────
|
|
0 │ X │ filesystem │ TUX/stuff/expr/stuff
|
|
1 │ │ filesystem │
|
|
━━━┷━━━┷━━━━━━━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
```
|