home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / cug / softt-3.lbr / ENTER.DQC / ENTER.DOC
Text File  |  1984-07-05  |  2KB  |  91 lines
  1. .de hd
  2. .bp 1
  3. .in 0
  4. .he '$1 (2)'$2'$1 (2)'
  5. .fo ''-#-''
  6. .fi
  7. .in 7
  8. .ti -7
  9. NAME
  10. .br
  11. $1 -
  12. .en
  13. .de sy
  14. .sp 1
  15. .ti -7
  16. SYNOPSIS
  17. .br
  18. .nf
  19. .en
  20. .de fs
  21. .fi
  22. .sp
  23. .ti -7
  24. DESCRIPTION
  25. .br
  26. .en
  27. .de im
  28. .sp
  29. .ti -7
  30. IMPLEMENTATION
  31. .br
  32. .en
  33. .de sa
  34. .sp
  35. .ti -7
  36. SEE ALSO
  37. .br
  38. .en
  39. .de am
  40. .sp
  41. .ti -7
  42. ARGUMENTS MODIFIED
  43. .br
  44. .en
  45. .de ca
  46. .sp
  47. .ti -7
  48. CALLS
  49. .br
  50. .en
  51. .de bu
  52. .sp
  53. .ti -7
  54. BUGS
  55. .br
  56. .en
  57. .hd ENTER 03/23/80
  58. place symbol in symbol table
  59. .sy
  60. subroutine enter (symbol, info, table)
  61. character symbol (ARB)
  62. integer info (ARB)
  63. pointer table
  64. .fs
  65. 'Enter' places the character-string symbol given as its first argument,
  66. along with the information given in its second argument, into the symbol
  67. table given as its third argument.
  68. .sp
  69. The symbol table used must have been created by the routine 'mktabl'.
  70. The size of the info array must be at least as large as the symbol
  71. table node size, determined at table creation time.
  72. .sp
  73. Should the given symbol already be present in the symbol table,
  74. its information field will simply be overwritten with the new information.
  75. .sp
  76. 'Enter' uses the dynamic storage management routines, which
  77. require initialization by the user; see 'dsinit' for further details.
  78. .im
  79. 'Enter' calls 'stlu' to find the proper location for the symbol.
  80. If the symbol is not present in the table, a call to 'dsget' fetches
  81. a block of memory of sufficient size, which is then linked onto the
  82. proper chain from the hash table.
  83. Once the location of the node for the given symbol is known, the
  84. contents of the information array are copied into the node's information
  85. field.
  86. .ca
  87. stlu, dsget
  88. .sa
  89. lookup (2), delete (2), mktabl (2), rmtabl (2), stlu (2),
  90. dsget (2), dsfree (2), dsinit (2), sctabl (2)
  91.