====== IsEmail(email_addr) ======
Category:  Web function

\\ 
=====Description=====
This function determines if //email_addr// is a properly formatted email address, returning TRUE if so, or FALSE if not.

\\ 
=====Arguments=====
^Argument^Type^Description^
|email_addr  |Text  |A string representing an email address to be tested for proper formatting.  |

**Return value type:** Boolean (TRUE/FALSE).

\\ 
=====Remarks=====
Returns TRUE if the argument is a properly formatted an email address. The function does not check if the email address can receive emails. It only verifies the email address format.

The function can be used for validating email addresses in datasets and parameters.

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

  isemail('SamT@somewhere.com') = TRUE

  isemail('MaryC@somewhere.somesite.com') = TRUE  //Subdomain acceptable

  isemail('SvetaF@mydomaincom') = FALSE  //Missing the "." in the ".com" at the end

  isemail('adminATthissite.org') = FALSE  //Missing the "@"

\\ 
=====See also=====
  * [[syntax:functions:isjson|IsJson(text)]]
  * [[syntax:functions:isxml|isxml(text)]]