Engine:CCMD run: Difference between revisions

# 'Statements' are text blocks that begin with a command name, and are followed by any other text, and end with line-end or semi-colon. A new statement can begin adjacent to the previous statements ending delimiter.

# Command names begin or end at white-space, semi-colon, or line-end, and end at comment start.

# Other text starts after any white-space after command name, until semi-colon, line-end, or comment start.

# Comment text starts with '//', placed anywhere on a line, and includes all text until line-end.

# Comment text, empty statements or lines, or statements or lines with only white-space, will be skipped.

# Command names must be at least 2 and less than 63 characters. Statements with invalid command names will be skipped.

# Other text may contain quoted text, where '<nowiki>'</nowiki>' or '"' are valid quote begin and end quote characters.

# If quoted text is found, any semi-colons, line-ends, or comment starts will be ignored, until next matching quote character.

# No other checking or processing is done on any 'other text' after the command name, and any actual meaning is context-dependent and determined when the actual statement is run.

# If embedded in text a NULL, or '\0', or any character less than ' ', will be considered as a white-space character. This means that a '\0' delimits a command name, stays included in other-text as is, and is otherwise ignored. This also means that these characters can not be used in command names.

# Command names in this context can contain any character except white-space and ';', and cannot contain '//'. Command names can also have quote characters in the name and are not checked for closing quotes and treated as is as a part of the name. Valid command names: bob/"bob"/bob, "bob", bob", "bob.

# 'Executable statements' are composed of both the parsed 'command name' and 'other text' components, excluding comments, and each are the product of this function which gets run.