setSkillPath

setSkillPath( 
{tl_paths | nil }
) 
=> l_strings / nil

Description

Sets the internal SKILL path used by some file-related functions in resolving relative path names.

You can specify the directory paths either in a single string, separated by spaces, or as a list of strings. The system tests the validity of each directory path as it puts the input into standard form. If all directory paths exist, it returns nil.

If any path does not exist, a list is returned in which each element is an invalid path. Also:

• The directories on the SKILL path are always searched for in the order you specified in tl_paths.
• Even if a path does not exist (and hence appears in the returned list) it remains on the new SKILL path.

The use of the SKILL path in other file-related functions can be effectively disabled by calling setSkillPath with nil as the argument.

Arguments

tl_paths	Directory paths specified either in a single string or in a list of strings.
nil	Turns off the use of the SKILL path.

Value Returned

l_strings	List of directory paths that appear in the tl_paths argument but do not exist.
nil	If all directory paths exist.

Examples

setSkillPath('("." "~" "~/cpu/test1"))
=> nil                       ; If "~/cpu/test1" exists.
=> ("~/cpu/test1")           ; If "~/cpu/test1" does not exist.

The same task can be done with the following call that puts all paths in one string.

setSkillPath(". ~ ~/cpu/test1")

Related Topics

Environment Functions

getSkillPath

Return to top