DIR$

The _DIR$ function returns common paths in Windows only such as My Documents, My Pictures, My Music, Desktop.

Syntax

d$ = _DIR$("folderspecification")

Parameters

• folderspecification may be "desktop", "download", "documents", "music", "video", "pictures", "appdata", "program data", "local data".
• Some variation is accepted for the folder specification:

MY DOCUMENTS, TEXT, DOCUMENT, DOCUMENTS, DOWNLOAD, DOWNLOADS

MY MUSIC, MUSIC, AUDIO, SOUND, SOUNDS

MY PICTURES, PICTURE, PICTURES, IMAGE, IMAGES, PHOTO, PHOTOS, DCIM, CAMERA, CAMERA ROLL

MY VIDEOS, VIDEO, VIDEOS, MOVIE, MOVIES,

DATA, APPDATA, APPLICATION DATA, PROGRAM DATA, LOCAL DATA, LOCALAPPDATA, LOCAL APPLICATION DATA, LOCAL PROGRAM DATA

Description

• The path returned ends with a backslash (Windows).
• A nonexistent folder specification usually defaults to the Desktop folder path.
• In Linux and macOS the function always returns "./"

Examples

Example: Displaying default paths in Windows only.

PRINT "DESKTOP=" + _DIR$("desktop") PRINT "DOWNLOADS=" + _DIR$("download") PRINT "DOCUMENTS=" + _DIR$("my documents") PRINT "PICTURES=" + _DIR$("pictures") PRINT "MUSIC=" + _DIR$("music") PRINT "VIDEO=" + _DIR$("video") PRINT "APPLICATION DATA=" + _DIR$("data") PRINT "LOCAL APPLICATION DATA=" + _DIR$("local application data"

DESKTOP=C:\Documents and Settings\Administrator\Desktop\ DOWNLOADS=C:\Documents and Settings\Administrator\Downloads\ DOCUMENTS=C:\Documents and Settings\Administrator\My Documents\ PICTURES=C:\Documents and Settings\Administrator\My Documents\My Pictures\ MUSIC=C:\Documents and Settings\Administrator\My Documents\My Music\ VIDEO=C:\Documents and Settings\Administrator\My Documents\My Videos\ APPLICATION DATA=C:\Documents and Settings\Administrator\Application Data\ LOCAL APPLICATION DATA=C:\Documents and Settings\Administrator\Local Settings\Application Data\

See also

• _CWD$
• _STARTDIR$

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage Report a broken link