Flummi/amxmodx
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

amxmodx/cellarray: Assorted consistency updates and typo fixes

Browse Source
This commit is contained in:
Valentin Grünbacher 2014-08-07 23:02:39 +02:00
parent 8b42767b19
commit a63042d961
2 changed files with 71 additions and 67 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
plugins/include/amxmodx.inc
View File

@ -420,7 +420,7 @@ native console_print(id, const message[], any:...);
* @param cmd Formatting rules * @param cmd Formatting rules
* @param ... Variable number of formatting parameters * @param ... Variable number of formatting parameters
* *
* @return The length of the formatted command. * @return Length of the formatted command
*/ */
native console_cmd(id, const cmd[], any:...); native console_cmd(id, const cmd[], any:...);
@ -615,7 +615,7 @@ native show_dhudmessage(index, const message[], any:...);
* @param time Menu timeout in seconds, -1 to disable * @param time Menu timeout in seconds, -1 to disable
* @param title Name of the menu for internal tracking purposes * @param title Name of the menu for internal tracking purposes
*/ */
native show_menu(index, keys, const menu[], time = -1, const title[] = ""); native show_menu(index, keys, const menu[], time=-1, const title[]="");
/** /**
* Retrieves values from a client message. * Retrieves values from a client message.
@ -723,7 +723,7 @@ native read_logargv(id, output[], len);
* @error If the provided string is not valid client log data, an * @error If the provided string is not valid client log data, an
* error will be thrown. * error will be thrown.
*/ */
native parse_loguser(const text[], name[], nlen, &userid = -2, authid[] = "", alen = 0, team[]="", tlen=0); native parse_loguser(const text[], name[], nlen, &userid=-2, authid[]="", alen=0, team[]="", tlen=0);
/** /**
* Sends a message to the console of the server. * Sends a message to the console of the server.
@ -930,7 +930,7 @@ native get_user_deaths(index);
native get_user_health(index); native get_user_health(index);
/** /**
* Retrieve a client's index by name. * Retrieves a client's index by name.
* *
* @param name Name to search for * @param name Name to search for
* *
@ -948,7 +948,7 @@ native get_user_index(const name[]);
* *
* @return Number of cells written to the buffer * @return Number of cells written to the buffer
*/ */
native get_user_ip(index, ip[], len, without_port = 0); native get_user_ip(index, ip[], len, without_port=0);
/** /**
* Returns if the client has the specified weapon in their inventory. * Returns if the client has the specified weapon in their inventory.
@ -1021,7 +1021,7 @@ native num_to_word(num, output[], len);
* @return Team index on success, -1 if client index is invalid or * @return Team index on success, -1 if client index is invalid or
* the client is not connected. * the client is not connected.
*/ */
native get_user_team(index, team[]="", len = 0); native get_user_team(index, team[]="", len=0);
/** /**
* Returns client's playing time in seconds. * Returns client's playing time in seconds.
@ -1033,7 +1033,7 @@ native get_user_team(index, team[]="", len = 0);
* @return Connection time in seconds, 0 if client index is invalid or * @return Connection time in seconds, 0 if client index is invalid or
* client is not connected * client is not connected
*/ */
native get_user_time(index, flag = 0); native get_user_time(index, flag=0);
/** /**
* Retrieves the ping and loss of a client. * Retrieves the ping and loss of a client.
@ -1063,7 +1063,7 @@ native get_user_ping(index, &ping, &loss);
* @error If the client index is not within the range of 1 to * @error If the client index is not within the range of 1 to
* MaxClients an error will be thrown. * MaxClients an error will be thrown.
*/ */
native get_user_origin(index, origin[3], mode = 0); native get_user_origin(index, origin[3], mode=0);
/** /**
* Retrieves all weapons in the client inventory, stores them in an array and * Retrieves all weapons in the client inventory, stores them in an array and
@ -1374,7 +1374,7 @@ native engclient_cmd(index, const command[], const arg1[]="", const arg2[]="");
* command hooks. For an alternative that doesn't, see engclient_cmd(). * command hooks. For an alternative that doesn't, see engclient_cmd().
* *
* @param index Client index, use 0 to execute from all clients. * @param index Client index, use 0 to execute from all clients.
* @param command The client command to execute on * @param command Client command to execute on
* @param arg1 Optional command arguments * @param arg1 Optional command arguments
* @param arg2 Optional command arguments * @param arg2 Optional command arguments
* *
@ -1382,7 +1382,7 @@ native engclient_cmd(index, const command[], const arg1[]="", const arg2[]="");
* @error If a single client is specified and the index is not * @error If a single client is specified and the index is not
* within the range of 1 to MaxClients an error will be thrown * within the range of 1 to MaxClients an error will be thrown
*/ */
native amxclient_cmd(index, const command[], const arg1[] = "", const arg2[] = ""); native amxclient_cmd(index, const command[], const arg1[]="", const arg2[]="");
/** /**
* Queues a command to be executed from the server console. * Queues a command to be executed from the server console.
@ -1442,7 +1442,7 @@ native cvar_exists(const cvar[]);
* *
* @return 1 on success, 0 if cvar does not exist or is not permitted * @return 1 on success, 0 if cvar does not exist or is not permitted
*/ */
native remove_cvar_flags(const cvar[], flags = -1); native remove_cvar_flags(const cvar[], flags=-1);
/** /**
* Sets specified flags to a cvar. The cvar is accessed by name. * Sets specified flags to a cvar. The cvar is accessed by name.
@ -1635,7 +1635,7 @@ native get_time(const format[], output[], len);
* @return Number of cells written to buffer * @return Number of cells written to buffer
* @error If the conversion process fails, an error will be thrown * @error If the conversion process fails, an error will be thrown
*/ */
native format_time(output[], len, const format[], time = -1); native format_time(output[], len, const format[], time=-1);
/** /**
* Returns the system time as a unix timestamp (number of seconds since unix * Returns the system time as a unix timestamp (number of seconds since unix
@ -1646,7 +1646,7 @@ native format_time(output[], len, const format[], time = -1);
* @return Unix time stamp * @return Unix time stamp
* @error * @error
*/ */
native get_systime(offset = 0); native get_systime(offset=0);
/** /**
* Converts time string to unix time stamp. * Converts time string to unix time stamp.
@ -1666,7 +1666,7 @@ native get_systime(offset = 0);
* @return Unix time stamp * @return Unix time stamp
* @error If the conversion process fails, an error will be thrown * @error If the conversion process fails, an error will be thrown
*/ */
native parse_time(const input[], const format[], time = -1); native parse_time(const input[], const format[], time=-1);
/** /**
* Calls a function after a specified time has elapsed. * Calls a function after a specified time has elapsed.
@ -1686,7 +1686,7 @@ native parse_time(const input[], const format[], time = -1);
* @param repeat If the "a" flag is set the task will be repeated this * @param repeat If the "a" flag is set the task will be repeated this
* many times * many times
*/ */
native set_task(Float:time, const function[], id = 0, const parameter[]="", len = 0, const flags[]="", repeat = 0); native set_task(Float:time, const function[], id=0, const parameter[]="", len=0, const flags[]="", repeat=0);
/** /**
* Removes all tasks with the specified id. * Removes all tasks with the specified id.
@ -1696,7 +1696,7 @@ native set_task(Float:time, const function[], id = 0, const parameter[]="", len
* *
* @return Number of removed tasks * @return Number of removed tasks
*/ */
native remove_task(id = 0, outside = 0); native remove_task(id=0, outside=0);
/** /**
* Modifies the time interval of all tasks with the specified id. * Modifies the time interval of all tasks with the specified id.
@ -1707,7 +1707,7 @@ native remove_task(id = 0, outside = 0);
* *
* @return Number of affected tasks * @return Number of affected tasks
*/ */
native change_task(id = 0, Float:newTime=1.0, outside = 0); native change_task(id=0, Float:newTime=1.0, outside=0);
/** /**
* Returns if a task with the specified id exists. * Returns if a task with the specified id exists.
@ -1717,7 +1717,7 @@ native change_task(id = 0, Float:newTime=1.0, outside = 0);
* *
* @return 1 if a task was found, 0 otherwise * @return 1 if a task was found, 0 otherwise
*/ */
native task_exists(id = 0, outside = 0); native task_exists(id=0, outside=0);
/** /**
* Sets the specified admin flags to a client. * Sets the specified admin flags to a client.
@ -1958,7 +1958,7 @@ native get_concmd_plid(cid, flag_mask, id_type);
* *
* @return Number of registered console commants * @return Number of registered console commants
*/ */
native get_concmdsnum(flag, id = -1); native get_concmdsnum(flag, id=-1);
/** /**
* Returns the number of plugin-registered cvars. * Returns the number of plugin-registered cvars.
@ -2069,7 +2069,7 @@ native emit_sound(index, channel, const sample[], Float:vol, Float:att, flags, p
* *
* @return Unique cvar pointer * @return Unique cvar pointer
*/ */
native register_cvar(const name[], const string[], flags = 0, Float:fvalue = 0.0); native register_cvar(const name[], const string[], flags=0, Float:fvalue=0.0);
/** /**
* Returns a random floating point value generated by the engine. * Returns a random floating point value generated by the engine.
@ -2180,7 +2180,7 @@ native Float:get_xvar_float(id);
* @noreturn * @noreturn
* @error If an invalid xvar id is specified an error will be thrown. * @error If an invalid xvar id is specified an error will be thrown.
*/ */
native set_xvar_num(id, value = 0); native set_xvar_num(id, value=0);
/** /**
* Sets the float value of a public variable. * Sets the float value of a public variable.
@ -2196,7 +2196,7 @@ native set_xvar_num(id, value = 0);
* @noreturn * @noreturn
* @error If an invalid xvar id is specified an error will be thrown. * @error If an invalid xvar id is specified an error will be thrown.
*/ */
native set_xvar_float(id, Float:value = 0.0); native set_xvar_float(id, Float:value=0.0);
/** /**
* Returns if a module is loaded. * Returns if a module is loaded.
@ -2275,7 +2275,7 @@ native get_plugin(index, filename[]="", len1=0, name[]="", len2=0, version[]="",
/** /**
* Returns the number of loaded AMXX plugins. * Returns the number of loaded AMXX plugins.
* *
* @return The number of loaded plugins * @return Number of loaded plugins
*/ */
native get_pluginsnum(); native get_pluginsnum();
@ -2358,10 +2358,10 @@ native callfunc_begin(const func[], const plugin[]="");
* @error If called while another callfunc has not yet been finished, * @error If called while another callfunc has not yet been finished,
* or the specified function is invalid, an error is thrown. * or the specified function is invalid, an error is thrown.
*/ */
native callfunc_begin_i(func, plugin = -1); native callfunc_begin_i(func, plugin=-1);
/** /**
* Retrieve a functions id for use with callfunc_begin_i() * Retrieves a functions id for use with callfunc_begin_i()
* *
* @param funcName Function name * @param funcName Function name
* @param pluginId Plugin id. If -1 the calling plugin is targeted. The plugin * @param pluginId Plugin id. If -1 the calling plugin is targeted. The plugin
@ -2370,7 +2370,7 @@ native callfunc_begin_i(func, plugin = -1);
* @return >0 Function id on success * @return >0 Function id on success
* -1 if plugin or function was not found * -1 if plugin or function was not found
*/ */
native get_func_id(const funcName[], pluginId = -1); native get_func_id(const funcName[], pluginId=-1);
/** /**
* Pushes an int value onto the current call. * Pushes an int value onto the current call.
@ -2826,7 +2826,7 @@ native set_array_f(param, const Float:source[], size);
* unavailable or the querying process runs out of memory, * unavailable or the querying process runs out of memory,
* an error will be thrown. * an error will be thrown.
*/ */
native query_client_cvar(id, const cvar[], const resultFunc[], paramlen=0, const params[] = ""); native query_client_cvar(id, const cvar[], const resultFunc[], paramlen=0, const params[]="");
/** /**
* Allows to trap error messages that occur in a plugin. * Allows to trap error messages that occur in a plugin.

84
plugins/include/cellarray.inc
View File

@ -52,7 +52,7 @@ stock ByteCountToCells(size)
* Creates a handle to a dynamically sized array. * Creates a handle to a dynamically sized array.
* *
* @note It is very important that the provided cellsize matches up with the * @note It is very important that the provided cellsize matches up with the
* buffer sizes that you pass with subsequent Array[Get|Set|Push] calls. * buffer sizes that are passed with subsequent Array[Get|Set|Push] calls.
* @note Initially the "reserved" parameter was intended to create blank entries * @note Initially the "reserved" parameter was intended to create blank entries
* that would immediately be usable with Array[Get|Set] functions. This * that would immediately be usable with Array[Get|Set] functions. This
* functionality was never working as intended, and can now be achieved * functionality was never working as intended, and can now be achieved
@ -73,7 +73,8 @@ native Array:ArrayCreate(cellsize = 1, reserved = 32);
* @param which Array handle * @param which Array handle
* *
* @return Handle to the cloned array on success, 0 otherwise * @return Handle to the cloned array on success, 0 otherwise
* @error If an invalid handle is provided an error will be thrown * @error If an invalid handle is provided an error will be
* thrown.
*/ */
native Array:ArrayClone(Array:which); native Array:ArrayClone(Array:which);
@ -93,7 +94,8 @@ native ArrayClear(Array:which);
* @param which Array handle * @param which Array handle
* *
* @return Number of elements in the array * @return Number of elements in the array
* @error If an invalid handle is provided an error will be thrown * @error If an invalid handle is provided an error will be
* thrown.
*/ */
native ArraySize(Array:which); native ArraySize(Array:which);
@ -108,7 +110,7 @@ native ArraySize(Array:which);
* *
* @noreturn * @noreturn
* @error If an invalid handle is provided or the resizing * @error If an invalid handle is provided or the resizing
* operation runs out of memory, an error will be thrown * operation runs out of memory, an error will be thrown.
*/ */
native bool:ArrayResize(Array:which, newsize); native bool:ArrayResize(Array:which, newsize);
@ -141,7 +143,7 @@ native ArrayGetArray(Array:which, item, any:output[], size = -1);
* *
* @return Integer value * @return Integer value
* @error If an invalid handle, index or block is provided an * @error If an invalid handle, index or block is provided an
* error will be thrown * error will be thrown.
*/ */
native any:ArrayGetCell(Array:which, item, block = 0, bool:asChar = false); native any:ArrayGetCell(Array:which, item, block = 0, bool:asChar = false);
@ -155,7 +157,7 @@ native any:ArrayGetCell(Array:which, item, block = 0, bool:asChar = false);
* *
* @return Number of characters copied * @return Number of characters copied
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArrayGetString(Array:which, item, output[], size); native ArrayGetString(Array:which, item, output[], size);
@ -175,7 +177,7 @@ native ArrayGetString(Array:which, item, output[], size);
* *
* @return Number of cells copied * @return Number of cells copied
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArraySetArray(Array:which, item, const any:input[], size =-1); native ArraySetArray(Array:which, item, const any:input[], size =-1);
@ -194,7 +196,7 @@ native ArraySetArray(Array:which, item, const any:input[], size =-1);
* *
* @noreturn * @noreturn
* @error If an invalid handle, index or block is provided an * @error If an invalid handle, index or block is provided an
* error will be thrown * error will be thrown.
*/ */
native ArraySetCell(Array:which, item, any:input, block = 0, bool:asChar = false); native ArraySetCell(Array:which, item, any:input, block = 0, bool:asChar = false);
@ -212,7 +214,7 @@ native ArraySetCell(Array:which, item, any:input, block = 0, bool:asChar = false
* *
* @return Number of characters copied * @return Number of characters copied
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArraySetString(Array:which, item, const input[]); native ArraySetString(Array:which, item, const input[]);
@ -230,7 +232,7 @@ native ArraySetString(Array:which, item, const input[]);
* *
* @return Index of the new entry * @return Index of the new entry
* @error If an invalid handle is provided or the resizing * @error If an invalid handle is provided or the resizing
* operation runs out of memory, an error will be thrown * operation runs out of memory, an error will be thrown.
*/ */
native ArrayPushArray(Array:which, const any:input[], size = -1); native ArrayPushArray(Array:which, const any:input[], size = -1);
@ -243,7 +245,7 @@ native ArrayPushArray(Array:which, const any:input[], size = -1);
* *
* @return Index of the new entry * @return Index of the new entry
* @error If an invalid handle is provided or the resizing * @error If an invalid handle is provided or the resizing
* operation runs out of memory, an error will be thrown * operation runs out of memory, an error will be thrown.
*/ */
native ArrayPushCell(Array:which, any:input); native ArrayPushCell(Array:which, any:input);
@ -259,7 +261,7 @@ native ArrayPushCell(Array:which, any:input);
* *
* @return Index of the new entry * @return Index of the new entry
* @error If an invalid handle is provided or the resizing * @error If an invalid handle is provided or the resizing
* operation runs out of memory, an error will be thrown * operation runs out of memory, an error will be thrown.
*/ */
native ArrayPushString(Array:which, const input[]); native ArrayPushString(Array:which, const input[]);
@ -273,7 +275,7 @@ native ArrayPushString(Array:which, const input[]);
* *
* @noreturn * @noreturn
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArrayInsertArrayAfter(Array:which, item, const any:input[]); native ArrayInsertArrayAfter(Array:which, item, const any:input[]);
@ -283,11 +285,11 @@ native ArrayInsertArrayAfter(Array:which, item, const any:input[]);
* *
* @param which Array handle * @param which Array handle
* @param item Item index in the array * @param item Item index in the array
* @param input The value to set. * @param input Value to set
* *
* @noreturn * @noreturn
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArrayInsertCellAfter(Array:which, item, any:input); native ArrayInsertCellAfter(Array:which, item, any:input);
@ -304,7 +306,7 @@ native ArrayInsertCellAfter(Array:which, item, any:input);
* *
* @noreturn * @noreturn
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArrayInsertStringAfter(Array:which, item, const input[]); native ArrayInsertStringAfter(Array:which, item, const input[]);
@ -318,7 +320,7 @@ native ArrayInsertStringAfter(Array:which, item, const input[]);
* *
* @noreturn * @noreturn
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArrayInsertArrayBefore(Array:which, item, const any:input[]); native ArrayInsertArrayBefore(Array:which, item, const any:input[]);
@ -332,7 +334,7 @@ native ArrayInsertArrayBefore(Array:which, item, const any:input[]);
* *
* @noreturn * @noreturn
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArrayInsertCellBefore(Array:which, item, const any:input); native ArrayInsertCellBefore(Array:which, item, const any:input);
@ -349,7 +351,7 @@ native ArrayInsertCellBefore(Array:which, item, const any:input);
* *
* @noreturn * @noreturn
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArrayInsertStringBefore(Array:which, item, const input[]); native ArrayInsertStringBefore(Array:which, item, const input[]);
@ -361,24 +363,24 @@ native ArrayInsertStringBefore(Array:which, item, const input[]);
* *
* @noreturn * @noreturn
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArraySwap(Array:which, item1, item2); native ArraySwap(Array:which, item1, item2);
/** /**
* Deletes an item from the array. All items beyond it get shifted down by one. * Deletes an item from the array. All items beyond it get shifted down by one.
* *
* @param which The array that contains the item to delete. * @param which Array handle
* @param item The item to delete. * @param item Item to delete
* *
* @noreturn * @noreturn
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native ArrayDeleteItem(Array:which, item); native ArrayDeleteItem(Array:which, item);
/** /**
* Searches through the array and returns the index of the first occurance of * Searches through the array and returns the index of the first occurence of
* the specified string. * the specified string.
* *
* @param which Array handle * @param which Array handle
@ -390,14 +392,15 @@ native ArrayDeleteItem(Array:which, item);
native ArrayFindString(Array:which, const item[]); native ArrayFindString(Array:which, const item[]);
/** /**
* Searches through the array and returns the index of the first occurance of * Searches through the array and returns the index of the first occurence of
* the specified value. * the specified value.
* *
* @param which Array handle. * @param which Array handle
* @param item Value to search for * @param item Value to search for
* *
* @return Array index on success, -1 if the value can't be found * @return Array index on success, -1 if the value can't be found
* @error Invalid handle. * @error If an invalid handle is provided an error will be
* thrown.
*/ */
native ArrayFindValue(Array:which, any:item); native ArrayFindValue(Array:which, any:item);
@ -416,7 +419,7 @@ native ArrayFindValue(Array:which, any:item);
* *
* @return Handle to the item * @return Handle to the item
* @error If an invalid handle or an invalid index is provided an * @error If an invalid handle or an invalid index is provided an
* error will be thrown * error will be thrown.
*/ */
native DoNotUse:ArrayGetStringHandle(Array:which, item); native DoNotUse:ArrayGetStringHandle(Array:which, item);
@ -426,16 +429,15 @@ native DoNotUse:ArrayGetStringHandle(Array:which, item);
* @note The function automatically sets the variable passed to it to 0 to aid * @note The function automatically sets the variable passed to it to 0 to aid
* in preventing accidental usage after destroy. * in preventing accidental usage after destroy.
* *
* @param which The array to destroy. * @param which Array to destroy
* *
* @return 1 if the array was destroyed, 0 if nothing had to be * @return 1 if the array was destroyed, 0 if nothing had to be
* destroyed (invalid handle) * destroyed (invalid handle)
*/ */
native ArrayDestroy(&Array:which); native ArrayDestroy(&Array:which);
/** /**
* Similar to sorting.inc's CustomSort, the sorting algorithm then uses your * Similar to sorting.inc's CustomSort, the sorting algorithm then uses the
* custom comparison function to sort the data. * custom comparison function to sort the data.
* *
* @note The function is called in the following manner: * @note The function is called in the following manner:
@ -452,8 +454,8 @@ native ArrayDestroy(&Array:which);
* 0 if item1 and item2 are equal * 0 if item1 and item2 are equal
* 1 if item1 should go after item2 * 1 if item1 should go after item2
* *
* @note All parameters after item2 are optional and you do not need to specify * @note All parameters after item2 are optional and do not need to be specified
* and use them. * and used.
* @note Unlike the sorting.inc version, the array passed to the callback is not * @note Unlike the sorting.inc version, the array passed to the callback is not
* in mid-sorted state. * in mid-sorted state.
* *
@ -463,16 +465,17 @@ native ArrayDestroy(&Array:which);
* @param data_size Size of extra data * @param data_size Size of extra data
* *
* @noreturn * @noreturn
* @error Invalid handle or invalid callback. * @error If an invalid handle or an invalid callback is provided
* an error will be thrown.
*/ */
native ArraySort(Array:array, const comparefunc[], data[]="", data_size=0); native ArraySort(Array:array, const comparefunc[], data[]="", data_size=0);
/** /**
* A faster version of ArraySort, the sorting algorithm then uses your custom * A faster version of ArraySort, the sorting algorithm then uses the custom
* comparison function to sort the data. * comparison function to sort the data.
* *
* @note The advantage of this function is that the data of the elements being * @note The advantage of this function is that the data of the elements being
* compared is directly passed to your function, instead of the item * compared is directly passed to the function, instead of the item
* indexes that are passed by ArraySort. This removes the need for calling * indexes that are passed by ArraySort. This removes the need for calling
* ArrayGet[Cell|String|Array] every time before being able to compare the * ArrayGet[Cell|String|Array] every time before being able to compare the
* elements. * elements.
@ -492,7 +495,7 @@ native ArraySort(Array:array, const comparefunc[], data[]="", data_size=0);
* *
* public MySortFunc(Array:array, elem1[], elem2[], const data[], data_size) * public MySortFunc(Array:array, elem1[], elem2[], const data[], data_size)
* *
* array - Array handle in its current un-sorted state. * array - Array handle in its current un-sorted state
* elem1[], elem2[] - Current element pair being compared * elem1[], elem2[] - Current element pair being compared
* data[] - Extra data array passed to the sort func * data[] - Extra data array passed to the sort func
* data_size - Size of extra data * data_size - Size of extra data
@ -503,8 +506,8 @@ native ArraySort(Array:array, const comparefunc[], data[]="", data_size=0);
* 0 if elem1 and elem2 are equal * 0 if elem1 and elem2 are equal
* 1 if elem1 should go after elem2 * 1 if elem1 should go after elem2
* *
* @note All parameters after item2 are optional and you do not need to specify * @note All parameters after item2 are optional and do not need to be specified
* and use them. * and used.
* @note Unlike the sorting.inc version, the array passed to the callback is not * @note Unlike the sorting.inc version, the array passed to the callback is not
* in mid-sorted state. * in mid-sorted state.
* *
@ -514,6 +517,7 @@ native ArraySort(Array:array, const comparefunc[], data[]="", data_size=0);
* @param data_size Size of extra data * @param data_size Size of extra data
* *
* @noreturn * @noreturn
* @error Invalid handle, invalid callback or out of memory. * @error If an invalid handle or an invalid callback is provided
* an error will be thrown.
*/ */
native ArraySortEx(Array:array, const comparefunc[], data[]="", data_size=0); native ArraySortEx(Array:array, const comparefunc[], data[]="", data_size=0);