====== Error(error_text) ======
Category:  Special function

\\ 
=====Description=====
This function creates an error value with the given //error_text//.

\\ 
=====Use cases=====
Use this function to raise an error when a known situation occurs that could cause issues downstream, and should not be permitted to continue.  i.e., empty datasets, values outside expected parameters, etc.

\\ 
=====Arguments=====
^Argument^Type^Description^
|error_text|Text|The text message shown when the error is displayed.|

**Return value type:** Error/Text


\\ 
=====Examples=====

  error('Something went wrong')  //Returns '#Something went wrong'

  error('Dataset is empty')  //Returns '#Dataset is empty'

  if([Value] >= 10, [Value], error('Minimum value is 10') )  //Returns the error if [Value] is below 10.

\\ 
=====See also=====
  * [[syntax:functions:iferror|IfError(expression1, expression2)]]
  * [[syntax:functions:iserror|IsError(expression)]]
  * [[syntax:types|The EasyMorph Type system]]
