This wiki was in read-only mode for many years, but can now be edited again. A lot of information will need to be updated.

Bz getLoadedPlugins: Difference between revisions

From BZFlagWiki
Jump to navigation Jump to search
No edit summary
Sigonasr2 (talk | contribs)
Updated to the modern template. Added example.
 
Line 1: Line 1:
{{BZFS_API_Doc}}{{BZFS_API_Funcs}}
{{apicall
==Syntax==
| name          = bz_getLoadedPlugins
int bz_getLoadedPlugins( [[bz_APIStringList]] * list )
| returns      = The number of plugins that are currently loaded.
| returntype    = int
| description  = Retrieves the names of all loaded plugins and counts how many of them there are.
| param1      = list
| param1type  = [[bz_APIStringList]]*
| param1desc  = The pointer to a [[bz_APIStringList]] list for storing/appending the plugin names to.
}}


==Parameters==
===Example===
* '''''list''''': A pointer to the [[bz_APIStringList]] to store the names of all loaded plug-ins.
Displays the list of plugins when a player joins the server, mimicking the output you would expect from the command '''/listplugins'''.
 
case bz_ePlayerJoinEvent: {
==Returns==
bz_APIStringList list;
The number of loaded plugins.
int count=bz_getLoadedPlugins(&list);
 
for (int i=0;i<count;i++) {
==Description==
bz_sendTextMessagef(BZ_SERVER,((bz_PlayerJoinPartEventData_V1*)eventData)->playerID,"%d %s",i+1,list.get(i).c_str());
This API function appends all currently loaded plug-ins to the end of a [[bz_APIStringList]].
}
 
}break;
==See Also==
[[bz_loadPlugin]]
 
[[bz_unloadPlugin]]
 
[[bz_registerCustomPluginHandler]]
 
[[bz_removeCustomPluginHandler]]

Latest revision as of 10:03, 19 October 2011

int bz_getLoadedPlugins (bz_APIStringList* list)


Retrieves the names of all loaded plugins and counts how many of them there are.

Parameters:
list  -  The pointer to a bz_APIStringList list for storing/appending the plugin names to.
Returns:
The number of plugins that are currently loaded.


Example

Displays the list of plugins when a player joins the server, mimicking the output you would expect from the command /listplugins.

case bz_ePlayerJoinEvent: {
	bz_APIStringList list;
	int count=bz_getLoadedPlugins(&list);
	for (int i=0;i<count;i++) {
		bz_sendTextMessagef(BZ_SERVER,((bz_PlayerJoinPartEventData_V1*)eventData)->playerID,"%d %s",i+1,list.get(i).c_str());
	}
}break;