home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / CLIPPER / CRLIB3 / CRLIB.DOC next >
Text File  |  1992-12-26  |  22KB  |  865 lines
  1.  
  2.  
  3.   CRLIB.DOC -  Documentation of the functions contained in CRLIB.LIB 
  4.  
  5.                         TABLE OF CONTENTS 
  6.  
  7.  
  8.  
  9.    A. Graphics Functions 
  10.  
  11.         DESKTOP()...................................1 
  12.         VIDEOSET()..................................3 
  13.         GRCOLR()....................................3 
  14.         GRBKCOLR()..................................4 
  15.         PIXL()......................................5 
  16.         RECTANGL()..................................6 
  17.         SPHERE()....................................6
  18.         PIE().......................................7 
  19.         CURPOS()....................................8 
  20.         LINEDRAW()..................................8 
  21.         GRMOVSCR()..................................9 
  22.         GRSCR2FI()..................................9 
  23.         GRFI2SCR().................................10 
  24.         GRTEXT()...................................11
  25.  
  26.    B. Database Functions. 
  27.  
  28.         DBFIX()....................................11 
  29.         RELPOS()...................................11 
  30.         SECURDB()..................................12 
  31.  
  32.  
  33.    C. Time and Date functions 
  34.  
  35.         GETFTIME().................................13 
  36.         FTIMEVAR().................................13 
  37.         SETFTIME().................................14 
  38.         TIMESTAMP()................................14 
  39.  
  40.    D. Miscellaneous Functions. 
  41.  
  42.         CRCHECK()..................................15 
  43.         CURSIZER().................................15 
  44.         FLOATPT()..................................15 
  45.         SCR2FIL()..................................16 
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.   
  54.                                 Page 1
  55.  
  56. I.  CRLIB.DOC -  Documentation of the functions contained in CRLIB.LIB 
  57.  
  58.  
  59. 1. Graphics Functions 
  60. __________________________ 
  61.  
  62. DESKTOP() 
  63.  
  64. Purpose:  To create a desktop menu in graphics mode with a special 
  65.           background shading not available in text mode with most 
  66.           graphic adapters. 
  67.  
  68. Syntax :  DESCKTOP([<expC1>] [,<expC2>] [,..<expCN] [,<arrayA1>] [,<arrayA2>] 
  69.            [,<...arrayAN>] [,<arrayB1>] [,..arrayBN>] [,<expCx>]) 
  70.  
  71. Return :  A string corresponding to the chosen main menu and pulldown menu  
  72.           items. 
  73.  
  74. Note   :  <expC1..<expCN> are the main menu items passed.  The number passed 
  75.           is constrained by the sum of the number of characters contained in 
  76.           all of the items plus a needed space between each item.  This sum 
  77.           should not exceed the available horizontal desktop space.  
  78.           <arrayA1..arrayAN> contain the pulldown window items. <ArrayA1> 
  79.           corressponds to <expC1>, <arrayA2> to <expC2>, etc..  A maximum of  
  80.           eleven items per pulldown window is allowed.  If no pulldown window 
  81.           is needed for a main menu item, declare the related array to hold  
  82.           one item containing the character, 'b' n quotes. 
  83.           <arrayB1..arrayBN> (optional) contain color settings for the 
  84.           menu system components.  The chart below illustrates the 
  85.           relationship between the array elements and the color settings.  
  86.           If no parameter is included note the default colors.  
  87.      
  88.            Array Element     Menu Component        Default Value 
  89.            -------------     --------------        ------------- 
  90.             1               Pixels                    11 
  91.             2               Background                 0 
  92.             3               Bar                        1 
  93.             4               Text                       5 
  94.             5               Window Frame              15 
  95.             6               Window Background          0 
  96.             7               Prompt                    15 
  97.   
  98.                     Color Chart 
  99.                 ----------- 
  100.                0 - Black     8 - Dark gray 
  101.                1 - Blue      9 - Light blue 
  102.                2 - Green    10 - Light green 
  103.                3 - Cyan     11 - Light cyan 
  104.                4 - Red      12 - Light red 
  105.                5 - Magenta  13 - Light magenta 
  106.                6 - Brown    14 - Yellow 
  107.                7 - White    15 - Bright white 
  108.                               Page 2 
  109.  
  110.    The last parameter, <ExpCx> (optional) contains any desired copywrite 
  111.    or status bar message. 
  112.  
  113.  
  114.  
  115. Example: 
  116.  
  117. DECLARE ITEM1[1], ITEM2[1], ITEM3[5], ITEM4[3], ITEM5[1], COLR[7] 
  118.  
  119. ITEM1[1] = 'b' 
  120. ITEM2[1] = 'b' 
  121. ITEM3[1] = 'Inventory List' 
  122. ITEM3[2] = 'Sales Quotas' 
  123. ITEM3[3] = 'Regional Sales' 
  124. ITEM3[4] = 'Sales Per Period' 
  125. ITEM3[5] = 'Annual Sales Summary' 
  126. ITEM4[1] = 'Reindex' 
  127. ITEM4[2] = 'Delete' 
  128. ITEM4[3] = 'Archive' 
  129. ITEM5[1] = 'b' 
  130.  
  131. COLR[1] =    9 
  132. COLR[2] =    0 
  133. COLR[3] =    1 
  134. COLR[4] =    4 
  135. COLR[5] =   14 
  136. COLR[6] =    0 
  137. COLR[7] =   14 
  138.  
  139.  
  140. Choice = DESKTOP('Edit','Add','Reports','Utilities','Quit',; 
  141. ITEM1,ITEM2,ITEM3,ITEM4,ITEM5,COLR,'Demo Version Only') 
  142.  
  143. DO CASE 
  144.      CASE Choice == '1' 
  145.        DO EDIT_PROC 
  146.      CASE Choice == '31' &&Main menu option 3, pulldown choice 1 
  147.          DO RPTINV 
  148.      CASE Choice == '32' &&Main menu option 3, pulldown choice 2 
  149.     DO RPTQUOTA 
  150.        ..... 
  151.        ..... 
  152.  
  153. Result:  Choice will be a concatenated string representing the selected 
  154.          main menu item plus the pulldown window selection (if any). 
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.                               Page 3     
  162.  
  163. VIDEOSET() 
  164.  
  165. Purpose :  Sets video mode from text to graphics or vice versa. 
  166.  
  167. Syntax  :  VIDEOSET([<expN>]) 
  168.  
  169. Argument:  <expN> if set to 1 turns on graphics mode.  Set <expN> to 
  170.            0 to return to text mode. 
  171.  
  172. Note    :  Clipper can operate in graphics mode, however you cannot 
  173.            use @..SAY, @..GET, or any screen display commands or 
  174.            functions unless you are in text mode.  You want to go 
  175.            into graphics mode to use the graphics functions listed  
  176.        below.   
  177.  
  178.  
  179. example :  
  180.  
  181. VIDEOSET(1)  &&& Turns on graphics mode 
  182.  
  183. SPHERE(x1,y1,x2,y2)  &&& Draw a sphere 
  184. .... 
  185. .... 
  186. .... 
  187.  
  188. VIDEOSET(0)  &&& Return to text mode 
  189.  
  190. ________________ 
  191.  
  192.  
  193. GRCOLR() 
  194.  
  195. Purpose :  Sets foreground color in graphics mode. 
  196.  
  197. Syntax  :  GRCOLR([<expN>]) 
  198.  
  199. Argument:  <expN> can be set to any of the color values listed  
  200.            below to achieve the respective color. 
  201.  
  202.                 Color Chart 
  203.             ----------- 
  204.            0 - Black     8 - Dark gray 
  205.            1 - Blue      9 - Light blue 
  206.            2 - Green    10 - Light green 
  207.            3 - Cyan     11 - Light cyan 
  208.            4 - Red      12 - Light red 
  209.            5 - Magenta  13 - Light magenta 
  210.            6 - Brown    14 - Yellow 
  211.            7 - White    15 - Bright white 
  212.  
  213.  
  214.  
  215.                                Page 4
  216.  
  217. Example:    
  218.  
  219. VIDEOSET(1) 
  220. GRCOLR(14)  &&Set foreground color to yellow 
  221.  
  222. Returns :  Nothing. 
  223.  
  224.  
  225. ______________________ 
  226.  
  227. GRBKCOLR() 
  228.  
  229. Purpose :  Sets background color in graphics mode. 
  230.  
  231. Syntax  :  GRBKCOLR([<expN>]) 
  232.  
  233. Argument:  <expN> can be set to any of the color values listed  
  234.            in the GRCOLR() section above. 
  235.  
  236. Example:    
  237.  
  238. VIDEOSET(1) 
  239. GRCOLR(14)  &&Set foreground color to yellow 
  240. GRBKCOLR(1)  && Set background color to blue 
  241.  
  242. Returns :  Nothing. 
  243.  
  244.  
  245. Note    :  Clipper can operate in graphics mode, however you cannot 
  246.            use @..SAY, @..GET, or any screen display commands or 
  247.            functions unless you are in text mode.  You want to go 
  248.            into graphics mode to use the graphics functions listed  
  249.             below.   
  250.  
  251.  
  252. example :  
  253.  
  254. VIDEOSET(1)  &&& Turns on graphics mode 
  255.  
  256. SPHERE(x1,y1,x2,y2)  &&& Draw a sphere 
  257. .... 
  258. .... 
  259. .... 
  260.  
  261. VIDEOSET(0)  &&& Return to text mode 
  262.  
  263.  
  264.  
  265.  
  266.                                Page 5
  267.  
  268.  
  269. PIXL() 
  270.  
  271. Purpose :  Draw a single pixl at a specified location. 
  272.  
  273. Syntax  :  PIXL([<expN1>] [,<expN2>]) 
  274.  
  275.  
  276. Argument:  <expN1> and <expN2> are the respective x and y coordinates 
  277.            in graphics mode.   
  278.  
  279. Note    :  Since you are in graphics mode you are not limited to 
  280.            80x25 x and y values.  If you are using a monochrome 
  281.            (Hercules) you are limited to 720 X 348 otherwise, the 
  282.            limit will be 640 X 350 (16 color). 
  283.  
  284.  
  285. Example:    
  286.  
  287.  
  288. STORE 1 to x,y 
  289.  
  290. VIDEOSET(1) 
  291. GRCOLR(14)  &&Set foreground color to yellow 
  292. GRBKCOLR(1)  &&Set background color to blue 
  293.  
  294.  
  295. DO WHILE LASTKEY() <> 27 
  296.    INKEY(0) 
  297.    DO CASE 
  298.      CASE LASTKEY() = 5    &&& Up Arrow 
  299.          y = y-1 
  300.      CASE LASTKEY() = 24   &&& Down Arrow 
  301.          y = y + 1 
  302.      CASE LASTKEY() = 19   &&& Left Arrow 
  303.          x = x - 1 
  304.      CASE LASTKEY() = 4    &&& Right Arrow 
  305.          x = x + 1 
  306.    ENDCASE 
  307.    PIXL(x,y) 
  308. ENDDO 
  309.  
  310.  
  311. Returns :  Nothing. 
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.                               Page 6
  320.                           
  321. RECTANGL() 
  322.  
  323. Purpose :  Draw a rectangle with specified coordinates. 
  324.  
  325. Syntax  :  RECTANGL([<expN1>] [,<expN2>] [,<expN3>] [,<expN4>] [,<expN5>]) 
  326.  
  327.  
  328. Argument:  <expN1> if set to 1 will cause the outline of the 
  329.            rectangle to be drawn only. If <expN1> is set to 2 the  
  330.            rectangle will be filled with the current foreground 
  331.            color.  <expN2>...<expN5> are the respective x1, y1, x2, and y2  
  332.            coordinates in graphics mode.   
  333.  
  334. Note    :  Since you are in graphics mode you are not limited to 
  335.            80x25 x and y values.  If you are using a monochrome 
  336.            (Hercules) you are limited to 720 X 348 otherwise, the 
  337.            limit will be 640 X 350 (16 color). 
  338.  
  339.  
  340. Example:    
  341.  
  342.  
  343.  
  344. VIDEOSET(1) 
  345. GRCOLR(14)   
  346. GRBKCOLR(1)   
  347.  
  348. RECTANGL(2,40,20,200,300) 
  349.  
  350.  
  351. Returns :  Nothing. 
  352.  
  353. __________________________ 
  354.  
  355.  
  356. SPHERE() 
  357.  
  358. Purpose :  Draw a rectangle with specified coordinates. 
  359.  
  360. Syntax  :  SPHERE([<expN1>] [,<expN2>] [,<expN3>] [,<expN4>] [,<expN5>]) 
  361.  
  362.  
  363. Argument:  <expN1> if set to 1 will cause the outline of the 
  364.            sphere to be drawn only. If <expN1> is set to 2 the  
  365.            sphere will be filled with the current foreground 
  366.            color.  <expN2>...<expN5> are the respective x1, y1, x2, and y2  
  367.            coordinates in graphics mode which define a bounding 
  368.            rectangle which is also the center of the sphere.   
  369.  
  370.  
  371.  
  372.  
  373.                                  Page 7
  374. Example:    
  375.  
  376.  
  377. VIDEOSET(1) 
  378. GRCOLR(14)   
  379. GRBKCOLR(1)   
  380.  
  381. SPHERE(2,40,20,200,300) 
  382.  
  383.  
  384. Returns :  Nothing. 
  385.  
  386. __________________________ 
  387.  
  388. PIE() 
  389.  
  390. Purpose :  Draw a pie with specified coordinates.  Useful for 
  391.            statistical graphical representations.    
  392.  
  393. Syntax  :  PIE([<expN1>] [,<expN2>] [,<expN3>] [,<expN4>] [,<expN5>]); 
  394.            [<expN6>] [,<expN7>] [,<expN8>] [,<expN9>] 
  395.  
  396. Argument:  <expN1> if set to 1 will cause the outline of the 
  397.            pie to be drawn only. If <expN1> is set to 2 the  
  398.            pie will be filled with the current foreground 
  399.            color.  <expN2>...<expN5> are the respective x1, y1, x2, and y2  
  400.            coordinates in graphics mode which define a bounding 
  401.            rectangle which is also the center of the pie or arc.   
  402.            <expN6>..<expN9> are the x3, y3, x4, and y4 coordinates 
  403.            which define where the arc starts at the intersection of 
  404.            the vector (x3,y3) and where the arc ends at the intersection 
  405.            of the vector(x4,y4). 
  406.  
  407. Example:    
  408.  
  409.  
  410.  
  411. VIDEOSET(1) 
  412. GRCOLR(14)   
  413. GRBKCOLR(1)   
  414.  
  415. PIE(2,80,50,240,150,240,12,0,150) 
  416.  
  417.  
  418. Returns :  Nothing. 
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.                                 Page 8
  427. CURPOS() 
  428.  
  429.  
  430. Purpose :  Set cursor position in graphics mode. 
  431.  
  432. Syntax  :  CURPOS([<expN1>] [,<expN2>])] 
  433.  
  434. Argument:  <expN1> and <expN2> are the desired x and y coordinates. 
  435.  
  436. Example :    
  437.  
  438.  
  439. VIDEOSET(1) 
  440. GRCOLR(14)   
  441. GRBKCOLR(1)   
  442.  
  443. CURPOS(80,50) 
  444.  
  445.  
  446. Returns :  Nothing. 
  447.  
  448. __________________________ 
  449.  
  450. LINEDRAW() 
  451.  
  452.  
  453. Purpose :  Draw a line from the current cursor position to another 
  454.            specified point. The line can be diagonal. 
  455.  
  456. Syntax  :  LINEDRAW([<expN1>] [,<expN2>])] 
  457.  
  458. Argument:  <expN1> and <expN2> are the x and y coordinates which define 
  459.            the end point. 
  460.  
  461. Example :    
  462.  
  463.  
  464. VIDEOSET(1) 
  465. GRCOLR(14)   
  466. GRBKCOLR(1)   
  467.  
  468. CURPOS(0,0) 
  469. LINEDRAW(80,50) 
  470.  
  471.  
  472. Returns :  Nothing. 
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                                 Page 9
  480. GRMOVSCR() 
  481.  
  482. Purpose :  Move portion of screen in graphics mode. Could be used for  
  483.            animation effects. 
  484.  
  485. Syntax  :  GRMOVSCR([<Array>] [,<expN1>])] [,<expN2>]) 
  486.  
  487. Argument:  <Array> contains four elements, the x1,y1,x2,y2 coordinates which 
  488.            determine the upper left (x1,y1) and the lower right (x2,y2)  
  489.            corners of the image to be moved.  <expN1> and <expN2> are the x 
  490.            and y coordinates which determine the upper left hand corner of 
  491.            the destination of the image being moved. 
  492.  
  493. Example :    
  494.  
  495. DECLARE SAVEARRY[4] 
  496. VIDEOSET(1) 
  497. GRCOLR(14)   
  498. GRBKCOLR(1)   
  499.  
  500. SAVEARRY[1] = 10 
  501. SAVEARRY[2] = 20 
  502. SAVEARRY[3] = 50 
  503. SAVEARRY[4] = 70 
  504.  
  505. GRMOVSCR(SAVEARRY,80,90) 
  506.  
  507. Returns :  Nothing. 
  508.  
  509. __________________________ 
  510.  
  511. GRSCR2FI() 
  512.  
  513. Purpose :  To save screen in grapics mode to a file. 
  514.  
  515. Syntax  :  GRSCR2FI([,<expN1>])] [<expN2>] [,<expN3>] [,<expC>]) 
  516.  
  517. Argument:  <expN1> is the bytes to be written.  65,534 is the maximum. 
  518.            <expN2> and <expN3> are the x and y values which determine 
  519.            the size of the screen image to be saved. 
  520. Example :    
  521.  
  522. nbytes_ = 60000 
  523. savx_ = 640 
  524. savy_ = 100 
  525.  
  526. VIDEOSET(1) 
  527. GRCOLR(14)   
  528. GRBKCOLR(1)   
  529. PIE(2,80,50,240,150,240,12,0,150) 
  530. GRSCR2FI(nbytes_,savx_,savy_,"FILE.GRA") 
  531.  
  532. Returns :  Nothing. 
  533.                                Page 10
  534. GRFI2SCR() 
  535.  
  536.  
  537. Purpose :  To restore a screen previously saved in graphics mode to a file. 
  538.  
  539.  
  540.  
  541. Syntax  :  GRFI2SCR([,<expN1>])] [<expN2>] [,<expN3>] [,<expC>]) 
  542.  
  543. Argument:  <expN1> is the bytes to be read.  65,534 is the maximum. 
  544.            <expN2> and <expN3> are the x and y values which determine 
  545.            the size of the screen image to be restored.  The parameters 
  546.            should be identical to those used to save the file. 
  547.  
  548.  
  549. Example :    
  550.  
  551. nbytes_ = 60000 
  552. savx_ = 640 
  553. savy_ = 100 
  554.  
  555. VIDEOSET(1) 
  556. GRFI2SCR(nbytes_,savx_,savy_,"FILE.GRA") 
  557.  
  558.  
  559. Returns :  Nothing. 
  560.  
  561.  
  562. ________________ 
  563.  
  564.  
  565. GRTEXT() 
  566.  
  567. Purpose :  To create a text window and insert text in graphics mode.
  568.  
  569. Syntax  :  GRTEXT([,<expN1>])] [<expN2>] [,<expN3>] [,<expC>]) 
  570.  
  571. Argument:  <expN1> and <expN2> (or column 1, row 1) is the upper right
  572.            hand corner of the text window. <expN3> and the length of the
  573.            line of text in <expC> (column 2 and row 2) is the lower right
  574.            hand corner of the window. 
  575.                           
  576.  
  577. Example:
  578.  
  579. VIDEOSET(1)
  580. GRTEXT(1,1,2,"<Shft-F2> Rectangle, <Shft-F3> Sphere")
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.                                   Page 11
  588. 2. Database Functions. 
  589.  
  590.  
  591. DBFIX() 
  592. Syntax: DBFIX([<ExpC>]) 
  593. Return: Nothing. 
  594. Notes : ExpC is a database file name enclosed in quotes.  Any 
  595.         premature EOF markers are extracted.  Premature EOF markers 
  596.         make it impossible to access records after the premature 
  597.         marker even though we know they are there.  This type of 
  598.         file corruption can occur when turning off a computer while 
  599.         dBase file are still open.  
  600.  
  601. Example:  
  602.  
  603.        CLOSE DATA 
  604.        DBFIX("BASE2.DBF") 
  605.  
  606.  
  607.        * The database must be closed before it can be used by this 
  608.        function. 
  609.  
  610. _______________ 
  611.  
  612. RELPOS() 
  613. Syntax: RELPOS([<expC>] [,<expN1>] [,<expN2>]) 
  614. Return: The relative position of a record in an index file. 
  615. Notes : <expC> is the name of the index file (must be closed) 
  616.         enclosed in quotes.  <expN1> and <expN2 are the start and 
  617.         ending record, respectively. 
  618.  
  619. Example:  
  620.       
  621.    SELECT 0 
  622.     USE STUDENTS  
  623.     INDEX ON STR(GRADE,10) + DESEND(STR(GPA,10)) TO STANDNG 
  624.  
  625.     APPEND BLANK 
  626.                    &&& Added student in 3rd grade 
  627.                     &&& with GPA of 3.0. 
  628.      
  629.  
  630.         SEEK SeekVar 
  631.         SeekVar = STR(GRADE_,10) 
  632.          
  633.     Start = RECNO() &&& This the start record in the index 
  634.                     &&& file for those students in the 3rd grade. 
  635.                   &&& Lets say RECNO() = 340   
  636.  
  637.         SeekVar = SeekVar + STR(DESCEND(GPA_),10) 
  638.         End = RECNO()   &&& This is the record # of the student 
  639.                         &&& we just added. Let's say record 410.   
  640.          USE   &&& The index file MUST BE CLOSED !!!!!! 
  641.                           Page 12
  642.  
  643.     Pos = RELPOS("STANDNG.NTX",Start,End) 
  644.     ?Pos     &&& pos = 30. 
  645.  
  646. Result: Record 410 is the 30th record from record 340 in the 
  647.         index file.  That is, the student who is in the third grade 
  648.         with a GPA of 3.0 is in the 30th position from the start of 
  649.         the third grade students where the first position would be 
  650.         that student with a GPA of 4.0. 
  651.  
  652. _____________ 
  653.  
  654. SECURDB() 
  655. Syntax: SECURDB([<array1>] [,<expL>]) 
  656. Note..: <array1> is an filled with the names of databases. 
  657.         expL, if set to  .T. will prevent the databases from being opened. 
  658.         To open them again the function must be called with expL set to 
  659.         .F. .  Setting the expL to .T. removes the '03' in the file 
  660.         header.  This will prevent anyone from opening the file in dBase 
  661.         or Clipper. 
  662.  
  663. Example:  
  664.      
  665.  
  666. DECLARE DBFS[3] 
  667. DBFS[1] = 'SALES.DBF' 
  668. DBFS[2] = 'INVENTRY.DBF' 
  669. DBFS[3] = 'RECEIPTS.DBF' 
  670.  
  671. SECURDB(DBFS,.F.) &&& These files can now be opened. 
  672.  
  673. ... 
  674. ... 
  675. SECURDB(DBFS,.T.)  &&& Now these files cannot be opened.  
  676. QUIT 
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.                                  Page 13
  696.  
  697. 3. Time and Date functions 
  698.  
  699. GETFTIME() 
  700. Syntax: GETFTIME([<ExpC>]) 
  701.  
  702. Purpose : To return the time a file was last modified. 
  703. Argument: <expC> is the file name of the file whose last modification date  
  704.           is sought.  The file name must include an extension and must be  
  705.           enclosed in quotation marks. 
  706. Returns : A character string representing a file's last modification date. 
  707.           The returned string has the form of the following example: 
  708.           Wed Jan 02 02:03:55 1980. 
  709.  
  710. Example: 
  711.  
  712. timevar = GETFTIME("NAMES.DBF") 
  713. ?timevar 
  714.  
  715. result:   Wed Jan 02 02:03:55 1980. 
  716.  
  717. __________________________ 
  718.  
  719.  
  720. FTIMEVAR() 
  721. Syntax: FTIMEVAR([<ExpC>]) 
  722.  
  723. Purpose : To return the time a file was last modified to be saved in  
  724.           a variable which can be then be used with SETFTIME().  
  725.  
  726. Argument: <expC> is the file name of the file whose last modification date is 
  727.           is sought.  The file name must include an extension and must be  
  728.           enclosed in quotation marks. 
  729.  
  730. Returns : A variable which is to be used with SETFTIME() to change the 
  731.           modification date and time of a file.  See SETFTIME(). 
  732.  
  733.  
  734. Example: 
  735.  
  736. datevar = FTIMEVAR("base2.dbf") 
  737. use base2 
  738. copy to a:\base2.dbf  
  739. SETFTIME(datevar,"base2.dbf") 
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.                               Page 14
  750.  
  751. SETFTIME() 
  752. Syntax:   SETFTIME([<ExpC1>],[<ExpC2>]) 
  753.  
  754. Purpose : To reset the date and time a file was last written. 
  755.  
  756. Argument: <ExpC1> is the time and date variable containing the string 
  757.           returned from FTIMEVAR().  <ExpC2> is the file name whose time and 
  758.           time and date are being modified.  The file name is enclosed in 
  759.           quotes and the file extension must be included. 
  760.  
  761. Example: 
  762.  
  763. datevar = FTIMEVAR("base2.dbf") 
  764. use base2 
  765. copy to a:\base2.dbf  
  766. SETFTIME(datevar,"base2.dbf") 
  767.  
  768. __________________________ 
  769.  
  770. TIMESTAMP() 
  771. Syntax  : TIMESTAMP([<expC>]) 
  772. Purpose : To return the time a file was last modified. 
  773.  
  774. Argument: <expC> is the file name of the file whose last modification date is 
  775.           is sought.  The file name must include an extension and must be  
  776.           enclosed in brackets. 
  777.  
  778. Returns : A character string representing a file's last modification date. 
  779.           The returned string has the form of the following example: 
  780.           Wed Jan 02 02:03:55 1980. 
  781.  
  782. Notes   : Can be linked with PLINK86.EXE or Microsoft's LINK.EXE, but not 
  783.           Borland's TLINK.EXE.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.   
  803.                               Page 15
  804. 4. Miscellaneous Functions. 
  805.  
  806. CRCHECK() 
  807. Syntax: CRCHECK([<ExpC>]) 
  808. Return: .T. if memo field or character string contains only CR or LF 
  809.         characters. 
  810. Notes : ExpC is a memo field name.  Often a memo field appears empty 
  811.         although the pressing of the ENTER key may have caused a CR and  
  812.         LF pair to exist.  
  813.  
  814. Example:  
  815.  
  816. USE NAMES 
  817.  
  818. IF CRCHECK("NOTES") 
  819.   REPLACE NOTES WITH "" 
  820. ENDIF 
  821.  
  822. Result: 
  823.  
  824. If the memo field, NOTES contains only carriage return and line feed pairs 
  825. the field can replaced with "" .  
  826. __________________________ 
  827.  
  828.  
  829.  
  830. CURSIZER() 
  831. Syntax: CURSIZER([<ExpN1>],[<ExpN2>]) 
  832. Note..: ExpN1 and ExpN2 are the starting and ending cursor line numbers, 
  833.         respectively.  12,13 is normal, 0,12 is largest. 
  834.  
  835. Example: 
  836.  
  837. CURSIZER(0,12) 
  838.  
  839. Result: 
  840.  
  841. A tall cursor. 
  842.  
  843. __________________________ 
  844.  
  845. FLOATPT() 
  846. Syntax: FLOATPT(<Exp1>,<Exp2>) 
  847. Return: Floating point remainder of an division problem.  
  848. Note..: Exp1 is the dividend and Exp2 is the divisor.  
  849.  
  850. Example: 
  851. ?floatpt(13,5) 
  852.  
  853. result: The function returns 3.00, the remainder of 12/5. 
  854.  
  855.  
  856.                             Page 16
  857.  
  858. SCR2FIL() 
  859. Syntax: SCR2FIL() 
  860. Note..: Whenever this function is called, whatever is on the screen  
  861.         will be saved to a file called SCRNFILE.TXT.  The SET KEY 
  862.         commands in Clipper can be used to set keys to call this function. 
  863.  
  864.  
  865.