1get_raw_filename(3)                 GETDATA                get_raw_filename(3)
2
3
4

NAME

6       get_raw_filename — retrieve the pathname of a binary file in a dirfile
7

SYNOPSIS

9       #include <getdata.h>
10
11       const char *get_raw_filename(DIRFILE *dirfile, const char *field_code);
12

DESCRIPTION

14       The  get_raw_filename()  function  retrieves  the  pathname of the file
15       backing the RAW field specified by field_code in the dirfile  specified
16       by  dirfile.   If field_code contains a valid representation suffix, it
17       will be ignored.
18
19

RETURN VALUE

21       On success, get_raw_filename() returns the full pathname of the  binary
22       file  associated  with the specified field.  On error, NULL is returned
23       and the dirfile error is set to a non-zero error value.  Possible error
24       values are:
25
26       GD_E_ALLOC
27               The library was unable to allocate memory.
28
29       GD_E_BAD_CODE
30               The field specified by field_code was not found.
31
32       GD_E_BAD_DIRFILE
33               The supplied dirfile was invalid.
34
35       GD_E_BAD_FIELD_TYPE
36               The field specified by field_code was not a RAW field.
37
38       GD_E_BAD_REPR
39               The  representation  suffix  specified  in  field_code  was not
40               recognised.
41
42       GD_E_UNKNOWN_ENCODING
43               The encoding scheme of the specified field could not be  deter‐
44               mined or was not understood by GetData.
45
46       The dirfile error may be retrieved by calling get_error(3).  A descrip‐
47       tive error string for the last error encountered can be obtained from a
48       call to get_error_string(3).
49

SEE ALSO

51       get_entry(3),  get_error(3),  get_error_string(3), dirfile(5), dirfile-
52       encoding(5), dirfile-format(5)
53
54
55
56Version 0.6.0                   19 October 2009            get_raw_filename(3)
Impressum