Mercurial > hg > xemacs-beta
comparison man/lispref/sequences.texi @ 5361:62b9ef1ed4ac
Change "special form" to "special operator" in the manuals, too
2011-03-01 Aidan Kehoe <kehoea@parhasard.net>
* lispref/commands.texi (Using Interactive):
* lispref/compile.texi (Eval During Compile):
* lispref/compile.texi (Compiled-Function Objects):
* lispref/control.texi (Sequencing):
* lispref/control.texi (Conditionals):
* lispref/control.texi (Combining Conditions):
* lispref/control.texi (Iteration):
* lispref/control.texi (Catch and Throw):
* lispref/control.texi (Handling Errors):
* lispref/control.texi (Cleanups):
* lispref/display.texi (Temporary Displays):
* lispref/eval.texi (Quoting):
* lispref/eval.texi (Multiple values):
* lispref/frames.texi (Input Focus):
* lispref/functions.texi (Argument List):
* lispref/functions.texi (Defining Functions):
* lispref/functions.texi (Anonymous Functions):
* lispref/internationalization.texi (Level 3 Primitives):
* lispref/internationalization.texi (Domain Specification):
* lispref/intro.texi (A Sample Function Description):
* lispref/intro.texi (A Sample Variable Description):
* lispref/lists.texi (Sets And Lists):
* lispref/macros.texi (Defining Macros):
* lispref/macros.texi (Backquote):
* lispref/positions.texi (Excursions):
* lispref/positions.texi (Narrowing):
* lispref/searching.texi (Saving Match Data):
* lispref/sequences.texi (Sequence Functions):
* lispref/sequences.texi (Array Functions):
* lispref/specifiers.texi (Adding Specifications):
* lispref/variables.texi (Local Variables):
* lispref/variables.texi (Defining Variables):
* lispref/variables.texi (Setting Variables):
* lispref/variables.texi (Default Value):
* lispref/windows.texi (Selecting Windows):
* lispref/windows.texi (Window Configurations):
No longer use @defspec, since we no longer use the term "special
form"; instead use @deffn {Special Operator}. Unfortunately
there's no way in texinfo to redefine @defspec in one place.
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Tue, 01 Mar 2011 14:18:45 +0000 |
| parents | 576fb035e263 |
| children | 9fae6227ede5 |
comparison
equal
deleted
inserted
replaced
| 5359:f5a5501814f5 | 5361:62b9ef1ed4ac |
|---|---|
| 217 | 217 |
| 218 This function generalizes @code{aref} (@pxref{Array Functions}) and | 218 This function generalizes @code{aref} (@pxref{Array Functions}) and |
| 219 @code{nth} (@pxref{List Elements}). | 219 @code{nth} (@pxref{List Elements}). |
| 220 @end defun | 220 @end defun |
| 221 | 221 |
| 222 @defun fill sequence object @t{&key :start :end} | |
| 223 This function fills the sequence @var{sequence} with @var{object}, so | |
| 224 that each element of @var{sequence} between the indices specified by | |
| 225 @code{:start} (inclusive) and @code{:end} (exclusive), is @var{object}. | |
| 226 It returns @var{sequence}. | |
| 227 | |
| 228 @example | |
| 229 @group | |
| 230 (setq a [a b c d e f g]) | |
| 231 @result{} [a b c d e f g] | |
| 232 (fill a 0 :end 2) | |
| 233 @result{} [0 0 c d e f g] | |
| 234 (fill a 0) | |
| 235 @result{} [0 0 0 0 0 0 0] | |
| 236 a | |
| 237 @result{} [0 0 0 0 0 0 0] | |
| 238 @end group | |
| 239 | |
| 240 @group | |
| 241 (setq s "When in the course") | |
| 242 @result{} "When in the course" | |
| 243 (fill s ?-) | |
| 244 @result{} "------------------" | |
| 245 @end group | |
| 246 | |
| 247 @group | |
| 248 (setq bv #*1101) | |
| 249 @result{} #*1101 | |
| 250 (fill bv 0) | |
| 251 @result{} #*0000 | |
| 252 @end group | |
| 253 @end example | |
| 254 | |
| 255 If @var{sequence} is of a type that cannot hold @var{object} ( | |
| 256 bit-vector can only hold the integers one or zero, strings can only hold | |
| 257 characters) a @code{wrong-type-argument} error results. | |
| 258 @end defun | |
| 259 | |
| 222 @node Arrays | 260 @node Arrays |
| 223 @section Arrays | 261 @section Arrays |
| 224 @cindex array | 262 @cindex array |
| 225 | 263 |
| 226 An @dfn{array} object has slots that hold a number of other Lisp | 264 An @dfn{array} object has slots that hold a number of other Lisp |
| 378 @result{} #*1111 | 416 @result{} #*1111 |
| 379 (aset bv 2 0) | 417 (aset bv 2 0) |
| 380 @result{} 0 | 418 @result{} 0 |
| 381 bv | 419 bv |
| 382 @result{} #*1101 | 420 @result{} #*1101 |
| 383 @end group | |
| 384 @end example | |
| 385 | |
| 386 If @var{array} is a string and @var{object} is not a character, a | |
| 387 @code{wrong-type-argument} error results. | |
| 388 @end defun | |
| 389 | |
| 390 @defun fillarray array object | |
| 391 This function fills the array @var{array} with @var{object}, so that | |
| 392 each element of @var{array} is @var{object}. It returns @var{array}. | |
| 393 | |
| 394 @example | |
| 395 @group | |
| 396 (setq a [a b c d e f g]) | |
| 397 @result{} [a b c d e f g] | |
| 398 (fillarray a 0) | |
| 399 @result{} [0 0 0 0 0 0 0] | |
| 400 a | |
| 401 @result{} [0 0 0 0 0 0 0] | |
| 402 @end group | |
| 403 | |
| 404 @group | |
| 405 (setq s "When in the course") | |
| 406 @result{} "When in the course" | |
| 407 (fillarray s ?-) | |
| 408 @result{} "------------------" | |
| 409 @end group | |
| 410 | |
| 411 @group | |
| 412 (setq bv #*1101) | |
| 413 @result{} #*1101 | |
| 414 (fillarray bv 0) | |
| 415 @result{} #*0000 | |
| 416 @end group | 421 @end group |
| 417 @end example | 422 @end example |
| 418 | 423 |
| 419 If @var{array} is a string and @var{object} is not a character, a | 424 If @var{array} is a string and @var{object} is not a character, a |
| 420 @code{wrong-type-argument} error results. | 425 @code{wrong-type-argument} error results. |