Description of the FOXTOUCH() Function

 Last reviewed: April 30, 1996
Article ID: Q114949
The information in this article applies to:
  • Microsoft Visual FoxPro for Windows, version 3.0
  • Microsoft FoxPro for Windows, versions 2.6x

SUMMARY

The FOXTOUCH() function can be used to change the date/time stamp on a specified file. This article describes the FOXTOUCH() function.

NOTE: For backward compatibility, Visual FoxPro still supports FOXTOOLS.FLL (included in earlier FoxPro versions), the Visual FoxPro API library that allows calls to 16-bit .DLL functions. However, in Visual FoxPro, the DECLARE command is the preferred method for calling .DLL functions.

MORE INFORMATION

The FOXTOUCH() function changes the time stamp of the file specified with <filename>. If the time stamp parameters are not specified, the file is stamped with the current system information.

The syntax of the FOXTOUCH() function is described below: 

   FOXTOUCH (<filename>,[<ExpN1>,<ExpN2>,<ExpN3>,<ExpN4>,<ExpN5>,<ExpN6>])

     <filename> - The name of the file to be modified
     <ExpN1> - The year to be stamped
     <ExpN2> - The month to be stamped
     <ExpN3> - The day to be stamped
     <ExpN4> - The hour to be stamped
     <ExpN5> - The minute to be stamped
     <ExpN6> - The seconds to be stamped

Example

   SET LIBRARY TO foxtools.fll
   =FOXTOUCH( "myfile.txt", 1984, 2, 10, 13, 20, 6)
This will change the date/time stamp of the file MYFILE.TXT to: 

   2/10/84  1:20:06pm
The FOXTOUCH() function is not contained within FoxPro itself. The FOXTOUCH() function is contained within FOXTOOLS.FLL. To use this function, you must first use the SET LIBRARY TO command to set the library to FOXTOOLS.FLL.

Under FoxPro 2.x, for more information about FOXTOOLS.FLL please see the FOXTOOLS.WRI file, which is located in the GOODIES\FOXTOOLS subdirectory of the FoxPro for Windows directory. In Visual FoxPro, see FOXTOOLS.HLP in the VFP\TOOLS directory.

The FOXTOUCH() function was added to FOXTOOLS.FLL version 1.03. FOXTOOLS.FLL version 1.03 is shipped with FoxPro version 2.6 for Windows. The FOXTOUCH() function does not exist in versions of FOXTOOLS.FLL that shipped with earlier versions of FoxPro for Windows.

Additional reference words: VFoxWin 3.00 FoxWin 2.60 2.60a
KBCategory: kbprg
KBSubcategory: FxprgFoxtools

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: April 30, 1996
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.