OMget_path, OMget_path_index, OMget_num_paths

Synopsis

char *OMget_path(int which);
char *OMget_path_index(int which,
int path_index,char *buffer);
int OMget_num_paths(int which);

Description

These routines provide access to the path variables of the current AVS/Express session. The different paths defined by the system are:

Path name

Description

OM_PATH

The value of the XP_PATH variable,

OM_VPATH

The path to search for loading of V files. Usually this includes the v subdirectories of XP_PATH and the current directory.

OM_BINPATH

The path to search for executables. This includes both the bin directory and the machine specific directory.

OM_RUNTIMEPATH

The path of the runtime directories. Usually this includes the runtime subdirectories of XP_PATH.

Arguments

which

The path this operation works on as defined by one of the constants above (e.g., OM_PATH).

path_index

The path returned. This number should be a value between 0 and the value returned by OMget_num_paths.

buffer

This specifies a piece of memory that the routine OMget_path_index uses to store the returned path. This buffer should be defined to be large enough to contain the maximum length path name for the machine. The AVS_PATH_MAX constant can be used for this purpose.

Returned value

OMget_path returns a read-only character string that contains the list of directories in the specified path. The paths are separated by a space character. You should not free or modify the memory returned.OMget_num_paths returns the number of directories in the specified path.OMget_path_index copies the specified directory name into the buffer you specified and returns a pointer to that buffer.

Examples

none.

See Also

none.