xemacs-beta: man/lispref/objects.texi comparison

comparison man/lispref/objects.texi @ 380:8626e4521993 r21-2-5

Import from CVS: tag r21-2-5

author	cvs
date	Mon, 13 Aug 2007 11:07:10 +0200
parents	6240c7796c7a
children	7d59cb494b73

comparison

equal deleted inserted replaced

-:76b7d63099ad
+:8626e4521993
 @c -*-texinfo-*-
 @c This is part of the XEmacs Lisp Reference Manual.
 @c Copyright (C) 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc.
 @c See the file lispref.texi for copying conditions.
 @setfilename ../../info/objects.info
 @node Lisp Data Types, Numbers, Introduction, Top
 @chapter Lisp Data Types
 @cindex object
 A few fundamental object types are built into XEmacs.  These, from
 which all other types are constructed, are called @dfn{primitive types}.
 Each object belongs to one and only one primitive type.  These types
 include @dfn{integer}, @dfn{character} (starting with XEmacs 20.0),
 @dfn{float}, @dfn{cons}, @dfn{symbol}, @dfn{string}, @dfn{vector},
-@dfn{bit-vector}, @dfn{subr}, @dfn{compiled-function}, @dfn{hashtable},
+@dfn{bit-vector}, @dfn{subr}, @dfn{compiled-function}, @dfn{hash-table},
 @dfn{range-table}, @dfn{char-table}, @dfn{weak-list}, and several
 special types, such as @dfn{buffer}, that are related to editing.
 (@xref{Editing Types}.)
 Each primitive type has a corresponding Lisp function that checks
 @item
 frame
 @item
 glyph
 @item
-hashtable
+hash-table
 @item
 image-instance
 @item
 integer
 @item
 provides for characters.
 The usual read syntax for alphanumeric characters is a question mark
 followed by the character; thus, @samp{?A} for the character
 @kbd{A}, @samp{?B} for the character @kbd{B}, and @samp{?a} for the
 character @kbd{a}.
 For example:
 @example
 ;; @r{Under XEmacs 20:}
 @example
 "It is useful to include newlines
 in documentation strings,
 but the newline is \
 ignored if escaped."
 @result{} "It is useful to include newlines
 in documentation strings,
 but the newline is ignored if escaped."
 @end example
 A string can hold extents and properties of the text it contains, in
 addition to the characters themselves.  This enables programs that copy
 one Lisp object to another, using an internal indexing method
 called @dfn{hashing}.  Hash tables are very fast (much more efficient
 that using an association list, when there are a large number of
 elements in the table).
-Hash tables have no read syntax.  They print in hash notation (The
+Hash tables have a special read syntax beginning with
-``hash'' in ``hash notation'' has nothing to do with the ``hash'' in
+@samp{#s(hash-table} (this is an example of @dfn{structure} read
-``hash table''), giving the number of elements, total space allocated
+syntax.  This notation is also used for printing when
-for elements, and a unique number assigned at the time the hash table
+@code{print-readably} is @code{t}.
-was created. (Hash tables automatically resize as necessary so there
-is no danger of running out of space for elements.)
+Otherwise they print in hash notation (The ``hash'' in ``hash notation''
+has nothing to do with the ``hash'' in ``hash table''), giving the
-@example
+number of elements, total space allocated for elements, and a unique
-@group
+number assigned at the time the hash table was created. (Hash tables
-(make-hashtable 50)
+automatically resize as necessary so there is no danger of running out
-@result{} #<hashtable 0/71 0x313a>
+of space for elements.)
+@example
+@group
+(make-hash-table :size 50)
+@result{} #<hash-table 0/107 0x313a>
 @end group
 @end example
 @xref{Hash Tables}, for information on how to create and work with hash
 tables.
 @xref{Specifier Types, generic-specifier-p}.
 @item glyphp
 @xref{Glyphs, glyphp}.
-@item hashtablep
+@item hash-table-p
-@xref{Hash Tables, hashtablep}.
+@xref{Hash Tables, hash-table-p}.
 @item icon-glyph-p
 @xref{Glyph Types, icon-glyph-p}.
 @item image-instance-p
 @var{object}.  The value is one of @code{bit-vector}, @code{buffer},
 @code{char-table}, @code{character}, @code{charset},
 @code{coding-system}, @code{cons}, @code{color-instance},
 @code{compiled-function}, @code{console}, @code{database},
 @code{device}, @code{event}, @code{extent}, @code{face}, @code{float},
-@code{font-instance}, @code{frame}, @code{glyph}, @code{hashtable},
+@code{font-instance}, @code{frame}, @code{glyph}, @code{hash-table},
 @code{image-instance}, @code{integer}, @code{keymap}, @code{marker},
 @code{process}, @code{range-table}, @code{specifier}, @code{string},
 @code{subr}, @code{subwindow}, @code{symbol}, @code{toolbar-button},
 @code{tooltalk-message}, @code{tooltalk-pattern}, @code{vector},
 @code{weak-list}, @code{window}, @code{window-configuration}, or

Mercurial > hg > xemacs-beta

comparison man/lispref/objects.texi @ 380:8626e4521993 r21-2-5