The function prototype used for method functions (or caller-provided
callbacks) that transform filenames. They are passed a DSO structure pointer
(or null if they are to be used independantly of a DSO object) and a
filename to transform. They should either return null (if there is an error
condition) or a newly allocated string containing the transformed form that
the caller will need to free with free() when done.
The function prototype used for method functions (or caller-provided callbacks) that transform filenames. They are passed a DSO structure pointer (or null if they are to be used independantly of a DSO object) and a filename to transform. They should either return null (if there is an error condition) or a newly allocated string containing the transformed form that the caller will need to free with free() when done.