[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

setwfdb

 
void setwfdb(char *string)

This function may be used to set or change the database path (see section 1.4 The Database Path and Other Environment Variables) within a running program. The argument points to a null-terminated string that specifies the desired database path (but see the next paragraph for an exception). The string contains a list of locations where input files may be found. These locations may be absolute directory names (such as `/usr/local/database' under Unix, or `d:/database' under MS-DOS), relative directory names (e.g., ../mydata), or URL prefixes (e.g., `http://www.physionet.org/physiobank/database'). If NETFILES support is unavailable, any URL prefixes in the string are ignored. The special form `.' refers to the current directory. Entries in the list may be separated by whitespace or by semicolons; under Unix, colons may also be used as separators. An empty component, indicated by an initial or terminal separator, or by two consecutive separators, will be understood to specify the current directory (which may also be indicated by a component consisting of a single `.'). If the string is empty or NULL, the database path is limited to the current directory.

If string begins with `@', the remaining characters of string are taken as the name of a file from which the WFDB path is to be read. This file may contain either the WFDB path, as described in the previous paragraph, or another indirect WFDB path specification. Indirect WFDB path specifications may be nested no more than ten levels deep (an arbitrary limit imposed to avoid infinite recursion). Evaluation of indirect WFDB paths is deferred until getwfdb is invoked, either explicitly or by the WFDB library while attempting to open an input file (e.g., using annopen or isigopen). (The features described in this paragraph were first introduced in WFDB library version 8.0.) See section getwfdb, for an example of the use of setwfdb.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

George B. Moody (george@mit.edu)