{"id":"language--buffers","name":"Buffers","owner":"yeho","package":"language","kind":"language","signature":"buffer of Type name","description":"buffer of T is a shared resource shape used for explicit data movement and compute boundaries.","context":"Use buffers when a runtime or accelerator needs a bounded block of typed elements rather than an ordinary value collection.","parameters":[],"returns":"","members":[],"tags":["buffer","compute","cpu","gameplay","gpu","language","memory","of","yeho"],"updated":"2026-09-09","source":{"repository":"yeho","path":"memory-lifetime-unsafe-2026.1.json; accelerator positive fixtures"},"status":"experimental","notes":["Buffers are shared resources with explicit lifecycle and visibility contracts.","Raw allocation, free, pointer arithmetic, volatile, MMIO, and memory fences are unavailable as general language syntax."],"examples":[{"id":"cpu","title":"CPU · [cpu]","description":"Apply damage to a small batch of health values on the explicit CPU route. Each invocation owns one element.","code":"[cpu]\ncompute ApplyDamage(buffer of int health, int damage)\n{\n    int index = compute.index\n    if index >= health.count { return }\n    health[index] = health[index] - damage\n}\n\nbuffer of int health\nhealth.Add(100)\nhealth.Add(80)\nhealth.Add(60)\ncomputeTask job = dispatch ApplyDamage(health, 10)\nwait job\nif job.failed { Console.Error(job.error.message) Process.Exit(1) }\nfor index from 0 < health.count { Console.Log(Text.From(health[index])) }\n","tags":["cpu","compute","gameplay"],"run":"cpu-oracle","expected":"90\n70\n50","verifyRun":true,"manifest":"manifestVersion = \"2\"\npackage = \"api.example.language__buffers\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n","verification":"executed","sha256":"49ff2585eb7d092d68b446d7eb7224644c0fb1636822dcf89521faf7707eaeaa","checked":"2026-09-09","diagnostic":"","observedOutput":"90\n70\n50","checkedBackend":"cpu-oracle"},{"id":"gpu","title":"GPU · [gpu]","description":"Double a batch of reward values on native Metal. The [gpu] tag requires an accelerator backend; CPU oracle cannot silently satisfy it.","code":"[gpu]\ncompute DoubleRewards(buffer of int rewards, int multiplier)\n{\n    int index = compute.index\n    if index >= rewards.count { return }\n    rewards[index] = rewards[index] * multiplier\n}\n\nbuffer of int rewards\nrewards.Add(100)\nrewards.Add(80)\nrewards.Add(60)\ncomputeTask job = dispatch DoubleRewards(rewards, 2)\nwait job\nif job.failed { Console.Error(job.error.message) Process.Exit(1) }\nfor index from 0 < rewards.count { Console.Log(Text.From(rewards[index])) }\n","tags":["gpu","compute","gameplay"],"run":"metal","expected":"200\n160\n120","verifyRun":true,"manifest":"manifestVersion = \"2\"\npackage = \"api.example.language__buffers\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n","verification":"executed","sha256":"8b68476c6e65ff66879e53f7560b7cc51cfabff2e02ca5f88202423872b62292","checked":"2026-09-09","diagnostic":"","observedOutput":"200\n160\n120","checkedBackend":"metal"}],"searchTerms":[],"url":"https://demonhunterlabs.com/academy/api?item=language--buffers","json":"https://demonhunterlabs.com/reference/items/language--buffers.json","markdown":"https://demonhunterlabs.com/reference/text/language--buffers.md"}