ac26fe7554
Also, updates some of the mzlib files to point at `racket/*' libraries rather than to `scheme/*' ones.
76 lines
2.2 KiB
Racket
76 lines
2.2 KiB
Racket
#lang scribble/doc
|
|
@(require scribble/manual
|
|
scribble/struct
|
|
scribble/decode
|
|
scribble/eval
|
|
"parse-common.rkt"
|
|
(for-label syntax/kerncase))
|
|
|
|
@title{Library syntax classes and literal sets}
|
|
|
|
@section{Syntax classes}
|
|
|
|
@(begin
|
|
(define-syntax-rule (defstxclass name . pre-flows)
|
|
(defidform name . pre-flows))
|
|
(define-syntax-rule (defstxclass* (name arg ...) . pre-flows)
|
|
(defform (name arg ...) . pre-flows)))
|
|
|
|
@defstxclass[expr]{
|
|
|
|
Matches anything except a keyword literal (to distinguish expressions
|
|
from the start of a keyword argument sequence). The term is not
|
|
otherwise inspected, since it is not feasible to check if it is
|
|
actually a valid expression.
|
|
}
|
|
|
|
@deftogether[(
|
|
@defstxclass[identifier]
|
|
@defstxclass[boolean]
|
|
@defstxclass[str]
|
|
@defstxclass[char]
|
|
@defstxclass[keyword]
|
|
@defstxclass[number]
|
|
@defstxclass[integer]
|
|
@defstxclass[exact-integer]
|
|
@defstxclass[exact-nonnegative-integer]
|
|
@defstxclass[exact-positive-integer])]{
|
|
|
|
Match syntax satisfying the corresponding predicates.
|
|
}
|
|
|
|
@defstxclass[id]{ Alias for @racket[identifier]. }
|
|
@defstxclass[nat]{ Alias for @racket[exact-nonnegative-integer]. }
|
|
|
|
@defproc[(static [predicate (-> any/c any/c)]
|
|
[description (or/c string? #f)])
|
|
(attributes value)]{
|
|
|
|
The @racket[static] syntax class matches an
|
|
identifier that is bound in the syntactic environment to static
|
|
information (see @racket[syntax-local-value]) satisfying the given
|
|
@racket[predicate]. If the term does not match, the
|
|
@racket[description] argument is used to describe the expected syntax.
|
|
|
|
When used outside of the dynamic extent of a macro transformer (see
|
|
@racket[syntax-transforming?]), matching fails.
|
|
|
|
The attribute @var[value] contains the value the name is bound to.
|
|
}
|
|
|
|
|
|
@section{Literal sets}
|
|
|
|
@defidform[kernel-literals]{
|
|
|
|
Literal set containing the identifiers for fully-expanded code
|
|
(@secref[#:doc '(lib "scribblings/reference/reference.scrbl")
|
|
"fully-expanded"]). The set contains all of the forms listed by
|
|
@racket[kernel-form-identifier-list], plus @racket[module],
|
|
@racket[#%plain-module-begin], @racket[#%require], and
|
|
@racket[#%provide].
|
|
|
|
Note that the literal-set uses the names @racket[#%plain-lambda] and
|
|
@racket[#%plain-app], not @racket[lambda] and @racket[#%app].
|
|
}
|