cowboy_req:host(3)

Name

cowboy_req:host - URI host name

Description

host(Req :: cowboy_req:req()) -> Host :: binary()

Return the host name of the effective request URI.

The host name can also be obtained using pattern matching:

#{host := Host} = Req.

Arguments

Req

The Req object.

Return value

The host name is returned as a lowercase binary string. It is case insensitive.

Changelog

  • 2.0: Only the host name is returned, it is no longer wrapped in a tuple.
  • 1.0: Function introduced.

Examples

Get the effective request URI's host name
Host = cowboy_req:host(Req).

See also

cowboy_req(3), cowboy_req:binding(3), cowboy_req:bindings(3), cowboy_req:host_info(3)

Cowboy 2.10 Function Reference

Navigation

Version select

Like my work? Donate!

Donate to Loïc Hoguin because his work on Cowboy, Ranch, Gun and Erlang.mk is fantastic:

Recurring payment options are also available via GitHub Sponsors. These funds are used to cover the recurring expenses like food, dedicated servers or domain names.