Gets the pathname to a data file that is required for a test.
This is the same as build_filename with two differences. The first difference is that must only use this function from within a testcase function. The second difference is that you need not free the return value -- it will be automatically freed when the testcase finishes running.
It is safe to use this function from a thread inside of a testcase but you must ensure that all such uses occur before the main testcase function returns (ie: it is best to ensure that all threads have been joined).
| file_type |
the type of file (built vs. distributed) |
| first_path |
the first segment of the pathname |
| ... |
null-terminated additional path segments |
|
the path, automatically freed at the end of the testcase |