core/classes/builtin/builtin-docs.factor

   1 USING: help.syntax help.markup classes layouts ;
   2 IN: classes.builtin
   3
   4 ARTICLE: "builtin-classes" "Built-in classes"
   5 "Every object is an instance of exactly one canonical " { $emphasis "built-in class" } " which defines its layout in memory and basic behavior."
   6 $nl
   7 "The set of built-in classes is a class:"
   8 { $subsection builtin-class }
   9 { $subsection builtin-class? }
  10 "See " { $link "type-index" } " for a list of built-in classes." ;
  11
  12 HELP: builtin-class
  13 { $class-description "The class of built-in classes." }
  14 { $examples
  15     "The class of arrays is a built-in class:"
  16     { $example "USING: arrays classes.builtin prettyprint ;" "array builtin-class? ." "t" }
  17     "However, an instance of the array class is not a built-in class; it is not even a class:"
  18     { $example "USING: classes.builtin prettyprint ;" "{ 1 2 3 } builtin-class? ." "f" }
  19 } ;
  20
  21 HELP: builtins
  22 { $var-description "Vector mapping type numbers to builtin class words." } ;
  23
  24 HELP: type>class
  25 { $values { "n" "a non-negative integer" } { "class" class } }
  26 { $description "Outputs a builtin class whose instances are precisely those having a given pointer tag." }
  27 { $notes "The parameter " { $snippet "n" } " must be between 0 and the return value of " { $link num-types } "." } ;
  28