System::chdir(3) Change directory


Void chdir( String path )


Change the current working directory to another directory. The directory path given can be relative or absolute.

 // currently in /home/me/working
 chdir("sub"); // now in /home/me/working/sub
 chdir("../../.."); // now in /home
 chdir("/tmp"); // now in /tmp

The function behaves in a similar fashion on Windows

 // currently in C:\kaya\programs
 chdir("sub"); // now in C:\kaya\programs\sub
 chdir("..\\.."); // now in C:\kaya
 chdir("\\Program Files"); // now in C:\Program Files
 chdir("F:\\data"); // now in F:\data

Note the need to escape the backslashes used as a path separator.


Kaya standard library by Edwin Brady, Chris Morris and others ([email protected]). For further information see


The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.