createOrNull

Creates an email address from the specified text, or returns null if the text doesn't match the corresponding regular expression.


Calling from Kotlin

Here's an example of calling this function from Kotlin code:

val address: EmailAddress? =
    EmailAddress.createOrNull("contact@kotools.org")
println(address) // contact@kotools.org

Calling from Java

Here's an example of calling this function from Java code:

final EmailAddress address =
        EmailAddress.Companion.createOrNull("contact@kotools.org");
System.out.println(address); // contact@kotools.org

You can use the EmailAddress.Companion.create function for throwing an exception instead of returning null in case of invalid text.