diff options
Diffstat (limited to 'doc')
| -rwxr-xr-x | doc/grammar.txt | 7 | ||||
| -rwxr-xr-x | doc/manual.txt | 23 |
2 files changed, 22 insertions, 8 deletions
diff --git a/doc/grammar.txt b/doc/grammar.txt index a648913a0..c84caec49 100755 --- a/doc/grammar.txt +++ b/doc/grammar.txt @@ -29,15 +29,18 @@ symbol ::= '`' (KEYWORD | IDENT | operator | '(' ')' | IDENT primaryPrefix ::= (prefixOperator | 'bind') optInd -primarySuffix ::= '.' optInd symbol +primarySuffix ::= '.' optInd symbol [generalizedLit] | '(' optInd namedExprList optPar ')' | '[' optInd [indexExpr (comma indexExpr)* [comma]] optPar ']' | '^' | pragma -primary ::= primaryPrefix* (symbol | constructor | castExpr | addrExpr) +primary ::= primaryPrefix* (symbol [generalizedLit] | + constructor | castExpr | addrExpr) primarySuffix* +generalizedLit ::= GENERALIZED_STR_LIT | GENERALIZED_TRIPLESTR_LIT + literal ::= INT_LIT | INT8_LIT | INT16_LIT | INT32_LIT | INT64_LIT | FLOAT_LIT | FLOAT32_LIT | FLOAT64_LIT | STR_LIT | RSTR_LIT | TRIPLESTR_LIT diff --git a/doc/manual.txt b/doc/manual.txt index 7c0619ba7..49311fb43 100755 --- a/doc/manual.txt +++ b/doc/manual.txt @@ -178,6 +178,8 @@ the exact spelling of an identifier. String literals --------------- +Terminal symbol in the grammar: ``STR_LIT``. + `String literals`:idx: can be delimited by matching double quotes, and can contain the following `escape sequences`:idx:\ : @@ -205,12 +207,14 @@ contain the following `escape sequences`:idx:\ : Strings in Nimrod may contain any 8-bit value, even embedded zeros. However -some operations may interpret the first binary zero as terminator. +some operations may interpret the first binary zero as a terminator. Triple quoted string literals ----------------------------- +Terminal symbol in the grammar: ``TRIPLESTR_LIT``. + String literals can also be delimited by three double quotes ``"""`` ... ``"""``. Literals in this form may run for several lines, may contain ``"`` and do not @@ -230,10 +234,12 @@ Produces:: Raw string literals ------------------- -There are also `raw string literals` that are preceded with the letter ``r`` -(or ``R``) and are delimited by matching double quotes (just like ordinary -string literals) and do not interpret the escape sequences. This is especially -convenient for regular expressions or Windows paths: +Terminal symbol in the grammar: ``RSTR_LIT``. + +There are also `raw string literals`:idx: that are preceded with the +letter ``r`` (or ``R``) and are delimited by matching double quotes (just +like ordinary string literals) and do not interpret the escape sequences. +This is especially convenient for regular expressions or Windows paths: .. code-block:: nimrod @@ -250,12 +256,17 @@ Produces:: a"b ``r""""`` is not possible with this notation, because the three leading -quotes introduce a triple quoted string literal. +quotes introduce a triple quoted string literal. ``r"""`` is the same +as ``"""`` since triple quoted string literals do not interpret escape +sequences either. Generalized raw string literals ------------------------------- +Terminal symbols in the grammar: ``GENERALIZED_STR_LIT``, +``GENERALIZED_TRIPLESTR_LIT``. + The construct ``identifier"string literal"`` (without whitespace between the identifier and the opening quotation mark) is a `generalized raw string literal`:idx:. It is a shortcut for the construct |