home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / cug / softt-12.lbr / VTOC.DQC / VTOC.DOC
Encoding:
Text File  |  1984-07-05  |  1.0 KB  |  39 lines
  1. .he 'VTOC'03/23/80'VTOC'
  2. NAME
  3. .sp
  4. vtoc - convert PL/I varying string to EOS-terminated string
  5. .sp 2
  6. SYNOPSIS
  7. .sp
  8. .nf
  9. integer function vtoc (var, str, len)
  10. integer var (ARB), len
  11. character str (ARB)
  12. .sp 2
  13. .fi
  14. DESCRIPTION
  15. .sp
  16. 'Vtoc' is used to convert a PL/I character-varying string into a
  17. standard Subsystem EOS-terminated string.
  18. The first argument is the character-varying string to be converted;
  19. the second is a string to receive the result;
  20. the third is the maximum length of the result string.
  21. The function return is the number of characters in the result string
  22. after the conversion.
  23. .sp 2
  24. IMPLEMENTATION
  25. .sp
  26. 'Vtoc' uses the standard Subsystem macro 'fpchar' to pull characters
  27. from the PL/I string one at a time, and place them in the result
  28. string.
  29. Conversion stops when the result string fills or when all the
  30. characters in the PL/I string have been moved.
  31. .sp 2
  32. ARGUMENTS MODIFIED
  33. .sp
  34. str
  35. .sp 2
  36. SEE ALSO
  37. .sp
  38. other conversion routines ('cto?*' and '?*toc') (2)
  39.