home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / cug / softt-12.lbr / SETCREAT.DQC / SETCREAT.DOC
Text File  |  1984-07-05  |  1KB  |  53 lines
  1. .he 'SET_CREATE'03/23/80'SET_CREATE'
  2. NAME
  3. .sp
  4. set_create - generate a new, initially empty set
  5. .sp 2
  6. SYNOPSIS
  7. .sp
  8. .nf
  9. pointer function set_create (set, size)
  10. pointer set
  11. integer size
  12. .sp 2
  13. .fi
  14. DESCRIPTION
  15. .sp
  16. 'Set_create' is used to create a Pascal-style bit vector representation
  17. for a set of integers from 1 to 'size'.
  18. The function return and the variable 'set' are set to the address
  19. in dynamic storage of the newly-created set.
  20. .sp
  21. All set manipulation routines make use of dynamic storage,
  22. which must be initialized before use.
  23. See 'dsinit' for further information.
  24. .sp
  25. Note that all set manipulation routines have long names.
  26. To avoid unique name conflicts with other routines, any Ratfor
  27. program using the set routines should include the following
  28. statement:
  29. .sp
  30. .ti +5
  31. include "=src=/lcl/lib/swtmlb.u/swtmlb_link.r.i"
  32. .sp 2
  33. IMPLEMENTATION
  34. .sp
  35. 'Set_create' calls 'dsget' to obtain a contiguous array of 16-bit
  36. words that is large enough to represent a bit vector with 'size'
  37. elements.
  38. The first word of this array is set to 'size' for use by other
  39. set manipulation routines.
  40. A call to 'set_init' then insures that the new set is empty.
  41. .sp 2
  42. ARGUMENTS MODIFIED
  43. .sp
  44. set
  45. .sp 2
  46. CALLS
  47. .sp
  48. dsget, set_init
  49. .sp 2
  50. SEE ALSO
  51. .sp
  52. other set routines ('set_?*') (4)
  53.