luau-lang/luau
1
0
Fork 0
mirror of https://github.com/luau-lang/luau.git synced 2025-04-05 11:20:54 +01:00
Code Issues Projects Releases Packages Wiki Activity

Update grammar.md

Browse source 
This changes the grammar to follow the EBNF rules more rigorously, most significantly quoting all keywords.
This commit is contained in:
Arseny Kapoulkine 2021-12-27 12:48:58 -08:00 • committed by GitHub
parent d079201a6e
commit 65177c425c
Signed by: DevComp
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 54 additions and 54 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

108
docs/_pages/grammar.md
View file

@ -10,73 +10,73 @@ is available in the [syntax section](syntax).
> Note: this grammar is currently missing type pack syntax for generic arguments > Note: this grammar is currently missing type pack syntax for generic arguments
```ebnf ```ebnf
chunk ::= {stat [`;']} [laststat [`;']] chunk = block
block ::= chunk block = {stat [';']} [laststat [';']]
stat ::= varlist `=' explist | stat = varlist '=' explist |
var compoundop exp | var compoundop exp |
functioncall | functioncall |
do block end | 'do' block 'end' |
while exp do block end | 'while' exp 'do' block 'end' |
repeat block until exp | 'repeat' block 'until' exp |
if exp then block {elseif exp then block} [else block] end | 'if' exp 'then' block {'elseif' exp 'then' block} ['else' block] 'end' |
for binding `=' exp `,' exp [`,' exp] do block end | 'for' binding '=' exp ',' exp [',' exp] 'do' block 'end' |
for bindinglist in explist do block end | 'for' bindinglist 'in' explist 'do' block 'end' |
function funcname funcbody | 'function' funcname funcbody |
local function NAME funcbody | 'local' 'function' NAME funcbody |
local bindinglist [`=' explist] | 'local' bindinglist ['=' explist] |
[export] type NAME [`<' GenericTypeList `>'] `=' Type ['export'] type NAME ['<' GenericTypeList '>'] '=' Type
laststat ::= return [explist] | break | continue laststat = 'return' [explist] | 'break' | 'continue'
funcname ::= NAME {`.' NAME} [`:' NAME] funcname = NAME {'.' NAME} [':' NAME]
funcbody ::= `(' [parlist] `)' [`:' ReturnType] block end funcbody = '(' [parlist] ')' [':' ReturnType] block 'end'
parlist ::= bindinglist [`,' `...'] | `...' parlist = bindinglist [',' '...'] | '...'
explist ::= {exp `,'} exp explist = {exp ','} exp
namelist ::= NAME {`,' NAME} namelist = NAME {',' NAME}
binding ::= NAME [`:' TypeAnnotation] binding = NAME [':' TypeAnnotation]
bindinglist ::= binding [`,' bindinglist] (* equivalent of Lua 5.1 `namelist`, except with optional type annotations *) bindinglist = binding [',' bindinglist] (* equivalent of Lua 5.1 'namelist', except with optional type annotations *)
var ::= NAME | prefixexp `[' exp `]' | prefixexp `.' Name var = NAME | prefixexp '[' exp ']' | prefixexp '.' Name
varlist ::= var {`,' var} varlist = var {',' var}
prefixexp ::= var | functioncall | `(' exp `)' prefixexp = var | functioncall | '(' exp ')'
functioncall ::= prefixexp funcargs | prefixexp `:' NAME funcargs functioncall = prefixexp funcargs | prefixexp ':' NAME funcargs
exp ::= (asexp | unop exp) { binop exp } exp = (asexp | unop exp) { binop exp }
ifelseexp ::= if exp then exp {elseif exp then exp} else exp ifelseexp = 'if' exp 'then' exp {'elseif' exp 'then' exp} 'else' exp
asexp ::= simpleexp [`::' Type] asexp = simpleexp ['::' Type]
simpleexp ::= NUMBER | STRING | nil | true | false | `...' | tableconstructor | function body | prefixexp | ifelseexp simpleexp = NUMBER | STRING | 'nil' | 'true' | 'false' | '...' | tableconstructor | 'function' body | prefixexp | ifelseexp
funcargs ::= `(' [explist] `)' | tableconstructor | STRING funcargs = '(' [explist] ')' | tableconstructor | STRING
tableconstructor ::= `{' [fieldlist] `}' tableconstructor = '{' [fieldlist] '}'
fieldlist ::= field {fieldsep field} [fieldsep] fieldlist = field {fieldsep field} [fieldsep]
field ::= `[' exp `]' `=' exp | NAME `=' exp | exp field = '[' exp ']' '=' exp | NAME '=' exp | exp
fieldsep ::= `,' | `;' fieldsep = ',' | ';'
compoundop :: `+=' | `-=' | `*=' | `/=' | `%=' | `^=' | `..=' compoundop :: '+=' | '-=' | '*=' | '/=' | '%=' | '^=' | '..='
binop ::= `+' | `-' | `*' | `/' | `^' | `%' | `..' | `<' | `<=' | `>' | `>=' | `==' | `~=' | and | or binop = '+' | '-' | '*' | '/' | '^' | '%' | '..' | '<' | '<=' | '>' | '>=' | '==' | '~=' | 'and' | 'or'
unop ::= `-' | not | `#' unop = '-' | 'not' | '#'
SimpleType ::= SimpleType =
nil | 'nil' |
NAME[`.' NAME] [ `<' TypeList `>' ] | NAME ['.' NAME] [ '<' TypeList '>' ] |
`typeof' `(' exp `)' | 'typeof' '(' exp ')' |
TableType | TableType |
FunctionType FunctionType
Type ::= Type =
SimpleType [`?`] | SimpleType ['?'] |
SimpleType [`|` Type] | SimpleType ['|' Type] |
SimpleType [`&` Type] SimpleType ['&' Type]
GenericTypeList ::= NAME [`...'] {`,' NAME [`...']} GenericTypeList = NAME ['...'] {',' NAME ['...']}
TypeList ::= Type [`,' TypeList] | ...Type TypeList = Type [',' TypeList] | '...' Type
ReturnType ::= Type | `(' TypeList `)' ReturnType = Type | '(' TypeList ')'
TableIndexer ::= `[' Type `]' `:' Type TableIndexer = '[' Type ']' ':' Type
TableProp ::= NAME `:' Type TableProp = NAME ':' Type
TablePropOrIndexer ::= TableProp | TableIndexer TablePropOrIndexer = TableProp | TableIndexer
PropList ::= TablePropOrIndexer {fieldsep TablePropOrIndexer} [fieldsep] PropList = TablePropOrIndexer {fieldsep TablePropOrIndexer} [fieldsep]
TableType ::= `{' PropList `}' TableType = '{' PropList '}'
FunctionType ::= [`<' GenericTypeList `>'] `(' [TypeList] `)' `->` ReturnType FunctionType = ['<' GenericTypeList '>'] '(' [TypeList] ')' '->' ReturnType
``` ```