Functions | |
char * | qfits_get_dir_name (const char *filename) |
Find the directory name in the given string. | |
char * | qfits_get_base_name (const char *filename) |
Find out the base name of a file (i.e. without prefix path). | |
char * | qfits_get_root_name (const char *filename) |
Find out the root part of a basename (name without extension). | |
char * | qfits_get_ext_name (const char *filename) |
Find out the extension of a file name. |
The following functions are useful to cut out a filename into its components. All functions work with statically allocated memory, i.e. the pointers they return are not permanent but likely to be overwritten at each function call. If you need a returned value later on, you should store it into a local variable.
Example:
char * s ; s = qfits_get_dir_name("/mnt/cdrom/data/image.fits")
s contains now "/mnt/cdrom/data" but will loose these contents at the next function call. To retain its value, you can either do:
char s[1024]; strcpy(s, qfits_get_dir_name("/mnt/cdrom/data/image.fits"));
or:
char * s; s = strdup(qfits_get_dir_name("/mnt/cdrom/data/image.fits")); ... free(s);
char* qfits_get_base_name | ( | const char * | filename | ) |
Find out the base name of a file (i.e. without prefix path).
filename | Full path name to scan. |
Provide a full path name and you get in return a pointer to a statically allocated string containing the name of the file only, without prefixing directory names. If the input string does not contain a slash (i.e. it is not a full path), the returned string is a copy of the input string.
This function does not check for the existence of the path or the file.
Examples:
qfits_get_base_name("/cdrom/data/image.fits") returns "image.fits" qfits_get_base_name("filename.fits") returns "filename.fits"
char* qfits_get_dir_name | ( | const char * | filename | ) |
Find the directory name in the given string.
filename | Full path name to scan. |
Provide a full path name and you get in return a pointer to a statically allocated string containing the name of the directory only, without trailing slash. If the input string does not contain a slash (i.e. it is not a full path), the returned string is '.', corresponding to the current working directory. Since the returned string is statically allocated, do not try to free it or modify it.
This function does not check for the existence of the path or the file.
Examples:
qfits_get_dir_name("/cdrom/data/image.fits") returns "/cdrom/data" qfits_get_dir_name("filename.fits") returns "."
char* qfits_get_ext_name | ( | const char * | filename | ) |
Find out the extension of a file name.
filename | File name without path prefix. |
Find out the extension of a given file name. Notice that the input character string must not contain a path prefix (typically, you feed in the output of qfits_get_base_name
).
Works with all kinds of extensions: returns the part of the string after the last dot. If no dot is found in the input string, NULL is returned.
Examples:
qfits_get_ext_name("filename.fits") returns "fits" qfits_get_ext_name("hello.c") returns "c" qfits_get_ext_name("readme") returns NULL
char* qfits_get_root_name | ( | const char * | filename | ) |
Find out the root part of a basename (name without extension).
filename | File name to scan. |
Find out the root part of a file name, i.e. the file name without extension. Since in Unix a file name can have several dots, only a number of extensions are supported. This includes:
This function does not check for the existence of the path or the file.
Examples:
qfits_get_root_name("/cdrom/filename.fits") returns "/cdrom/filename" qfits_get_root_name("filename.paf") returns "filename" qfits_get_root_name("filename") returns "filename" qfits_get_root_name("filename.ext") returns "filename.ext"
Since the returned string is statically allocated in this module, do not try to free it or modify its contents.