Method PerformLoopFilePattern

source/script.cpp:10937–10961

ResultType Line::PerformLoopFilePattern(ResultToken *aResultToken, Line *&aJumpToLine, Line *aUntil
	, FileLoopModeType aFileLoopMode, bool aRecurseSubfolders, LPTSTR aFilePattern)
{
	ResultType result = CONDITION_FALSE;
	// LoopFilesStruct is currently about 128KB, so it's probably best not to put it on the stack.
	// 128KB temporary usage per Loop (for all iterations) seems a reasonable trade-off for supporting
	// long paths while keeping code size minimal.
	LoopFilesStruct *plfs = new LoopFilesStruct;
	if (!plfs)
		return MemoryError();
	// Parse aFilePattern into its components and copy into *plfs.  Copies are taken because:
	//  - As the lines of the loop are executed, the deref buffer (which is what aFilePattern might
	//    point to if we were called from ExecUntil()) may be overwritten -- and we will need the path
	//    string for every loop iteration.
	//  - We relative paths resolved to full paths in case the working directory is changed after the
	//    loop begins but before FindFirstFile() is called for a sub-directory.
	//  - Several built-in variables rely on the paths stored in *plfs and updated on each iteration.
	//    This approach means a little up-front work that mightn't be needed, but greatly improves
	//    performance in some common cases, such as if A_LoopFileLongPath is used on each iteration.
	if (ParseLoopFilePattern(aFilePattern, *plfs, result))
		result = PerformLoopFilePattern(aResultToken, aJumpToLine, aUntil, aFileLoopMode, aRecurseSubfolders, *plfs);
	//else: leave result == CONDITION_FALSE, since in effect, no files were found.
	delete plfs;
	return result;
}