This wiki is out of date, use the continuation of this wiki instead

From FenixWiki

Revision as of 14:11, 26 April 2007 (edit) Sandman (Talk | contribs) ← Previous diff		Revision as of 01:11, 30 April 2007 (edit) (undo) Sandman (Talk | contribs) m (→Example) Next diff →
Line 46:		Line 46:
	End		End
	</pre>		</pre>
-	Both method result in the same, but the second one is less code.	+	Both methods result in the same, but the second one is less code.

---

Revision as of 01:11, 30 April 2007

Contents 1 Definition 2 Parameters 3 Returns 4 Example

Definition

INT glob ( <STRING criteria> )

Gets a single filename matching the criteria and keeps returning new ones on subsequent calls until it can't find any more, in which case it returns "". To restart the search, a call to frame() is needed, in which case frame(0); can come in handy.

Parameters

STRING criteria

- Search criteria: the folder in which you want to look, as well as any simple requirements for filenames such as extensions.

Returns

STRING : Filename

""	- No (new) file entries.
!""	- The filename of a file entry matching the search criteria.

Example

Program files;
Private
    String filename;
Begin

    // method one:
    Loop
        filename = Glob("levels\*.tul"); // Looks for a file in the relative folder
                                         // "levels" that has the file extension "tul".
        if(filename!="")
            load_level(filename); // load_level() would load the level file
        else
            Break;
        end

    End

    // method two:
    While( (filename = Glob("levels\*.tul")) != "" )
        load_level(filename);
    End

End

Both methods result in the same, but the second one is less code.