suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc clarification on continuation-mark-set-first performance

Browse Source
This commit is contained in:
Matthew Flatt 2020-05-24 07:13:14 -06:00
parent 0473bd52f8
commit b297271a5c
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
pkgs/racket-doc/scribblings/reference/cont-marks.scrbl
View File

@ -150,12 +150,18 @@ reflected by @racket[mark-set] between frames that have keys in
Returns the first element of the list that would be returned by Returns the first element of the list that would be returned by
@racket[(continuation-mark-set->list (or mark-set @racket[(continuation-mark-set->list (or mark-set
(current-continuation-marks prompt-tag)) key-v prompt-tag)], or (current-continuation-marks prompt-tag)) key-v prompt-tag)], or
@racket[none-v] if the result would be the empty list. The result @racket[none-v] if the result would be the empty list.
The result
is produced in (amortized) constant time. Typically, this is produced in (amortized) constant time. Typically, this
result can be computed more quickly using result can be computed more quickly using
@racket[continuation-mark-set-first] than using @racket[continuation-mark-set-first] than using
@racket[continuation-mark-set->list] or by using @racket[continuation-mark-set->list] or by using
@racket[continuation-mark-set->iterator] and iterating just once.} @racket[continuation-mark-set->iterator] and iterating just once.
Although @racket[#f] and @racket[(current-continuation-marks
prompt-tag)] are equivalent for @racket[mark-set], providing @racket[#f]
as @racket[mark-set] can enable shortcuts that make it even faster.}
@defproc[(call-with-immediate-continuation-mark @defproc[(call-with-immediate-continuation-mark
[key-v any/c] [key-v any/c]