[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
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] | [ ? ] |