From 0bead8c47e7c3c2d76b54f29f7cbb278de2c623c Mon Sep 17 00:00:00 2001
From: Philip Wittamore <philip@wittamore.com>
Date: Sun, 18 May 2025 09:43:01 +0200
Subject: update

---
 STRINGS.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 STRINGS.md

diff --git a/STRINGS.md b/STRINGS.md
new file mode 100644
index 0000000..464f887
--- /dev/null
+++ b/STRINGS.md
@@ -0,0 +1,30 @@
+# Bash string manipulation cheatsheet 
+
+[https://gist.github.com/magnetikonline/90d6fe30fc247ef110a1](https://gist.github.com/magnetikonline/90d6fe30fc247ef110a1)
+
+| **Assignment** |     |
+| :--- | :--- |
+| Assign `value` to `variable` if `variable` is not already set, `value` is returned.  <br>  <br>Combine with a `:` no-op to discard/ignore return `value`. | `${variable="value"}`  <br>`: ${variable="value"}` |
+| **Removal** |     |
+| Delete shortest match of `needle` from front of `haystack`. | `${haystack#needle}` |
+| Delete longest match of `needle` from front of `haystack`. | `${haystack##needle}` |
+| Delete shortest match of `needle` from back of `haystack`. | `${haystack%needle}` |
+| Delete longest match of `needle` from back of `haystack`. | `${haystack%%needle}` |
+| **Replacement** |     |
+| Replace first match of `needle` with `replacement` from `haystack`. | `${haystack/needle/replacement}` |
+| Replace all matches of `needle` with `replacement` from `haystack`. | `${haystack//needle/replacement}` |
+| If `needle` matches front of `haystack` replace with `replacement`. | `${haystack/#needle/replacement}` |
+| If `needle` matches back of `haystack` replace with `replacement`. | `${haystack/%needle/replacement}` |
+| **Substitution** |     |
+| If `variable` not set, return `value`, else `variable`. | `${variable-value}` |
+| If `variable` not set _or_ empty, return `value`, else `variable`. | `${variable:-value}` |
+| If `variable` set, return `value`, else null string. | `${variable+value}` |
+| If `variable` set _and_ not empty, return `value`, else null string. | `${variable:+value}` |
+| **Extraction** |     |
+| Extract `length` characters from `variable` starting at `position`. | `${variable:position:length}` |
+| Return string length of `variable`. | `${#variable}` |
+| **Escaping** |     |
+| Single quotes inside a single quoted string. | `echo 'Don'\''t break my escape!'` |
+| **Indirection** |     |
+| Return value of variable name held in `indirect`, else `value`. | `indirect="apple"`  <br>`apple="fruit"`  <br>`${!indirect-value}` |
+
-- 
cgit v1.2.3