Go to: Synopsis. Return value. Keywords. Related. Flags. MEL examples.

Synopsis

error [-noContext] [-showLineNumber boolean]

error is NOT undoable, NOT queryable, and NOT editable.

The error command is provided so that the user can issue error messages from his/her scripts and control execution in the event of runtime errors.

The string argument is displayed in the command window (or stdout if running in batch mode) after being prefixed with an error message heading and surrounded by //.

The error command also causes execution to terminate with an error. Using error is like raising an exception because the error will propagate up through the call chain. You can use catch to handle the error from the caller side. If you don't want execution to end, then you probably want to use the warning command instead.

Return value

None

Keywords

debug, information, echo

Related

print, warning

Flags

noContext, showLineNumber
Long name (short name) Argument types Properties
-noContext(-n) create
Do not include the context information with the error message.
-showLineNumber(-sl) boolean create
Obsolete. Will be deleted in the next version of Maya. Use the checkbox in the script editor that enables line number display instead.
Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

proc lightError()
{
    $l = `ls -lights`;
    if (size($l) == 0) {
        error "No Lights";
    }
}
lightError()
// The above will produce the following output and terminate execution
// of the script containing it:
//
//      // Error: No Lights //
//
// If the option to display line numbers is toggled on then the result
// will instead look like the following:
//
//      // Error: line 5: No Lights //
//