yq/pkg/yqlib/doc/headers/string-operators.md

45 lines
969 B
Markdown
Raw Normal View History

2021-01-14 04:05:50 +00:00
# String Operators
2021-07-09 05:33:41 +00:00
## RegEx
This uses golangs native regex functions under the hood - See https://github.com/google/re2/wiki/Syntax for the supported syntax.
2021-08-01 08:47:04 +00:00
2021-11-03 04:00:58 +00:00
## String blocks, bash and newlines
2021-08-01 08:47:04 +00:00
Bash is notorious for chomping on precious trailing newline characters, making it tricky to set strings with newlines properly. In particular, the `$( exp )` _will trim trailing newlines_.
For instance to get this yaml:
```
a: |
cat
```
Using `$( exp )` wont work, as it will trim the trailing new line.
```
m=$(echo "cat\n") yq e -n '.a = strenv(m)'
a: cat
```
However, using printf works:
```
printf -v m "cat\n" ; m="$m" yq e -n '.a = strenv(m)'
a: |
cat
```
As well as having multiline expressions:
```
m="cat
" yq e -n '.a = strenv(m)'
a: |
cat
```
Similarly, if you're trying to set the content from a file, and want a trailing new line:
```
IFS= read -rd '' output < <(cat my_file)
output=$output ./yq e '.data.values = strenv(output)' first.yml
2021-11-03 04:00:58 +00:00
```