tiny.mprompt.yieldWith

1/// Suspends the body at `prompt` and runs `handler(continuation, handler_context, value)` on the2/// stack of the code that called `run`, so that a handler outside the body computes its next value,3/// as a generator hands out each value or a worker asks for input. The call returns the value the4/// handler continues the body with. The handler receives `value` by copy. `handler_context` must be5/// a pointer, and any other type is a compile error. The handler must continue the body before it6/// returns, and a handler that returns without continuing stops the program with a panic. `prompt`7/// must be the prompt the body received from `run`, and the body must still be running on it, which8/// assertions check in safe builds. `PromptResult` must be the `Result` type of the enclosing9/// `run`.10pub fn yieldWith(11    comptime ResumeValue: type,12    comptime PromptResult: type,13    prompt: *Prompt,14    value: anytype,15    handler_context: anytype,16    comptime handler: *const fn (Continuation(ResumeValue, PromptResult), @TypeOf(handler_context), @TypeOf(value)) void,17) ResumeValue {18    const YieldValue = @TypeOf(value);19    const HandlerContext = @TypeOf(handler_context);20    requirePointer(HandlerContext, "yieldWith handler context");21    const Environment: type = YieldWithEnvironmentType(22        ResumeValue,23        PromptResult,24        YieldValue,25        HandlerContext,26        handler,27    );28    var environment: Environment = .{29        .value = value,30        .handler_context = handler_context,31    };32    return readSlot(ResumeValue, raw.yieldPrompt(prompt, Environment.onYield, &environment));33}

1pub const yieldWith = zig_api.yieldWith;