LumpOpen: Difference between revisions
Clarify some behavior.
(Update formatting and specifications on failure) Tag: Source edit |
(Clarify some behavior.) |
||
(2 intermediate revisions by one other user not shown) | |||
Line 9: | Line 9: | ||
===Parameters=== | ===Parameters=== | ||
*''name'': The name of the lump to find. | *''name'': The name of the lump to find. | ||
*''start'': The lump index to start searching for this lump after. | *''start'': The lump index to start searching for this lump after. If not specified, the last lump loaded with the name will be returned. | ||
*''flags'': Can be a combination of the following values: | *''flags'': Can be a combination of the following values: | ||
**<code>LUMP_OPEN_FULLPATH</code>: When specified, ''name'' represents the full path of the lump. For example, | **<code>LUMP_OPEN_FULLPATH</code>: When specified, ''name'' represents the full path of the lump. For example, <code>sounds/mysound.ogg</code>. ''start'' does nothing with this flag enabled. | ||
===Return value=== | ===Return value=== | ||
Line 17: | Line 17: | ||
==Examples== | ==Examples== | ||
{{ | <syntaxhighlight lang="js" line="1"> | ||
// This script prints the lump index of all the `MAPINFO` lumps that can be found. | |||
// `CLIENTSIDE` is optional. | |||
Script 1 OPEN CLIENTSIDE | |||
{ | |||
int startIndex = -1; | |||
Log(s:"Collecting MAPINFO lumps."); | |||
while(true) | |||
{ | |||
startIndex = LumpOpen("MAPINFO", startIndex + 1); | |||
if (startIndex == -1) | |||
{ | |||
Log(s:"No more MAPINFO lumps found."); | |||
break; | |||
} | |||
Log(s:"Next MAPINFO lump was found at index ", d:startIndex, s:"."); | |||
// At this point you can read its contents with either `LumpRead` or `LumpReadString`. | |||
// Make sure to close the lump again to free the handle. | |||
LumpClose(startIndex); | |||
} | |||
} | |||
</syntaxhighlight> | |||
==See also== | |||
*[[LumpRead]] | |||
*[[LumpReadArray]] | |||
*[[LumpReadString]] | |||
*[[LumpGetInfo]] | |||
*[[LumpClose]] | |||
[[Category:ACS functions]] | [[Category:ACS functions]] |