FindNextFile

From the Oblivion ConstructionSet Wiki
Revision as of 05:23, 1 May 2009 by imported>Low Post (Shortened example Script a bit.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

A command for Pluggy.

Syntax:

(FoundFile:bool) FindNextFile (FileFound)StringID:long Global:bool

Sets the content of (FileFound)StringID to the Filename of the next matching File and returns 1 if a file was found; 0 if not. FindFirstFile must be called first; this function uses the FileMask, RootID & Directories passed to FindFirstFile. This function should only be used within a Label/Goto loop

Notes:

  • If you want to modify a string from another mod, you will need to set the Global flag to 1. If Global is 0 or unset the function will fail. If the string is protected the function will fail.

Example

Quest script that display in the console the list of *.bsa files in Oblivion/Data folder:

scn testffs

Begin GameMode
	SetString -2000 "*.bsa"
	FindFirstFile -2050 -2000 1
	While ( ( StringLen -2050 ) > 0 )
		StringMsg -2050 1
		FindNextFile -2050
	Loop
	StopQuest TestFF
End

See also