mirror of
https://github.com/cesanta/mongoose.git
synced 2024-12-17 19:08:09 +08:00
23122b327c
It would be probably good idea to also remove tools/docgen.py and asciidoc.mk, but asciidoc.mk is still mentioned under `cloud/doc`, which may contain some useful info which we'll need at least to review before removing. PUBLISHED_FROM=faf454d4c52a2f07ea8ac084cf0bd11a0c9c9b3b
31 lines
1.1 KiB
Markdown
31 lines
1.1 KiB
Markdown
---
|
|
title: "mg_connect_ws()"
|
|
decl_name: "mg_connect_ws"
|
|
symbol_kind: "func"
|
|
signature: |
|
|
struct mg_connection *mg_connect_ws(struct mg_mgr *mgr,
|
|
mg_event_handler_t event_handler,
|
|
const char *url, const char *protocol,
|
|
const char *extra_headers);
|
|
---
|
|
|
|
Helper function that creates an outbound WebSocket connection.
|
|
|
|
`url` is a URL to connect to. It must be properly URL-encoded, e.g. have
|
|
no spaces, etc. By default, `mg_connect_ws()` sends Connection and
|
|
Host headers. `extra_headers` is an extra HTTP headers to send, e.g.
|
|
`"User-Agent: my-app\r\n"`.
|
|
If `protocol` is not NULL, then a `Sec-WebSocket-Protocol` header is sent.
|
|
|
|
Examples:
|
|
|
|
```c
|
|
nc1 = mg_connect_ws(mgr, ev_handler_1, "ws://echo.websocket.org", NULL,
|
|
NULL);
|
|
nc2 = mg_connect_ws(mgr, ev_handler_1, "wss://echo.websocket.org", NULL,
|
|
NULL);
|
|
nc3 = mg_connect_ws(mgr, ev_handler_1, "ws://api.cesanta.com",
|
|
"clubby.cesanta.com", NULL);
|
|
```
|
|
|