README: add notes in --ignore-extras
This commit is contained in:
parent
c3188ae353
commit
9d97a50e6e
1 changed files with 46 additions and 1 deletions
47
README.md
47
README.md
|
@ -42,6 +42,8 @@ line 4
|
||||||
|
|
||||||
### Skip until a number of matching lines
|
### Skip until a number of matching lines
|
||||||
|
|
||||||
|
The whole line must match.
|
||||||
|
|
||||||
This example reads the named file.
|
This example reads the named file.
|
||||||
|
|
||||||
File: `input.txt`
|
File: `input.txt`
|
||||||
|
@ -67,7 +69,9 @@ gamma
|
||||||
alpha
|
alpha
|
||||||
```
|
```
|
||||||
|
|
||||||
### Skip lines until a number of tokens as seen
|
### Skip lines until a number of tokens are seen
|
||||||
|
|
||||||
|
Looks for a string within a line, counting each occurance.
|
||||||
|
|
||||||
This example reads the file from stdin.
|
This example reads the file from stdin.
|
||||||
|
|
||||||
|
@ -99,3 +103,44 @@ commodo consequat.
|
||||||
|
|
||||||
It matches the first `dolor` on line 1,
|
It matches the first `dolor` on line 1,
|
||||||
and the second on line 4 as part of the word `dolore`.
|
and the second on line 4 as part of the word `dolore`.
|
||||||
|
|
||||||
|
### Skip lines until a lines with tokens are seen
|
||||||
|
|
||||||
|
Looks for a string within a line, only counting each matching line once.
|
||||||
|
|
||||||
|
This example reads the file from stdin.
|
||||||
|
|
||||||
|
File: `input.txt`
|
||||||
|
|
||||||
|
```text
|
||||||
|
Lorem ipsum dolor sit amet,
|
||||||
|
consectetur adipiscing elit,
|
||||||
|
sed do eiusmod tempor incididunt
|
||||||
|
ut labore et dolore magna aliqua.
|
||||||
|
Ut enim ad minim veniam,
|
||||||
|
quis nostrud exercitation ullamco
|
||||||
|
laboris nisi ut aliquip ex ea
|
||||||
|
commodo consequat.
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cat input.txt | skip 4 --token m --ignore-extras
|
||||||
|
```
|
||||||
|
|
||||||
|
Will output:
|
||||||
|
|
||||||
|
```text
|
||||||
|
quis nostrud exercitation ullamco
|
||||||
|
laboris nisi ut aliquip ex ea
|
||||||
|
commodo consequat.
|
||||||
|
```
|
||||||
|
|
||||||
|
Without `--ignore-extras`, it would have found the fourth `m` on line 3, and displayed:
|
||||||
|
|
||||||
|
```text
|
||||||
|
ut labore et dolore magna aliqua.
|
||||||
|
Ut enim ad minim veniam,
|
||||||
|
quis nostrud exercitation ullamco
|
||||||
|
laboris nisi ut aliquip ex ea
|
||||||
|
commodo consequat.
|
||||||
|
```
|
||||||
|
|
Loading…
Reference in a new issue