Glob - Revision history

Sandman at 00:54, 26 December 2007

2007-12-26T00:54:13Z

←Older revision		Revision as of 00:54, 26 December 2007
Line 3:		Line 3:

	==Definition==		==Definition==
-	'''~~INT~~''' glob ( <'''STRING''' criteria> )	+	'''STRING''' glob ( <'''STRING''' criteria> )

	Gets a single filename or directoryname 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.		Gets a single filename or directoryname 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.
		+
		+	After a call to glob(), the global struct [[fileinfo]] is filled with information about the last file/directory entry returned.

	== Parameters ==		== Parameters ==
	{\|		{\|
-	\| '''STRING''' criteria \|\| - ~~Search~~ criteria~~: the folder in which you want~~ to ~~look, as well as any simple requirements for~~ filenames~~, such as extensions, and directory names~~.	+	\| '''STRING''' criteria \|\| - The search criteria to which the returned filenames apply.
	\|}		\|}

Line 21:		Line 23:

	== Notes ==		== Notes ==
-	~~After a call~~ to ~~glob()~~, the ~~global struct [[fileinfo]] is filled~~ with ~~information about~~ the file/directory ~~entry returned~~.	+	The search criteria can hold many criteria: the folder in which you want to look, simple requirements for filenames, such as extensions, and directory names. A few examples:
		+	{\|
		+	\| <code>*</code> \|\| - Returns the filename of any file/directory in the current directory.
		+	\|-
		+	\| <code>*.dat</code> \|\| - Returns the filename of any file/directory with extension <code>.dat</code> in the current directory.
		+	\|-
		+	\| <code>MyDir\*</code> \|\| - Returns the filename of any file/directory in <code>MyDir\</code> relative to the current directory.
		+	\|-
		+	\| <code>C:\Program Files\</code> \|\| - Returns the filename of any file/directory in <code>C:\Program Files\</code>.
		+	\|}

	== Example ==		== Example ==

Sandman at 22:43, 16 June 2007

2007-06-16T22:43:16Z

←Older revision		Revision as of 22:43, 16 June 2007
Line 5:		Line 5:
	'''INT''' glob ( <'''STRING''' criteria> )		'''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.	+	Gets a single filename or directoryname 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 ==		== Parameters ==
	{\|		{\|
-	\| '''STRING''' criteria \|\| - Search criteria: the folder in which you want to look, as well as any simple requirements for filenames such as extensions.	+	\| '''STRING''' criteria \|\| - Search criteria: the folder in which you want to look, as well as any simple requirements for filenames, such as extensions, and directory names.
	\|}		\|}

	== Returns ==		== Returns ==
-	'''STRING''' : Filename	+	'''STRING''' : Filename or directoryname
	{\|		{\|
-	\| "" \|\| - No (new) file entries.	+	\| "" \|\| - No (new) file/directory entries.
	\|-		\|-
-	\| !"" \|\| - The ~~filename~~ of a file entry matching the search criteria.	+	\| !"" \|\| - The name of a file/directory entry matching the search criteria.
	\|}		\|}
		+
		+	== Notes ==
		+	After a call to glob(), the global struct [[fileinfo]] is filled with information about the file/directory entry returned.

	== Example ==		== Example ==

Woody at 00:52, 1 May 2007

2007-05-01T00:52:15Z

←Older revision		Revision as of 00:52, 1 May 2007
Line 26:		Line 26:
	String filename;		String filename;
	Begin		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:		// method two:
Line 34:		Line 46:
	End		End
	</pre>		</pre>
		+	Both methods result in the same, but the second one is less code.

Woody: /* Example */ I can't compete with dtuch efficiency

2007-04-30T18:11:47Z

Example - I can't compete with dtuch efficiency

←Older revision		Revision as of 18:11, 30 April 2007
Line 26:		Line 26:
	String filename;		String filename;
	Begin		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:		// method two:
Line 46:		Line 34:
	End		End
	</pre>		</pre>
-	Both methods result in the same, but the second one is less code.

Sandman: /* Example */

2007-04-30T01:11:11Z

Example

←Older revision		Revision as of 01:11, 30 April 2007
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.

Sandman at 14:11, 26 April 2007

2007-04-26T14:11:12Z

←Older revision		Revision as of 14:11, 26 April 2007
Line 3:		Line 3:

	==Definition==		==Definition==
		+	'''INT''' glob ( <'''STRING''' criteria> )

-	~~'''INT''' glob ( <'''STRING''' directory> )~~	+	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.
-		+
-	Gets a single filename ~~from~~ the ~~directory specified~~ and keeps returning new ones on subsequent calls until it can't find any more.	+
-		+

	== Parameters ==		== Parameters ==
-
	{\|		{\|
-	\| '''STRING''' ~~directory~~ \|\| - ~~The~~ folder in which you want to look, as well as any simple requirements for filenames such as extensions.	+	\| '''STRING''' criteria \|\| - Search criteria: the folder in which you want to look, as well as any simple requirements for filenames such as extensions.
	\|}		\|}
-

	== Returns ==		== Returns ==
-		+	'''STRING''' : Filename
-	'''STRING''' : ~~Returns the~~ filename of ~~the found~~ file~~, or an empty string if it couldn't find anything~~.	+	{\|
		+	\| "" \|\| - No (new) file entries.
		+	\|-
		+	\| !"" \|\| - The filename of a file entry matching the search criteria.
		+	\|}

	== Example ==		== Example ==
-
	<pre>		<pre>
-	~~BEGIN~~	+	Program files;
		+	Private
		+	String filename;
		+	Begin

-	~~LOOP~~	+	// 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

-	~~string1=GLOB("levels\*.tul"); //looks for a file in the relative folder "levels" that has the file extension "tul".~~	+	End
-	~~IF (string1<>"")~~	+
-	~~alllevels[z]=string1;~~	+
-	~~z++;~~	+
-	~~ELSE~~	+
-	~~numberlevels=z;~~	+
-	~~BREAK;~~	+
-	~~END~~	+

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

		+	End
	</pre>		</pre>
		+	Both method result in the same, but the second one is less code.

Woody at 15:24, 22 April 2007

2007-04-22T15:24:41Z

←Older revision		Revision as of 15:24, 22 April 2007
Line 1:		Line 1:
	[[Category:functions]]		[[Category:functions]]
		+	[[Category:files]]

	==Definition==		==Definition==

63.138.247.2: /* Returns */

2007-04-22T09:02:26Z

Returns

←Older revision		Revision as of 09:02, 22 April 2007
Line 17:		Line 17:
	== Returns ==		== Returns ==

-	'''STRING''' : Returns the filename of the found file, or an empty string ~~I think~~.	+	'''STRING''' : Returns the filename of the found file, or an empty string if it couldn't find anything.
-		+

	== Example ==		== Example ==

63.138.247.2 at 09:01, 22 April 2007

2007-04-22T09:01:13Z

New page

[[Category:functions]]

==Definition==

'''INT''' glob ( <'''STRING''' directory> )

Gets a single filename from the directory specified and keeps returning new ones on subsequent calls until it can't find any more.

== Parameters ==

{|
| '''STRING''' directory || - The folder in which you want to look, as well as any simple requirements for filenames such as extensions.
|}

== Returns ==

'''STRING''' : Returns the filename of the found file, or an empty string I think.

== Example ==

<pre>
BEGIN

LOOP

string1=GLOB("levels\*.tul"); //looks for a file in the relative folder "levels" that has the file extension "tul".
IF (string1<>"")
alllevels[z]=string1;
z++;
ELSE
numberlevels=z;
BREAK;
END

END
END

</pre>