home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff281.lzh / FarPrint / FarFunctions < prev    next >
Text File  |  1989-11-20  |  2KB  |  94 lines
  1.  
  2.                                   1
  3.  
  4. NAME
  5.     SendText - Send a text to FarPrint main process
  6.  
  7. SYNOPSIS
  8.     Success = SendText(Formatstring,arg1, arg2 , ..., argn);
  9.  
  10. FUNCTION
  11.     SendText transmits a text to the FarPrint main process
  12.     to be recorded and displayed. SendText is called like
  13.     the standard printf() 'C' function with all its
  14.     limitations and advantages. Since the exec function
  15.     RawDoFmt() is employed, all %d and %x symbols have
  16.     to be prefixed %ld and %lx. See the description of
  17.     RawDoFmt() for a more thorougly description.
  18.  
  19. INPUTS
  20.     Formatstring = Pointer to a string
  21.     arg1 - argn  = The values to be printed
  22.  
  23. RESULT
  24.  
  25.     Success = FarPrint port was found and message
  26.               successfully transmitted.
  27.  
  28. BUGS
  29.     None known.
  30.  
  31. SEE ALSO
  32.     printf(), RawDoFmt()
  33.  
  34.                                   2
  35.  
  36. NAME
  37.     RequestNumber - Get a number from FarPrint main process
  38.  
  39. SYNOPSIS
  40.     Number = RequestNumber(Identifier);
  41.  
  42. FUNCTION
  43.     RequestNumber() tries to obtain a numeric value from the
  44.     FarPrint main process. This may take some time since
  45.     FarPrint may be busy processing other inputs. If the
  46.     FarPrint communication port cannot be found this function
  47.     returns immediately with a return value of 0.
  48.  
  49. INPUTS
  50.     Identifier = Pointer to null terminated string containing
  51.                  Name of the caller so user knows who it is
  52.                  who wants a number.
  53.  
  54. RESULT
  55.  
  56.     Number = The numeric value entered by the user.
  57.  
  58. BUGS
  59.     None known.
  60.  
  61. SEE ALSO
  62.  
  63.  
  64.                                   3
  65.  
  66. NAME
  67.     RequestString - Get a string from FarPrint main process
  68.  
  69. SYNOPSIS
  70.     String = RequestString(Identifier);
  71.  
  72. FUNCTION
  73.     RequestNumber() tries to obtain an 80 character string
  74.     from the FarPrint main process. This may take some time since
  75.     FarPrint may be busy processing other inputs. If the
  76.     FarPrint communication port cannot be found this function
  77.     returns immediately with a return value of NULL.
  78.  
  79. INPUTS
  80.     Identifier = Pointer to null terminated string containing
  81.                  Name of the caller so user knows who it is
  82.                  who wants a string.
  83.  
  84. RESULT
  85.  
  86.     String = The string value entered by the user, or NULL
  87.              if FarPrint port was not to be located.
  88.  
  89. BUGS
  90.     Not reentrant, uses its own static character buffer.
  91.  
  92. SEE ALSO
  93.  
  94.