# udpDatagram

A udp datagram record carrying status, address, port, payload.

Last updated: 2026-09-09

Package: network.udp | Status: source-declared

Tags: cpu, method, network, network.udp, source-example, thing, udp, yeho

Exchange bounded UDP datagrams; your application owns its protocol and session rules.

```yh
external thing udpDatagram
```

- int status: Stores status as int.
- text address: Stores address as text.
- int port: Stores port as int.
- list of byte payload: Stores payload as list of byte.
- udpDatagram(int status, text address, int port, list of byte payload): Udp datagram.
- Available() returns bool: Available.
- WouldBlock() returns bool: Would block.
- Diagnostic() returns text: Diagnostic.

## Use udpDatagram

A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.

Verification: type checked

```yh
using network.udp

// Exchange bounded UDP datagrams; your application owns its protocol and session rules.
udpDatagram sample = udpDatagram(1, "address", 1, [])
Console.Log(Text.From(sample.status))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.network_udp__udpdatagram"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "network.udp"
version = "0.1.0"
path = "../../../yeho/packages/network/udp"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/network.udp--udpDatagram/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## udpDatagram.Available

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using network.udp

// Available.
udpDatagram instance = udpDatagram(1, "address", 1, [])
bool result = instance.Available()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.network_udp__udpdatagram"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "network.udp"
version = "0.1.0"
path = "../../../yeho/packages/network/udp"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/network.udp--udpDatagram/method-Available-5 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## udpDatagram.WouldBlock

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using network.udp

// Would block.
udpDatagram instance = udpDatagram(1, "address", 1, [])
bool result = instance.WouldBlock()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.network_udp__udpdatagram"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "network.udp"
version = "0.1.0"
path = "../../../yeho/packages/network/udp"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/network.udp--udpDatagram/method-WouldBlock-6 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## udpDatagram.Diagnostic

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using network.udp

// Diagnostic.
udpDatagram instance = udpDatagram(1, "address", 1, [])
text result = instance.Diagnostic()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.network_udp__udpdatagram"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "network.udp"
version = "0.1.0"
path = "../../../yeho/packages/network/udp"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/network.udp--udpDatagram/method-Diagnostic-7 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup.

Source: yeho/packages/network/udp/udp.yh

AI training permission: https://demonhunterlabs.com/ai-use