mirror of
https://github.com/QB64Official/qb64.git
synced 2024-09-28 11:17:47 +00:00
50 lines
1.9 KiB
Text
50 lines
1.9 KiB
Text
{{DISPLAYTITLE:_CWD$}}
|
|
|
|
The [[_CWD$]] function returns the current working directory path as a string value without a trailing path separator.
|
|
|
|
|
|
{{PageSyntax}}
|
|
: {{Parameter|workingDirectory$}} = [[_CWD$]]
|
|
|
|
|
|
{{PageDescription}}
|
|
* By default, the initial working directory path is usually the same as the directory of the executable file run.
|
|
* The current working directory can be changed with the [[CHDIR]] or [[SHELL]] command; CHDIR sets it, _CWD$ returns it.
|
|
* Path returns will change only when the working path has changed. When in C:\ and run QB64\cwd.exe, it will still return C:\
|
|
* The current working directory string can be used in [[OPEN]] statements and [[SHELL]] commands that deal with files.
|
|
* Works in Windows, macOS and Linux. [[_OS$]] can be used by a program to predict the proper slash separations in different OS's.
|
|
|
|
|
|
{{PageErrors}}
|
|
* If an error occurs while obtaining the working directory from the operating system, [[ERROR Codes|error code]] 51 (Internal Error) will be generated.
|
|
|
|
|
|
{{PageExamples}}
|
|
''Example:'' Get the current working directory, and move around the file system:
|
|
{{CodeStart}} '' ''
|
|
startdir$ = _CWD$
|
|
{{Cl|PRINT}} "We started at "; startdir$
|
|
{{Cl|MKDIR}} "a_temporary_dir"
|
|
{{Cl|CHDIR}} "a_temporary_dir"
|
|
{{Cl|PRINT}} "We are now in "; _CWD$
|
|
{{Cl|CHDIR}} startdir$
|
|
{{Cl|PRINT}} "And now we're back in "; _CWD$
|
|
{{Cl|RMDIR}} "a_temporary_dir"
|
|
{{CodeEnd}}
|
|
|
|
{{OutputStart}}We started at C:\QB64
|
|
We are now in C:\QB64\a_temporary_dir
|
|
And now we're back in C:\QB64
|
|
{{OutputEnd}}
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[CHDIR]] {{text|(Change the current working directory)}}
|
|
* [[RMDIR]] {{text|(Remove a directory in the file system)}}
|
|
* [[KILL]] {{text|(Delete a file in the file system)}}
|
|
* [[MKDIR]] {{text|(Create a directory in the file system)}}
|
|
* [[_OS$]] {{text|(returns current OS to program)}}
|
|
* [[_STARTDIR$]] {{text|(returns path the user called program from)}}
|
|
|
|
|
|
{{PageNavigation}}
|