Papyrus Compiler Errors

From the CreationKit Wiki
Revision as of 15:34, 6 January 2015 by imported>Terra Nova2 (Note about max length for script filename.)
Jump to navigation Jump to search

Format of a Compiler Error

A Papyrus compiler error is structured as follows:

<file>(<line>:<column>): <error>

Every error line starts with a full path to the file being examined. This is followed by the line and column where the error was detected. Note that this is not necessarily the exact line and character where the mistake is, but it is in the point at which the compiler detected the error. The actual error may be a few characters or even a line or two away.

Note that the compiler tries to recover from each error as it goes by faking a repair (usually by inserting what it expects, or ignoring some piece) and continuing on. This may lead to more errors. If you're having trouble figuring out what is causing an error that is in the middle of a list of errors, it may simply be a result of the compiler's attempted fix of an error it has previously reported. Try fixing the other errors in the file and compiling again.

Confusing Error Messages

Most error messages should be relatively self-explanatory, but some may confuse people. Potentially confusing errors are explained below:

"Missing X at 'Y'"

The compiler expected X, but found Y instead. This can usually be the result of a misspelled keyword, or malformed line.

"Missing EOF at 'Y'"

A common variation of the above. The literal EOF refers to a missing Event Or Function. This is the result of the compiler finding code statements outside of the scope of a function block.

"Mismatched (input/character) 'X' expecting Y

The compiler expected Y, but found X instead. This is usually the result of a malformed line or misspelled keyword.

"No viable alternative at input 'X'

The compiler didn't expect X, and so cannot compile the element. Usually the result of a malformed line or missing parts.

"Required (...)+ loop did not match anything at input 'X'"

The compiler expected a list of things, but got confused when it encountered X. You may be missing a comma somewhere, misspelled something, or have excess text at the end of a line.

"Error while attempting to read script X: <message>"

This is an internal compiler error that is usually the result of a failed error recovery mechanism. Try fixing any errors reported before this one.

Notes

  • The maximum amount of characters allowed for a filename with the compiler is 38 characters. Anything more than this and the compiler will complain regardless if the script itself is correct line by line.


Language: English  • français