Difference between revisions of "Error"

(See Also)
(moved example to example)
 
(3 intermediate revisions by the same user not shown)
Line 4: Line 4:
  
 
[[category:Evaluation Functions]]
 
[[category:Evaluation Functions]]
 +
{{ReleaseBar}}
  
== Function Error(message) ==
+
== Function Error(message{{Release|5.2||'', caption, url, urlText''}}) ==
 
Reports an evaluation-time error, displaying the indicated «message» to the end user in a dialog box and ending the current computation.
 
Reports an evaluation-time error, displaying the indicated «message» to the end user in a dialog box and ending the current computation.
  
 
If the expression in a [[Check Attribute]] calls [[Error]](), it displays the error message as a warning dialog, instead of the default failed-check message that otherwise appears when the [[Check Attribute]] evaluates to <code>False</code> (0).
 
If the expression in a [[Check Attribute]] calls [[Error]](), it displays the error message as a warning dialog, instead of the default failed-check message that otherwise appears when the [[Check Attribute]] evaluates to <code>False</code> (0).
  
 +
{{Release|5.2||
 +
The optional «caption» parameter controls the text that appears on the title bar of the error dialog.
 +
 +
The optional «url» and «urlText» can be specified if you want to include a hyperlink on the error's message box.
 +
}}
 
== Examples ==
 
== Examples ==
 
:<code>If not IsNumber(x) Then Error("Something is wrong.  x is not numeric.");</code>
 
:<code>If not IsNumber(x) Then Error("Something is wrong.  x is not numeric.");</code>
 +
 +
{{Release|5.2||
 +
<code>
 +
:[[Error]]( "The matrix to MapKernel must be positive definite",
 +
::url: "https://mywebsite.com/Details/Using_MapKernel.html",
 +
::urlText:"Info on this error")
 +
</code>
 +
}}
  
 
== See Also ==
 
== See Also ==

Latest revision as of 21:46, 14 June 2019



Release:

4.6  •  5.0  •  5.1  •  5.2

Function Error(message, caption, url, urlText)

Reports an evaluation-time error, displaying the indicated «message» to the end user in a dialog box and ending the current computation.

If the expression in a Check Attribute calls Error(), it displays the error message as a warning dialog, instead of the default failed-check message that otherwise appears when the Check Attribute evaluates to False (0).

The optional «caption» parameter controls the text that appears on the title bar of the error dialog.

The optional «url» and «urlText» can be specified if you want to include a hyperlink on the error's message box.

Examples

If not IsNumber(x) Then Error("Something is wrong. x is not numeric.");

Error( "The matrix to MapKernel must be positive definite",
url: "https://mywebsite.com/Details/Using_MapKernel.html",
urlText:"Info on this error")

See Also

Comments


You are not allowed to post comments.