ADDPATH(3A)                                           ADDPATH(3A)



  NAME
       AddPath, AddPathV - add one or more elements to a path
       environment variable


  SYNOPSIS
       int AddPath (name, new, delim, front)
       char *name;
       char *new;
       char delim;
       int front;

       int AddPathV (name, list, delim, front)
       char *name;
       char **list;
       char delim;
       int front;

  DESCRIPTION
       AddPath tries to add the element new to the path environment
       variable name.  AddPathV tries to add each string in the
       array list of strings to a path environment variable.  If
       the variable is not already set in the environment, it is
       added.  The path delimiter is in delim.  If front is non-
       zero, the new element is added at the beginning of the path,
       otherwise at the end of the path.  An element is not added
       if it is already present in the path.  Upon success, the
       number of strings actually added is returned, which may be
       zero.  Upon failure, -1 is returned.

  NOTES
       AtariLibInit(3A) uses AddPathV to add the path of the
       library catalog files to the environment variable NLSPATH.

  SEE ALSO
       AtariLibInit(3A), getenv(3), environment(5)






  Page 1                                           (printed 9/3/91)