mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-22 04:25:08 +00:00
52 lines
2.2 KiB
Text
52 lines
2.2 KiB
Text
{{DISPLAYTITLE:_DIR$}}
|
|
The [[_DIR$]] function returns common paths in '''Windows''' only such as My Documents, My Pictures, My Music, Desktop.
|
|
|
|
|
|
{{PageSyntax}}
|
|
: {{Parameter|d$}} = [[_DIR$]]("{{Parameter|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
|
|
|
|
|
|
{{PageDescription}}
|
|
* 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 '''"./"'''
|
|
|
|
|
|
{{PageExamples}}
|
|
Example: Displaying default paths in Windows only.
|
|
{{CodeStart}}{{Cl|PRINT}} "DESKTOP=" + _DIR$("desktop")
|
|
{{Cl|PRINT}} "DOWNLOADS=" + {{Cl|_DIR$}}("download")
|
|
{{Cl|PRINT}} "DOCUMENTS=" + {{Cl|_DIR$}}("my documents")
|
|
{{Cl|PRINT}} "PICTURES=" + {{Cl|_DIR$}}("pictures")
|
|
{{Cl|PRINT}} "MUSIC=" + {{Cl|_DIR$}}("music")
|
|
{{Cl|PRINT}} "VIDEO=" + {{Cl|_DIR$}}("video")
|
|
{{Cl|PRINT}} "APPLICATION DATA=" + {{Cl|_DIR$}}("data")
|
|
{{Cl|PRINT}} "LOCAL APPLICATION DATA=" + {{Cl|_DIR$}}("local application data"
|
|
{{CodeEnd}}
|
|
{{OutputStart}}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\
|
|
{{OutputEnd}}
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[_CWD$]]
|
|
* [[_STARTDIR$]]
|
|
|
|
|
|
{{PageNavigation}}
|