Definition: | sequence s = include_paths(integer convert=0) |
Description: |
Returns a list of include paths, which are typically searched last-first.
The convert parameter is unused and present solely for compatibility with OpenEuphoria. |
Comments: |
The list returned is in reverse order of searching, potentially with inactive relative directory handling towards the end.
For example if an application contains ‘include ..\..\demo\arwen\arwen.ew’ the appropriate fully resolved
path to arwen.ew is added to the end of the include paths table so that any include statements within that file are
searched for within that path first, and that path is marked inactive once arwen.ew has been fully processed. Several
such events may have occurred during compilation; the table returned is the complete table as at the end of compilation,
but without any indication of which, if any, directories are no longer 'active'.
As shown below, every entry of the result ends with a path separator, so there should be no need to check for that. If EUDIR and/or EUINC are defined, they appear at the start of the list, and therefore would be searched last. |
Example: |
sequence s = include_paths() -- s might contain -- {"C:\\Program Files (x86)\\Phix\\builtins\\", -- "C:\\Program Files (x86)\\Phix\\builtins\\VM\\", -- "C:\\Program Files (x86)\\Phix\\"} |