Functions | |
| DIR * | vlc_opendir (const char *dirname) |
| Opens a DIR pointer. More... | |
| const char * | vlc_readdir (DIR *dir) |
| Reads the next file name from an open directory. More... | |
| int | vlc_loaddir (DIR *dir, char ***namelist, int(*select)(const char *), int(*compar)(const char **, const char **)) |
| Does the same as vlc_scandir(), but takes an open directory pointer instead of a directory path. More... | |
| int | vlc_scandir (const char *dirname, char ***namelist, int(*select)(const char *), int(*compar)(const char **, const char **)) |
| Selects file entries from a directory, as GNU C scandir(). More... | |
| int | vlc_mkdir (const char *dirname, mode_t mode) |
| Creates a directory. More... | |
| char * | vlc_getcwd (void) |
| Determines the current working directory. More... | |
Detailed Description
Function Documentation
◆ vlc_getcwd()
| char* vlc_getcwd | ( | void | ) |
Determines the current working directory.
- Returns
- the current working directory (must be free()'d) or NULL on error
References getenv(), pathconf(), ToLocaleDup, and unlikely.
Referenced by vlc_path2uri().
◆ vlc_loaddir()
| int vlc_loaddir | ( | DIR * | dir, |
| char *** | namelist, | ||
| int(*)(const char *) | select, | ||
| int(*)(const char **, const char **) | compar | ||
| ) |
Does the same as vlc_scandir(), but takes an open directory pointer instead of a directory path.
References dummy_select(), likely, strdup(), unlikely, and vlc_readdir().
Referenced by vlc_scandir().
◆ vlc_mkdir()
| int vlc_mkdir | ( | const char * | dirname, |
| mode_t | mode | ||
| ) |
Creates a directory.
- Parameters
-
dirname a UTF-8 string with the name of the directory that you want to create. mode directory permissions
- Returns
- 0 on success, -1 on error (see errno).
References ToLocaleDup, and unlikely.
Referenced by ArtCacheCreateDir(), config_CreateDir(), and config_GetHomeDir().
◆ vlc_opendir()
| DIR* vlc_opendir | ( | const char * | dirname | ) |
Opens a DIR pointer.
- Parameters
-
dirname UTF-8 representation of the directory name
- Returns
- a pointer to the DIR struct, or NULL in case of error. Release with standard closedir().
References ToLocaleDup, unlikely, and widen_path().
Referenced by playlist_FindArtInCache(), subtitles_Detect(), and vlc_scandir().
◆ vlc_readdir()
| const char* vlc_readdir | ( | DIR * | dir | ) |
Reads the next file name from an open directory.
- Parameters
-
dir directory handle as returned by vlc_opendir() (must not be used by another thread concurrently)
- Returns
- a UTF-8 string of the directory entry. The string is valid until the next call to vlc_readdir() or closedir() on the handle. If there are no more entries in the directory, NULL is returned. If an error occurs, errno is set and NULL is returned.
References dirfd(), FromCharset(), and unlikely.
Referenced by playlist_FindArtInCache(), subtitles_Detect(), and vlc_loaddir().
◆ vlc_scandir()
| int vlc_scandir | ( | const char * | dirname, |
| char *** | namelist, | ||
| int(*)(const char *) | select, | ||
| int(*)(const char **, const char **) | compar | ||
| ) |
Selects file entries from a directory, as GNU C scandir().
- Parameters
-
dirname UTF-8 diretory path pointer [OUT] pointer set, on successful completion, to the address of a table of UTF-8 filenames. All filenames must be freed with free(). The table itself must be freed with free() as well.
- Returns
- How many file names were selected (possibly 0), or -1 in case of error.
References vlc_loaddir(), and vlc_opendir().
