slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

;doc:csv:if: edits

Browse Source
This commit is contained in:
Simon Michael 2024-12-03 16:41:54 -10:00
parent 4708065fb4
commit f73888d3b6
1 changed files with 7 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
hledger/hledger.m4.md
View File

@ -3658,16 +3658,18 @@ if ,,,,
There are two kinds of matcher:
1. A whole record matcher is simplest: it is just a word, single-line text fragment, or other regular expression,
which hledger will try to match case-insensitively anywhere within the CSV record. Eg: `whole foods`.
which hledger will try to match case-insensitively anywhere within the CSV record.\
Eg: `whole foods`.
2. A field matcher has a percent-prefixed CSV field number or name before the pattern.
Eg: `%3 whole foods` or `%description whole foods`.
2. A field matcher has a percent-prefixed CSV field number or name before the pattern.\
Eg: `%3 whole foods` or `%description whole foods`.\
hledger will try to match the pattern just within the named CSV field.
When using these, there's two things to be aware of:
1. Whole record matchers see a synthetic reconstruction or record, not the original data;
values will be comma-separated, and quotes enclosing values and whitespace outside those quotes will be removed.\
1. Whole record matchers don't see the exact original record;
they see a reconstruction of it, in which values are comma-separated,
and quotes enclosing values and whitespace outside those quotes are removed.\
Eg when reading an SSV record like: `2023-01-01 ; "Acme, Inc. " ; 1,000`\
the whole record matcher sees instead: `2023-01-01,Acme, Inc. ,1,000`