Back to top
Documentation SurrealQL Functions Parse functions

Parse functions

These functions can be used when parsing email addresses and URL web addresses.

Function Description
parse::email::host() Parses and returns an email host from an email address
parse::email::user() Parses and returns an email username from an email address
parse::url::domain() Parses and returns the domain from a URL
parse::url::fragment() Parses and returns the fragment from a URL
parse::url::host() Parses and returns the hostname from a URL
parse::url::path() Parses and returns the path from a URL
parse::url::port() Parses and returns the port number from a URL
parse::url::query() Parses and returns the query string from a URL

parse::email::host

The parse::email::host function parses and returns and email host from a valid email address.

parse::email::host(string) -> string

The following example shows this function, and its output, when used in a RETURN statement:

RETURN parse::email::host("info@surrealdb.com");
"surrealdb.com"

parse::email::user

The parse::email::user function parses and returns and email username from a valid email address.

parse::email::user(string) -> bool

The following example shows this function, and its output, when used in a RETURN statement:

RETURN parse::email::user("info@surrealdb.com");
"info"

parse::url::domain

The parse::url::domain function parses and returns the domain from a valid URL.

parse::url::domain(string) -> bool

The following example shows this function, and its output, when used in a RETURN statement:

RETURN parse::url::domain("https://surrealdb.com:80/features?some=option#fragment");
"surrealdb.com"

parse::url::fragment

The parse::url::fragment function parses and returns the fragment from a valid URL.

parse::url::fragment(string) -> bool

The following example shows this function, and its output, when used in a RETURN statement:

RETURN parse::url::fragment("https://surrealdb.com:80/features?some=option#fragment");
"fragment"

parse::url::host

The parse::url::host function parses and returns the hostname from a valid URL.

parse::url::host(string) -> bool

The following example shows this function, and its output, when used in a RETURN statement:

RETURN parse::url::host("https://surrealdb.com:80/features?some=option#fragment");
"surrealdb.com"

parse::url::path

The parse::url::path function parses and returns the path from a valid URL.

parse::url::path(string) -> bool

The following example shows this function, and its output, when used in a RETURN statement:

RETURN parse::url::path("https://surrealdb.com:80/features?some=option#fragment");
"/features"

parse::url::port

The parse::url::port function parses and returns the port from a valid URL.

parse::url::port(string) -> bool

The following example shows this function, and its output, when used in a RETURN statement:

RETURN parse::url::port("https://surrealdb.com:80/features?some=option#fragment");
80

parse::url::query

The parse::url::query function parses and returns the query from a valid URL.

parse::url::query(string) -> bool

The following example shows this function, and its output, when used in a RETURN statement:

RETURN parse::url::query("https://surrealdb.com:80/features?some=option#fragment");
"some=option"