- void separate(structures::string_array &pieces) const;
- //!< breaks the filename into its component directories.
- /*!< this returns an array containing the component names. the last
- component, unless the filename held is actually a directory, should be the
- name of the file. if the first character is a directory, then the first
- component will be empty. */
+ void separate(bool &rooted, structures::string_array &pieces) const;
+ //!< breaks the filename into its component parts.
+ /*!< this returns an array containing the component names for the path in
+ this filename object. if the "rooted" flag is set to true, then the path
+ was absolute (i.e. started at '/' in unix. this notion is not needed for
+ dos/windoze, as the first component will be something like 'a:'). */