register_native

Syntax

native register_native(const name[], const handler[], style = 0);

Usage

Native name

Callback function

Native style

Description

Registers a native.

Note

• Style 0 natives call the handler in the following manner:
  
  public native_handler(plugin_id, argc)
  
  plugin_id - plugin calling the native
  argc - number of parameters

• Style 1 natives are deprecated. Plugins should not use them, they might
  break.

• Style 1 natives work a little different. Instead of passing plugin id
  and number of parameters, the handler should be prototyped just like the
  native would be called. For each by-reference parameter, the plugin
  then has to use param_convert() to properly use them.

• A native should *never* recurse. Bad things will happen.

Return

This function has no return value.

Error

If an invalid callback is specified, an error is thrown.