improve reference-to-guide links
svn: r6497
This commit is contained in:
parent
0b9493032b
commit
a0cee55f56
|
@ -17,7 +17,7 @@ procedure that creates a pair, @scheme[car] refers to the procedure
|
||||||
that extracts the first element of a pair, and so on.
|
that extracts the first element of a pair, and so on.
|
||||||
|
|
||||||
@margin-note{For information on the syntax of identifiers, see
|
@margin-note{For information on the syntax of identifiers, see
|
||||||
@secref["symbols"].}
|
@secref["guide:symbols"].}
|
||||||
|
|
||||||
Forms like @scheme[define], @scheme[lambda], and @scheme[let]
|
Forms like @scheme[define], @scheme[lambda], and @scheme[let]
|
||||||
associate a meaning with one or more identifiers; that is, they
|
associate a meaning with one or more identifiers; that is, they
|
||||||
|
|
|
@ -3,7 +3,7 @@
|
||||||
@require[(lib "eval.ss" "scribble")]
|
@require[(lib "eval.ss" "scribble")]
|
||||||
@require["guide-utils.ss"]
|
@require["guide-utils.ss"]
|
||||||
|
|
||||||
@title[#:tag "bytes"]{Bytes and Byte Strings}
|
@title[#:tag "guide:bytestrings"]{Bytes and Byte Strings}
|
||||||
|
|
||||||
A @defterm{byte} is an inexact integer between @scheme[0] and
|
A @defterm{byte} is an inexact integer between @scheme[0] and
|
||||||
@scheme[255], inclusive. The @scheme[byte?] predicate recognizes
|
@scheme[255], inclusive. The @scheme[byte?] predicate recognizes
|
||||||
|
@ -15,11 +15,11 @@ numbers that represent bytes.
|
||||||
]
|
]
|
||||||
|
|
||||||
A @defterm{byte string} is similar to a string---see
|
A @defterm{byte string} is similar to a string---see
|
||||||
@secref["strings"]---but its content is a sequence of bytes instead of
|
@secref["guide:strings"]---but its content is a sequence of bytes
|
||||||
characters. Byte strings can be used in applications that process pure
|
instead of characters. Byte strings can be used in applications that
|
||||||
ASCII instead of Unicode text. The printed and form of a byte string
|
process pure ASCII instead of Unicode text. The printed and form of a
|
||||||
supports such uses in particular, because a byte string prints like
|
byte string supports such uses in particular, because a byte string
|
||||||
the ASCII decoding of the byte string, but prefixed with a
|
prints like the ASCII decoding of the byte string, but prefixed with a
|
||||||
@schemefont{#}. Unprintable ASCII characters or non-ASCII bytes in the
|
@schemefont{#}. Unprintable ASCII characters or non-ASCII bytes in the
|
||||||
byte string are written with octal notation.
|
byte string are written with octal notation.
|
||||||
|
|
||||||
|
|
|
@ -3,10 +3,10 @@
|
||||||
@require[(lib "eval.ss" "scribble")]
|
@require[(lib "eval.ss" "scribble")]
|
||||||
@require["guide-utils.ss"]
|
@require["guide-utils.ss"]
|
||||||
|
|
||||||
@title[#:tag "strings"]{Strings (Unicode)}
|
@title[#:tag "guide:strings"]{Strings (Unicode)}
|
||||||
|
|
||||||
A @defterm{string} is a fixed-length array of
|
A @defterm{string} is a fixed-length array of
|
||||||
@seclink["characters"]{characters}. It prints using doublequotes,
|
@seclink["guide:characters"]{characters}. It prints using doublequotes,
|
||||||
where doublequote and backslash characters within the string are
|
where doublequote and backslash characters within the string are
|
||||||
escaped with backslashes. Other common string escapes are supported,
|
escaped with backslashes. Other common string escapes are supported,
|
||||||
incluing @schemefont["\\n"] for a linefeed, @schemefont["\\r"] for a
|
incluing @schemefont["\\n"] for a linefeed, @schemefont["\\r"] for a
|
||||||
|
@ -65,7 +65,7 @@ for an end user.
|
||||||
]
|
]
|
||||||
|
|
||||||
For working with plain ASCII, working with raw bytes, or
|
For working with plain ASCII, working with raw bytes, or
|
||||||
encoding/decoding Unicode strings as bytes, use @seclink["bytes"]{byte
|
encoding/decoding Unicode strings as bytes, use
|
||||||
strings}.
|
@seclink["guide:bytestrings"]{byte strings}.
|
||||||
|
|
||||||
@refdetails["mz:strings"]{strings and string procedures}
|
@refdetails["mz:strings"]{strings and string procedures}
|
||||||
|
|
|
@ -3,7 +3,7 @@
|
||||||
@require[(lib "eval.ss" "scribble")]
|
@require[(lib "eval.ss" "scribble")]
|
||||||
@require["guide-utils.ss"]
|
@require["guide-utils.ss"]
|
||||||
|
|
||||||
@title[#:tag "characters"]{Characters}
|
@title[#:tag "guide:characters"]{Characters}
|
||||||
|
|
||||||
A Scheme @defterm{character} corresponds to a Unicode @defterm{scalar
|
A Scheme @defterm{character} corresponds to a Unicode @defterm{scalar
|
||||||
value}. Roughly, a scalar value is an unsigned integer whose
|
value}. Roughly, a scalar value is an unsigned integer whose
|
||||||
|
|
|
@ -3,7 +3,7 @@
|
||||||
@require[(lib "eval.ss" "scribble")]
|
@require[(lib "eval.ss" "scribble")]
|
||||||
@require["guide-utils.ss"]
|
@require["guide-utils.ss"]
|
||||||
|
|
||||||
@title{Numbers}
|
@title[#:tag "guide:numbers"]{Numbers}
|
||||||
|
|
||||||
A Scheme @defterm{number} is either exact or inexact:
|
A Scheme @defterm{number} is either exact or inexact:
|
||||||
|
|
||||||
|
|
|
@ -3,7 +3,7 @@
|
||||||
@require[(lib "eval.ss" "scribble")]
|
@require[(lib "eval.ss" "scribble")]
|
||||||
@require["guide-utils.ss"]
|
@require["guide-utils.ss"]
|
||||||
|
|
||||||
@title[#:tag "symbols"]{Symbols}
|
@title[#:tag "guide:symbols"]{Symbols}
|
||||||
|
|
||||||
A @defterm{symbol} is an atomic value that prints like an identifier.
|
A @defterm{symbol} is an atomic value that prints like an identifier.
|
||||||
An expression that starts with @litchar{'} and continues with an
|
An expression that starts with @litchar{'} and continues with an
|
||||||
|
|
|
@ -3,6 +3,8 @@
|
||||||
|
|
||||||
@title[#:tag "mz:bytestrings"]{Byte Strings}
|
@title[#:tag "mz:bytestrings"]{Byte Strings}
|
||||||
|
|
||||||
|
@guideintro["guide:bytestrings"]{byte strings}
|
||||||
|
|
||||||
A @pidefterm{byte string} is a fixed-length arary of bytes. A
|
A @pidefterm{byte string} is a fixed-length arary of bytes. A
|
||||||
@pidefterm{byte} is an exact integer between @scheme[0] and
|
@pidefterm{byte} is an exact integer between @scheme[0] and
|
||||||
@scheme[255] inclusive.
|
@scheme[255] inclusive.
|
||||||
|
|
|
@ -3,5 +3,7 @@
|
||||||
|
|
||||||
@title[#:tag "mz:characters"]{Characters}
|
@title[#:tag "mz:characters"]{Characters}
|
||||||
|
|
||||||
|
@guideintro["guide:characters"]{characters}
|
||||||
|
|
||||||
A @pidefterm{character} corresponds to a Unicode scalar value (i.e., a
|
A @pidefterm{character} corresponds to a Unicode scalar value (i.e., a
|
||||||
Unicode code point that is not a surrogate).
|
Unicode code point that is not a surrogate).
|
||||||
|
|
|
@ -36,6 +36,8 @@ is @scheme[#t] or @scheme[#f], @scheme[#f] otherwise.}
|
||||||
@; ------------------------------------------------------------
|
@; ------------------------------------------------------------
|
||||||
@section[#:tag "symbols"]{Symbols}
|
@section[#:tag "symbols"]{Symbols}
|
||||||
|
|
||||||
|
@guideintro["guide:symbols"]{symbols}
|
||||||
|
|
||||||
A symbol is like an immutable string, but symbols are normally
|
A symbol is like an immutable string, but symbols are normally
|
||||||
@index["interned symbols"]{@defterm{interned}}, so that two symbols
|
@index["interned symbols"]{@defterm{interned}}, so that two symbols
|
||||||
with the same character content are normally @scheme[eq?]. All symbols
|
with the same character content are normally @scheme[eq?]. All symbols
|
||||||
|
|
|
@ -3,6 +3,8 @@
|
||||||
|
|
||||||
@title[#:tag "mz:numbers"]{Numbers}
|
@title[#:tag "mz:numbers"]{Numbers}
|
||||||
|
|
||||||
|
@guideintro["guide:numbers"]{numbers}
|
||||||
|
|
||||||
All numbers are @idefterm{complex numbers}. Some of them are
|
All numbers are @idefterm{complex numbers}. Some of them are
|
||||||
@idefterm{real numbers}, and all of the real numbers that can be
|
@idefterm{real numbers}, and all of the real numbers that can be
|
||||||
represented are also @idefterm{rational numbers}. Among the real
|
represented are also @idefterm{rational numbers}. Among the real
|
||||||
|
|
|
@ -155,6 +155,8 @@ on the next character or characters in the input stream as follows:
|
||||||
|
|
||||||
@section[#:tag "mz:parse-symbol"]{Reading Symbols}
|
@section[#:tag "mz:parse-symbol"]{Reading Symbols}
|
||||||
|
|
||||||
|
@guideintro["guide:symbols"]{the syntax of symbols}
|
||||||
|
|
||||||
A sequence that does not start with a delimiter or @litchar{#} is
|
A sequence that does not start with a delimiter or @litchar{#} is
|
||||||
parsed as either a symbol or a number (see @secref["mz:parse-number"]),
|
parsed as either a symbol or a number (see @secref["mz:parse-number"]),
|
||||||
except that @litchar{.} by itself is never parsed as a symbol or
|
except that @litchar{.} by itself is never parsed as a symbol or
|
||||||
|
@ -185,6 +187,8 @@ the following datum in case-sensitive mode.
|
||||||
|
|
||||||
@section[#:tag "mz:parse-number"]{Reading Numbers}
|
@section[#:tag "mz:parse-number"]{Reading Numbers}
|
||||||
|
|
||||||
|
@guideintro["guide:numbers"]{the syntax of numbers}
|
||||||
|
|
||||||
@index['("numbers" "parsing")]{A} sequence that does not start with a
|
@index['("numbers" "parsing")]{A} sequence that does not start with a
|
||||||
delimiter is parsed as a number when it matches the following grammar
|
delimiter is parsed as a number when it matches the following grammar
|
||||||
case-insenstively for @nonterm{number@sub{10}} (decimal), where
|
case-insenstively for @nonterm{number@sub{10}} (decimal), where
|
||||||
|
@ -348,6 +352,8 @@ then when then reader encounters @litchar["{"] and @litchar["}"], the
|
||||||
|
|
||||||
@section[#:tag "mz:parse-string"]{Reading Strings}
|
@section[#:tag "mz:parse-string"]{Reading Strings}
|
||||||
|
|
||||||
|
@guideintro["guide:strings"]{the syntax of strings}
|
||||||
|
|
||||||
@index['("strings" "parsing")]{When} the reader encouters
|
@index['("strings" "parsing")]{When} the reader encouters
|
||||||
@as-index{@litchar{"}}, it begins parsing characters to form a string. The
|
@as-index{@litchar{"}}, it begins parsing characters to form a string. The
|
||||||
string continues until it is terminated by another @litchar{"} (that
|
string continues until it is terminated by another @litchar{"} (that
|
||||||
|
@ -412,9 +418,11 @@ Within a string sequence, the following escape sequences are
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
If the reader encounteres any other use of a backslashe in a string
|
If the reader encounteres any other use of a backslash in a string
|
||||||
constant, the @exnraise[exn:fail:read].
|
constant, the @exnraise[exn:fail:read].
|
||||||
|
|
||||||
|
@guideintro["guide:bytestrings"]{the syntax of byte strings}
|
||||||
|
|
||||||
@index['("byte strings" "parsing")]{A} string constant preceded by
|
@index['("byte strings" "parsing")]{A} string constant preceded by
|
||||||
@litchar{#} is parsed as a byte-string. (That is, @as-index{@litchar{#"}} starts
|
@litchar{#} is parsed as a byte-string. (That is, @as-index{@litchar{#"}} starts
|
||||||
a byte-string literal.) See @secref["mz:bytestrings"] for
|
a byte-string literal.) See @secref["mz:bytestrings"] for
|
||||||
|
@ -578,6 +586,8 @@ content is also wraped as a syntax object.
|
||||||
|
|
||||||
@section[#:tag "mz:parse-character"]{Reading Characters}
|
@section[#:tag "mz:parse-character"]{Reading Characters}
|
||||||
|
|
||||||
|
@guideintro["guide:characters"]{the syntax of characters}
|
||||||
|
|
||||||
A @litchar["#\\"] starts a character constant, which has one of the
|
A @litchar["#\\"] starts a character constant, which has one of the
|
||||||
following forms:
|
following forms:
|
||||||
|
|
||||||
|
|
|
@ -3,6 +3,8 @@
|
||||||
|
|
||||||
@title[#:tag "mz:strings"]{Strings}
|
@title[#:tag "mz:strings"]{Strings}
|
||||||
|
|
||||||
|
@guideintro["guide:string"]{strings}
|
||||||
|
|
||||||
A @pidefterm{string} is a fixed-length arary of
|
A @pidefterm{string} is a fixed-length arary of
|
||||||
@seclink["characters"]{characters}.
|
@seclink["characters"]{characters}.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue
Block a user