steve-downey / callcc / 27394312370

push

github

Add callCC usage examples and document call_cc in the README

Add three runnable examples under src/examples/ demonstrating classic uses of
call-with-current-continuation on this sender-based call_cc:
  - callcc_early_return: invoking the escape discards the rest of the pipeline
  - callcc_exception:    let_error handler escapes with a recovery value
                         (exception-style non-local exit; success path flows through)
  - callcc_deep_escape:  escape from the innermost of nested let_value levels,
                         bypassing every intervening continuation

Rework the README to lead with what callCC is, what it is used for, what this
implementation provides (drain-then-complete safety, derived completion
signatures, exception-safe start, zero heap allocation) and its limits (one-shot
escape; escape lives on the stopped channel so a bare escape is not a when_all
child; explicit ValueType; cooperative cancellation), then describe the examples.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

0 of 54 new or added lines in 3 files covered. (0.0%)

385 of 455 relevant lines covered (84.62%)

2.8 hits per line