HOME( ) Function

Returns the names of the Visual FoxPro and Visual Studio directories.

HOME([nLocation])

Return Values

Character

Property Values

• nLocation
  Specifies that HOME( ) returns the name of a specific Visual FoxPro or Visual Studio directory. Note that omitting nLocation is identical to HOME(0).

  The following table lists the values for nLocation and the directory the HOME( ) returns. The directories listed below assume that you chose the default installation directory when you installed Visual FoxPro or Visual Studio.

  nLocation	Directory
  0 or omitted	The directory from which Visual FoxPro was started.
  1	The Visual FoxPro installation root directory.
  2	The directory containing the Visual FoxPro samples. This directory is identical to the samples directory in the _SAMPLES system variable.
  3	The Visual Studio Common directory.
  4	The Visual FoxPro Graphics directory.
  5	The MSDN Samples directory.
  6	The Visual Studio Tools directory.
  7	The Visual FoxPro User Application Data directory.

Remarks

HOME( ) is similar to SYS(2004) and is provided for compatibility with dBASE IV.

Example

CLEAR
? 'Visual FoxPro startup directory:       ', HOME( )
? 'Visual FoxPro installation directory:  ', HOME(1)
? 'Visual FoxPro samples directory:       ', HOME(2)
? 'Visual Studio common directory:        ', HOME(3)
? 'Visual FoxPro graphics directory:      ', HOME(4)
? 'MSDN samples directory:                ', HOME(5)
? 'Visual Studio tools directory:         ', HOME(6)
? 'Visual FoxPro user app data directory: ', HOME(7)

See Also

_SAMPLES System Variable | SYS( ) Functions Overview | SYS(2004) - Visual FoxPro Start Directory