home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / cug / softt-3.lbr / CTOC.DQC / CTOC.DOC
Encoding:
Text File  |  1984-07-05  |  1.3 KB  |  80 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 CTOC 03/23/80
  58. copy string-to-string, observing length limits
  59. .sy
  60. integer function ctoc (from, to, len)
  61. integer len
  62. character from (ARB), to (len)
  63. .fs
  64. 'Ctoc' copies an EOS-terminated unpacked string from one array to
  65. another, observing a maximum-length constraint on the destination array.
  66. The function return is the number of characters copied (i.e., the
  67. length of the string in the parameter 'to').
  68. .sp
  69. Note that the other string copy routine, 'scopy', is not protected;
  70. if the length of the source string exceeds the space available in the
  71. destination string, some portion of memory will be garbled.
  72. .im
  73. A simple loop copies characters from 'from' to 'to' until
  74. an EOS is encountered or all the space available in the destination
  75. array is used up.
  76. .am
  77. to
  78. .sa
  79. scopy (2), other conversion routines ('cto?*' and '?*toc') (2)
  80.