home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / cug / softt-3.lbr / ADDSTR.DOC < prev    next >
Text File  |  1984-07-05  |  896b  |  47 lines
  1. .bp 1
  2. .in 0
  3. .he 'ADDSTR (2)'7/23/80'ADDSTR (2)'
  4. .fo ''-#-''
  5. .fi
  6. .in 7
  7. .ti -7
  8. NAME
  9. .br
  10. addstr - add string s to str(j) if it fits, increment j
  11. .sp 1
  12. .ti -7
  13. SYNOPSIS
  14. .br
  15. .nf
  16. stat = addstr(s, array, j, maxsize)
  17.  
  18. character s(ARB), array(ARB)
  19. integer j                 # j is incremented
  20. integer maxsize
  21. integer stat returned as YES/NO
  22. .fi
  23. .sp 1
  24. .ti -7
  25. DESCRIPTION
  26. .br
  27. Copies the string 's' to array 'str', starting in location 'j'.
  28. J is incremented to point to the next free position in 'str'.
  29.  
  30. If the addition of s to str will exceed its maximum length (maxsize),
  31. no copying is done and the status NO is returned.
  32.  
  33. Both s and str are ascii character arrays stored one character per
  34. array element.
  35.  
  36. YES is returned if the routine succeeded, otherwise NO.
  37. .sp 1
  38. .ti -7
  39. SEE ALSO
  40. .br
  41. scopy, stcopy, addset, concat
  42. .sp 1
  43. .ti -7
  44. DIAGNOSTICS
  45. .br
  46. None
  47.