mirror of
https://github.com/yhirose/cpp-peglib.git
synced 2024-11-24 10:35:29 +00:00
Fix grammar, punctuation, and formatting in README.md (#313)
This commit is contained in:
parent
dedc8278d2
commit
b0cbfdc7f2
19
README.md
19
README.md
@ -5,7 +5,8 @@ cpp-peglib
|
||||
|
||||
C++17 header-only [PEG](http://en.wikipedia.org/wiki/Parsing_expression_grammar) (Parsing Expression Grammars) library. You can start using it right away just by including `peglib.h` in your project.
|
||||
|
||||
Since this library only supports C++17 compilers, please make sure that compiler the option `-std=c++17` is enabled. (`/std:c++17 /Zc:__cplusplus` for MSVC)
|
||||
Since this library only supports C++17 compilers, please make sure that the compiler option `-std=c++17` is enabled.
|
||||
(`/std:c++17 /Zc:__cplusplus` for MSVC)
|
||||
|
||||
You can also try the online version, PEG Playground at https://yhirose.github.io/cpp-peglib.
|
||||
|
||||
@ -34,7 +35,7 @@ The PEG syntax is well described on page 2 in the [document](http://www.brynosau
|
||||
* `label { error_message "..." }` (Error message instruction)
|
||||
* `{ no_ast_opt }` (No AST node optimization instruction)
|
||||
|
||||
'End of Input' check will be done as default. In order to disable the check, please call `disable_eoi_check`.
|
||||
'End of Input' check will be done as default. To disable the check, please call `disable_eoi_check`.
|
||||
|
||||
This library supports the linear-time parsing known as the [*Packrat*](http://pdos.csail.mit.edu/~baford/packrat/thesis/thesis.pdf) parsing.
|
||||
|
||||
@ -208,7 +209,7 @@ parser["ROOT"] = [&](const SemanticValues& vs) {
|
||||
auto ret = parser.parse(" item1, item2 ");
|
||||
```
|
||||
|
||||
The following grammar is same as the above.
|
||||
The following grammar is the same as the above.
|
||||
|
||||
```cpp
|
||||
peg::parser parser(R"(
|
||||
@ -356,7 +357,7 @@ parser["MONTH"] = [](const SemanticValues &vs) {
|
||||
};
|
||||
```
|
||||
|
||||
It supports the case insensitive mode.
|
||||
It supports the case-insensitive mode.
|
||||
|
||||
```peg
|
||||
START <- 'This month is ' MONTH '.'
|
||||
@ -366,7 +367,7 @@ MONTH <- 'Jan'i | 'January'i | 'Feb'i | 'February'i | '...'i
|
||||
Cut operator
|
||||
------------
|
||||
|
||||
`↑` operator could mitigate backtrack performance problem, but has a risk to change the meaning of grammar.
|
||||
`↑` operator could mitigate the backtrack performance problem, but has a risk to change the meaning of grammar.
|
||||
|
||||
```peg
|
||||
S <- '(' ↑ P ')' / '"' ↑ P '"' / P
|
||||
@ -479,7 +480,7 @@ if (parser.parse("...", ast)) {
|
||||
}
|
||||
```
|
||||
|
||||
`optimize_ast` removes redundant nodes to make a AST simpler. If you want to disable this behavior from particular rules, `no_ast_opt` instruction can be used.
|
||||
`optimize_ast` removes redundant nodes to make an AST simpler. If you want to disable this behavior from particular rules, `no_ast_opt` instruction can be used.
|
||||
|
||||
It internally calls `peg::AstOptimizer` to do the job. You can make your own AST optimizers to fit your needs.
|
||||
|
||||
@ -509,7 +510,7 @@ auto ret = ROOT.parse(" [tag1] [tag:2] [tag-3] ");
|
||||
The following are available operators:
|
||||
|
||||
| Operator | Description | Operator | Description |
|
||||
| :------- | :------------------------------ | :------- | :------------------- |
|
||||
|:---------|:--------------------------------|:---------|:--------------------|
|
||||
| seq | Sequence | cho | Prioritized Choice |
|
||||
| zom | Zero or More | oom | One or More |
|
||||
| opt | Optional | apd | And predicate |
|
||||
@ -599,7 +600,7 @@ stmtb ← (!(Stmt / 'else' / '}') .)* { error_message "invalid statement"
|
||||
condw ← &'==' ('==' RelExp)* / &'<' ('<' AddExp)* / (!')' .)*
|
||||
```
|
||||
|
||||
For instance, `';'^semi` is a syntactic sugar for `(';' / %recovery(semi))`. `%recover` operator tries to recover the error at ';' by skipping input text with the recovery expression `semi`. Also `semi` is associated with a custom message "missing semicolon in assignment.".
|
||||
For instance, `';'^semi` is a syntactic sugar for `(';' / %recovery(semi))`. `%recover` operator tries to recover the error at ';' by skipping input text with the recovery expression `semi`. Also `semi` is associated with a custom message "missing semicolon in assignment."
|
||||
|
||||
Here is the result:
|
||||
|
||||
@ -644,7 +645,7 @@ CODE <- < '0x' [a-fA-F0-9]+ > { error_message 'code format error...' }
|
||||
custom_message.txt:1:8: code format error...
|
||||
```
|
||||
|
||||
NOTE: If there are more than one elements with error message instruction in a prioritized choice, this feature may not work as you expect.
|
||||
NOTE: If there is more than one element with an error message instruction in a prioritized choice, this feature may not work as you expect.
|
||||
|
||||
Change the Start Definition Rule
|
||||
--------------------------------
|
||||
|
Loading…
Reference in New Issue
Block a user