Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.
error([showLineNumber=boolean])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
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.None
Long name (short name) | Argument types | Properties | ||
---|---|---|---|---|
showLineNumber(sl) |
boolean |
|||
|
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 have multiple arguments, passed either as a tuple or a list. |
import maya.cmds as cmds import maya.cmds as cmds def lightError(): l = cmds.ls( lights=True ) if len(l) == 0: cmds.error( "No Lights" ) lightError() # The above will produce the following output and raise a RuntimeError # exception from the script containing it: # # # Error: No Lights # # # If the option to display line numbers or the stack trace is turned on # the following output will be produced and the same exception raised: # # # Error: line 13 of 'lightError' in '<maya console'>: No Lights # #