home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 13 / CDA13.ISO / cdactual / demobin / share / program / C / AECLIP3.ZIP / AECLIP3.DOC next >
Encoding:
Text File  |  1989-06-10  |  6.0 KB  |  216 lines
  1.  
  2.  
  3.                AECLIP3.LIB - Copyright 1989, Auto Exec Inc.
  4.                             ALL RIGHTS RESERVED                                        
  5.  
  6.                     Auto Exec BBS (508) 833-0508                
  7.           3 Nodes, All US Robotics 9600 HST's, 750 Meg On-Line  
  8.             Only Reg Req'd to D/L up to 450,000 bytes per day   
  9.              PcBoard Version 14.0/E3, Novel SFT 2.11 Network     
  10.  
  11.   AECLIPT.LIB is distributed as a shareware product of Auto Exec Inc.
  12.   The library included is fully functional stand alone with no external
  13.   libraries required.  There are 15 functions written in 'C' for you to
  14.   be able to add to your programs.  Access to the functions is by including
  15.   AECLIP3.LIB in your link command.                   
  16.  
  17.  
  18.   Donations of $5 would be appreciated to allow continued development of
  19.   shareware clipper addon functions:  Donations should be sent to:
  20.  
  21.                                     Auto Exec Inc.
  22.                                     P.O. Box 1712
  23.                                     Buzzards Bay, MA  02532
  24.  
  25.   The author of this library is Milton F. Shaw Jr.
  26.  
  27.  
  28.                              DISCLAIMER
  29.  
  30.   I make no warranty of any kind, express or implied, including without
  31.   limitation, any warranties of merchantability and/or fitness for a 
  32.   particular purpose.  Milton F. Shaw Jr. and Auto Exec Inc. shall not
  33.   be liable for any damages, whether direct, indirect, special or 
  34.   consequential arising from a failure of this program or the functions
  35.   contained in AECLIP3.LIB.  Milton F. Shaw Jr. and Auto Exec Inc. shall
  36.   not be liable for any damage to data or property which may be caused
  37.   directly or indirectly by the use of this program or the functions 
  38.   contained in AECLIP3.LIB.
  39.  
  40.   In no event will Milton F. Shaw Jr. or Auto Exec Inc., be liable to
  41.   you for any damages, including lost profits, lost savings or other
  42.   incidental or consequential damages arising use or inability to use
  43.   this product or for any claim by any other party.
  44.  
  45.   Files you should have:
  46.  
  47.   AEDEMO3.EXE
  48.   AECLIP3.DOC
  49.   AECLIP3.LIB
  50.  
  51.                    Auto Exec Inc - Miscellaneous C Functions
  52.  
  53.                                 15 Functions
  54.  
  55.  
  56.  
  57.  
  58.   Functions in AECLIP3.LIB:
  59.  
  60.  
  61.   Linking - I have tested MSC 5.1, TLINK and PLINK86 compilers to link 
  62.   AECLIP3.LIB with clipper applications.  The commands I use:
  63.  
  64.       Link /NOE /STACK:0x4000 <program>,,,clipper+extend+aeclip3
  65.       TLINK <program>,,,CLIPPER+EXTEND+AECLIP3
  66.       PLINK86 FI <program> lib CLIPPER,EXTEND,AECLIP3
  67.  
  68.                           Function Descriptions
  69.  
  70. --------------------------------------------------------------------------
  71.   TmpName()
  72.  
  73.   Purpose: Returns a unique temporary filename
  74.  
  75.   Syntax: x=TmpName()
  76.  
  77.   Returns: Character String
  78.  
  79. --------------------------------------------------------------------------
  80.   SetTime()
  81.  
  82.   Purpose: Set System Time
  83.  
  84.   Syntax:  SetTime(hour,min,sec), where
  85.  
  86.            hour,min,sec are integers
  87.  
  88.   Returns: None
  89.  
  90. --------------------------------------------------------------------------
  91.   SetDate()
  92.  
  93.   Purpose: Set System Date
  94.  
  95.   Usage:  SetDate(day,month,year), where
  96.          
  97.           day,month,year are integers
  98.  
  99.   Returns: None
  100.  
  101. --------------------------------------------------------------------------
  102.   GetSecs()
  103.  
  104.   Purpose: Returns present seconds from system time
  105.  
  106.   Syntax: x=GetSecs()
  107.  
  108.   Returns: Number
  109.  
  110. --------------------------------------------------------------------------
  111.   GetMins() 
  112.  
  113.   Purpose: Returns present minutes from system time
  114.  
  115.   Syntax:  x=GetMins()
  116.  
  117.   Returns: Number
  118.  
  119. --------------------------------------------------------------------------
  120.   GetHours()
  121.  
  122.   Purpose: Returns present hour from system time
  123.  
  124.   Syntax: x=GetHours()
  125.  
  126.   Returns: Number
  127.  
  128. --------------------------------------------------------------------------
  129.   Access()
  130.  
  131.   Purpose: Allows checking of file attributes before using
  132.  
  133.   Syntax: Access(filename,code) where,
  134.  
  135.           filename = full pathname if not in default directory
  136.           code     = 00 to check for existence
  137.                      02 to check for write permission
  138.                      04 to check for read permission
  139.                      06 to check for read/write permission
  140.  
  141.           code is an integer, filename is a character string
  142.  
  143.   Returns: -1 if false, else 0 if true
  144.  
  145. --------------------------------------------------------------------------
  146.   PrntScn()
  147.  
  148.   Purpose: Do a print screen
  149.  
  150.   Syntax:  PrntScn()
  151.  
  152.   Returns: None
  153. --------------------------------------------------------------------------
  154.   FSearch()
  155.  
  156.   Purpose: Check existence of a filename in the DOS path
  157.  
  158.   Syntax : FSearch(filename)
  159.  
  160.   Returns: Logical
  161.  
  162. --------------------------------------------------------------------------
  163.   IsCtrl()
  164.  
  165.   Purpose: Returns if a character sent is a control character
  166.  
  167.   Syntax:  IsCtrl(asc(<character>))
  168.  
  169.   Returns: logical
  170.  
  171. --------------------------------------------------------------------------
  172.   IsDigit()
  173.  
  174.   Purpose: Returns if a character sent is a digit
  175.  
  176.   Syntax:  IsDigit(asc(<character>))
  177.  
  178.   Returns: Logical
  179.  
  180. --------------------------------------------------------------------------
  181.   IsPrnt() 
  182.  
  183.   Purpose:  Returns if a character sent is printable
  184.  
  185.   Usage:  IsPrnt(asc(<character>))
  186.  
  187.   Returns: Logical
  188.  
  189. --------------------------------------------------------------------------
  190.   IsPunct()
  191.  
  192.   Purpose: Returns if a character is a punctuation mark
  193.  
  194.   Syntax:  IsPunct(asc(<character>))
  195.  
  196.   Returns: Logical
  197.  
  198. --------------------------------------------------------------------------
  199.   IsSpace()
  200.  
  201.   Purpose:  Returns if a character sent is a space
  202.  
  203.   Usage:  IsSpace()
  204.  
  205.   Returns: Logical
  206.  
  207. --------------------------------------------------------------------------
  208.   StrRev()
  209.  
  210.   Purpose:  Reverse the order of characters in a string
  211.  
  212.   Syntax: StrRev(<character string>)
  213.  
  214.   Returns: Character string
  215. --------------------------------------------------------------------------
  216.