ec_find_file

March 26, 2020 Contributors

Name

ec_find_file — Find a file in the given search path and return the resulting path

Synopsis

#include "util.h"

| int **ec_find_file** ( | search_path, |   |
|   | base, |   |
|   | outstr, |   |
|   | errstr); |   |

const char * <var class="pdparam">search_path</var>;
const char * <var class="pdparam">base</var>;
string * <var class="pdparam">outstr</var>;
string * <var class="pdparam">errstr</var>;

Description

Find a filename in the given search path and return the resulting path.

Parameters

search_path

The colon-separated path to search.

base

The base filename to be found.

outstr

The string holding the resulting path.

errstr

The error message, set on failure.

Return Values

On success this function returns 1; on failure it returns 0.

Threading

It is legal to call this function in any thread.