aboutsummaryrefslogtreecommitdiffstats
path: root/doc/src/manual/cowboy_req.binding.asciidoc
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2016-11-07 18:03:47 +0200
committerLoïc Hoguin <[email protected]>2016-11-07 18:03:47 +0200
commit7b248e5163fd852d6defe967318da849433dadb1 (patch)
tree2db5fc09210cb77e77cf14a9ac61fef932131f15 /doc/src/manual/cowboy_req.binding.asciidoc
parentbd34dfdedd369b42b1e6920f60c32b0594802aa2 (diff)
downloadcowboy-7b248e5163fd852d6defe967318da849433dadb1.tar.gz
cowboy-7b248e5163fd852d6defe967318da849433dadb1.tar.bz2
cowboy-7b248e5163fd852d6defe967318da849433dadb1.zip
Add man pages for the parse/match/binding cowboy_req functions
Diffstat (limited to 'doc/src/manual/cowboy_req.binding.asciidoc')
-rw-r--r--doc/src/manual/cowboy_req.binding.asciidoc67
1 files changed, 67 insertions, 0 deletions
diff --git a/doc/src/manual/cowboy_req.binding.asciidoc b/doc/src/manual/cowboy_req.binding.asciidoc
new file mode 100644
index 0000000..4e27f31
--- /dev/null
+++ b/doc/src/manual/cowboy_req.binding.asciidoc
@@ -0,0 +1,67 @@
+= cowboy_req:binding(3)
+
+== Name
+
+cowboy_req:binding - Access a value bound from the route
+
+== Description
+
+[source,erlang]
+----
+binding(Name, Req) -> binding(Name, Req, undefined)
+binding(Name, Req, Default) -> any() | Default
+
+Name :: atom()
+Req :: cowboy_req:req()
+Default :: any()
+----
+
+Return the value for the given binding.
+
+== Arguments
+
+Name::
+
+Desired binding name as an atom.
+
+Req::
+
+The Req object.
+
+Default::
+
+Default value returned when the binding is missing.
+
+== Return value
+
+By default the value is a case sensitive binary string, however
+constraints may change the type of this value (for example
+automatically converting numbers to integer).
+
+== Changelog
+
+* *2.0*: Only the value is returned, it is no longer wrapped in a tuple.
+* *1.0*: Function introduced.
+
+== Examples
+
+.Get the username from the path
+[source,erlang]
+----
+%% Route is "/users/:user"
+Username = cowboy_req:binding(user, Req).
+----
+
+.Get the branch name, with a default
+[source,erlang]
+----
+%% Route is "/log[/:branch]"
+Branch = cowboy_req:binding(branch, Req, <<"master">>)
+----
+
+== See also
+
+link:man:cowboy_req(3)[cowboy_req(3)],
+link:man:cowboy_req:bindings(3)[cowboy_req:bindings(3)],
+link:man:cowboy_req:host_info(3)[cowboy_req:host_info(3)],
+link:man:cowboy_req:path_info(3)[cowboy_req:path_info(3)]