getwd()
Get current working directory pathname
Synopsis:
#include <unistd.h>
char* getwd( char *path_name );
Arguments:
- path_name
- A buffer where the function can store the current working directory.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The getwd() function determines the absolute pathname of the current working directory of the calling process, and copies that pathname into the array pointed to by the path_name argument.
If the length of the pathname of the current working directory is greater than PATH_MAX including the null byte, getwd() fails and returns a null pointer.
Returns:
A pointer to the string containing the absolute pathname of the current working directory. On error, getwd() returns a null pointer and the contents of the array pointed to by path_name are undefined.
Classification:
Standard Unix; removed from POSIX.1-2008
| Safety: | |
|---|---|
| Cancellation point | Yes |
| Signal handler | Yes |
| Thread | Yes |