await()

template<typename T>

PromiseResult< T > fl::task::await ( Promise< T > p )

inline

Await promise completion in a coroutine (Trampoline to platform implementation)

Template Parameters

T	The type of value the promise resolves to

Parameters

p	The promise to await

Returns

A PromiseResult<T> containing either the resolved value or an error

This is the public API for awaiting promises in coroutines. It delegates to the platform-specific implementation in fl::platforms::await().

REQUIREMENTS:

• MUST be called from within a fl::task::coroutine() context
• Only available on ESP32 (FreeRTOS) and Host/Stub (std::thread) platforms
• Promise MUST eventually complete (or timeout)

SAFETY: Unlike await_top_level(), this does NOT busy-wait. The coroutine is suspended by the OS scheduler and wakes when the promise completes, with zero CPU overhead.

Examples

fl::task::coroutine({
    .func = []() {
        auto result = fl::task::await(fl::fetch_get("http://example.com"));
        if (result.ok()) {
            process(result.value());
        }
    }
});

Definition at line 305 of file executor.h.

                                            {
    return fl::platforms::await(p);
}

Referenced by AutoResearchRemoteControl::registerFunctions().

Here is the caller graph for this function: