# error

A typed failure with a machine-readable type and a human-readable message.

Last updated: 2026-09-09

Package: language.types | Status: documented

Tags: core, cpu, language, type, yeho

A focused reference with a complete example. Numeric widths and experimental types still depend on the selected backend.

```yh
error
```


## Name the failure

Use an error value when failure needs to cross a function or task boundary with machine-readable identity and a human-readable explanation.

Verification: type checked

```yh
error problem = Error("save.denied", "The project folder is read only")
Console.Error(problem.type + ": " + problem.message)

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

```

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/type--error-ca00fc/complete-0 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```




Source: demonhunterlabs/app/lib/yeho-language-reference.ts

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