HOME( ) Function

  • Article

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