This wiki is archived and useful information is being migrated to the main bzflag.org website

Difference between revisions of "Bz getLoadedPlugins"

From BZFlagWiki
Jump to: navigation, search
(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[edit]

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;