%scons; %builders-mod; %functions-mod; %tools-mod; %variables-mod; ]> (variable)

Returns a function (actually a callable Python object) intended to be used as the path_function of a Scanner object. The returned object will look up the specified variable in a construction environment and treat the construction variable's value as a list of directory paths that should be searched (like &cv-link-CPPPATH;, &cv-link-LIBPATH;, etc.). Note that use of &f-FindPathDirs; is generally preferable to writing your own path_function for the following reasons: 1) The returned list will contain all appropriate directories found in source trees (when &f-link-VariantDir; is used) or in code repositories (when &f-Repository; or the -Y option are used). 2) scons will identify expansions of variable that evaluate to the same list of directories as, in fact, the same list, and avoid re-scanning the directories for files, when possible. Example: def my_scan(node, env, path, arg): # Code to scan file contents goes here... return include_files scanner = Scanner(name = 'myscanner', function = my_scan, path_function = FindPathDirs('MYPATH'))