From eb808a3f8bbd97d2a2ea0114b43b708a17b44066 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= Date: Fri, 11 Apr 2025 14:34:51 +0200 Subject: Gun 2.2.0 --- docs/en/gun/2.2/manual/gun.headers/index.html | 218 ++++++++++++++++++++++++++ 1 file changed, 218 insertions(+) create mode 100644 docs/en/gun/2.2/manual/gun.headers/index.html (limited to 'docs/en/gun/2.2/manual/gun.headers/index.html') diff --git a/docs/en/gun/2.2/manual/gun.headers/index.html b/docs/en/gun/2.2/manual/gun.headers/index.html new file mode 100644 index 00000000..a7ca163f --- /dev/null +++ b/docs/en/gun/2.2/manual/gun.headers/index.html @@ -0,0 +1,218 @@ + + + + + + + + + + Nine Nines: gun:headers(3) + + + + + + + + + + + + + +
+
+
+
+

99s

+
+
+ +
+ +
    +
  • + Github +
    • +
  • + +
    • +
+
+
+
+
+ + +
+ +
+
+
+
+ +

gun:headers(3)

+ +

Name

+

gun:headers - Initiate the given request

+

Description

+
+
headers(ConnPid, Method, Path, Headers)
+    -> headers(ConnPid, Method, Path, Headers, #{})
+
+headers(ConnPid, Method, Path, Headers, ReqOpts)
+    -> StreamRef
+
+ConnPid   :: pid()
+Method    :: binary()
+Path      :: iodata()
+Headers   :: gun:req_headers()
+ReqOpts   :: gun:req_opts()
+StreamRef :: gun:stream_ref()
+
+

Initiate the given request.

+

This is a general purpose function that should only be used when other method-specific functions do not apply.

+

The function headers/4,5 initiates a request but does not send the request body. It must be sent separately using gun:data(3).

+

Arguments

+
ConnPid
+

The pid of the Gun connection process.

+
+
Method
+

Method to be used for the request.

+
+
Path
+

Path to the resource.

+
+
Headers
+

Additional request headers.

+
+
ReqOpts
+

Request options.

+
+
+

Return value

+

A reference that identifies the newly created stream is returned. It is this reference that must be passed in subsequent calls and will be received in messages related to this new stream.

+

Changelog

+
  • 2.0: Function introduced. +
    • +
+

Examples

+
Initiate a request
+
+
StreamRef = gun:headers(ConnPid, <<"PUT">>,
+    "/lang/fr_FR/hello",
+    [{<<"content-type">>, <<"text/plain">>}]).
+
+

See also

+

gun(3), gun:request(3), gun:await(3), gun:await_body(3), gun_push(3), gun_inform(3), gun_response(3), gun_data(3)

+ + + + + + +
+ +
+ + +

+ Gun + 2.2 + 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.

+ + + +
+
+
+
+ + + + + + + + + -- cgit v1.2.3