aboutsummaryrefslogtreecommitdiff
path: root/string_manipulation.md
diff options
context:
space:
mode:
Diffstat (limited to 'string_manipulation.md')
-rw-r--r--string_manipulation.md104
1 files changed, 0 insertions, 104 deletions
diff --git a/string_manipulation.md b/string_manipulation.md
deleted file mode 100644
index ca7b3ed..0000000
--- a/string_manipulation.md
+++ /dev/null
@@ -1,104 +0,0 @@
-# Bash string manipulation cheatsheet
-# https://gist.github.com/magnetikonline/90d6fe30fc247ef110a1
-
-<table>
- <tr>
- <th align="left" colspan="2">Assignment</th>
- </tr>
- <tr>
- <td>Assign <code>value</code> to <code>variable</code> if <code>variable</code> is not already set, <code>value</code> is returned.<br /><br />Combine with a <code>:</code> no-op to discard/ignore return <code>value</code>.</td>
- <td><code>${variable="value"}</code><br /><code>: ${variable="value"}</code></td>
- </tr>
- <tr>
- <th align="left" colspan="2">Removal</th>
- </tr>
- <tr>
- <td>Delete shortest match of <code>needle</code> from front of <code>haystack</code>.</td>
- <td><code>${haystack#needle}</code></td>
- </tr>
- <tr>
- <td>Delete longest match of <code>needle</code> from front of <code>haystack</code>.</td>
- <td><code>${haystack##needle}</code></td>
- </tr>
- <tr>
- <td>Delete shortest match of <code>needle</code> from back of <code>haystack</code>.</td>
- <td><code>${haystack%needle}</code></td>
- </tr>
- <tr>
- <td>Delete longest match of <code>needle</code> from back of <code>haystack</code>.</td>
- <td><code>${haystack%%needle}</code></td>
- </tr>
- <tr>
- <th align="left" colspan="2">Replacement</th>
- </tr>
- <tr>
- <td>Replace first match of <code>needle</code> with <code>replacement</code> from <code>haystack</code>.</td>
- <td><code>${haystack/needle/replacement}</code></td>
- </tr>
- <tr>
- <td>Replace all matches of <code>needle</code> with <code>replacement</code> from <code>haystack</code>.</td>
- <td><code>${haystack//needle/replacement}</code></td>
- </tr>
- <tr>
- <td>If <code>needle</code> matches front of <code>haystack</code> replace with <code>replacement</code>.</td>
- <td><code>${haystack/#needle/replacement}</code></td>
- </tr>
- <tr>
- <td>If <code>needle</code> matches back of <code>haystack</code> replace with <code>replacement</code>.</td>
- <td><code>${haystack/%needle/replacement}</code></td>
- </tr>
- <tr>
- <th align="left" colspan="2">Substitution</th>
- </tr>
- <tr>
- <td>If <code>variable</code> not set, return <code>value</code>, else <code>variable</code>.</td>
- <td><code>${variable-value}</code></td>
- </tr>
- <tr>
- <td>If <code>variable</code> not set <em>or</em> empty, return <code>value</code>, else <code>variable</code>.</td>
- <td><code>${variable:-value}</code></td>
- </tr>
- <tr>
- <td>If <code>variable</code> set, return <code>value</code>, else null string.</td>
- <td><code>${variable+value}</code></td>
- </tr>
- <tr>
- <td>If <code>variable</code> set <em>and</em> not empty, return <code>value</code>, else null string.</td>
- <td><code>${variable:+value}</code></td>
- </tr>
- <tr>
- <th align="left" colspan="2">Extraction</th>
- </tr>
- <tr>
- <td>Extract <code>length</code> characters from <code>variable</code> starting at <code>position</code>.</td>
- <td><code>${variable:position:length}</code></td>
- </tr>
- <tr>
- <td>Return string length of <code>variable</code>.</td>
- <td><code>${#variable}</code></td>
- </tr>
- <tr>
- <th align="left" colspan="2">Escaping</th>
- </tr>
- <tr>
- <td>Single quotes inside a single quoted string.</td>
- <td><code>echo 'Don'\''t break my escape!'</code></td>
- </tr>
- <tr>
- <th align="left" colspan="2">Indirection</th>
- </tr>
- <tr>
- <td>Return value of variable name held in <code>indirect</code>, else <code>value</code>.</td>
- <td><code>indirect="apple"</code><br /><code>apple="fruit"</code><br /><code>${!indirect-value}</code></td>
- </tr>
-</table>
-
-## Reference
-
-- https://tldp.org/LDP/abs/html/string-manipulation.html
-- https://tldp.org/LDP/abs/html/parameter-substitution.html
-- https://tldp.org/LDP/abs/html/ivr.html
-- Special characters:
- - `*`: https://www.tldp.org/LDP/abs/html/special-chars.html#ASTERISKREF
- - `?`: https://www.tldp.org/LDP/abs/html/special-chars.html#WILDCARDQU
-- https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_06_02