Callable¶

An object representing a method in a certain object that can be called.

Description¶

Callable is a first class object which can be held in variables and passed to functions. It represents a given method in an Object, and is typically used for signal callbacks.

Example:

func print_args(arg1, arg2, arg3 = ""):
    prints(arg1, arg2, arg3)

func test():
    var callable = Callable(self, "print_args")
    callable.call("hello", "world")  # Prints "hello world ".
    callable.call(Vector2.UP, 42, callable)  # Prints "(0, -1) 42 Node(Node.gd)::print_args".
    callable.call("invalid")  # Invalid call, should have at least 2 arguments.

public void PrintArgs(object arg1, object arg2, object arg3 = null)
{
    GD.PrintS(arg1, arg2, arg3);
}

public void Test()
{
    Callable callable = new Callable(this, nameof(PrintArgs));
    callable.Call("hello", "world"); // Prints "hello world null".
    callable.Call(Vector2.Up, 42, callable); // Prints "(0, -1) 42 Node(Node.cs)::PrintArgs".
    callable.Call("invalid"); // Invalid call, should have at least 2 arguments.
}

Methods¶

Callable	Callable ( ) constructor
Callable	Callable ( Callable from ) constructor
Callable	Callable ( Object object, StringName method ) constructor
Callable	bind ( ... ) vararg const
Variant	call ( ... ) vararg const
void	call_deferred ( ... ) vararg const
StringName	get_method ( ) const
Object	get_object ( ) const
int	get_object_id ( ) const
int	hash ( ) const
bool	is_custom ( ) const
bool	is_null ( ) const
bool	is_standard ( ) const
bool	is_valid ( ) const
bool	operator != ( ) operator
bool	operator != ( Callable right ) operator
bool	operator == ( ) operator
bool	operator == ( Callable right ) operator
void	rpc ( ... ) vararg const
void	rpc_id ( int peer_id, ... ) vararg const
Callable	unbind ( int argcount ) const

Method Descriptions¶

Callable Callable ( ) constructor

Constructs a null Callable with no object nor method bound.

Callable Callable ( Callable from ) constructor

Constructs a Callable as a copy of the given Callable.

Callable Callable ( Object object, StringName method ) constructor

Creates a new Callable for the method called method in the specified object.

Callable bind ( ... ) vararg const

Returns a copy of this Callable with the arguments bound. Bound arguments are passed after the arguments supplied by call.

Variant call ( ... ) vararg const

Calls the method represented by this Callable. Arguments can be passed and should match the method's signature.

void call_deferred ( ... ) vararg const

Calls the method represented by this Callable in deferred mode, i.e. during the idle frame. Arguments can be passed and should match the method's signature.

StringName get_method ( ) const

Returns the name of the method represented by this Callable.

Object get_object ( ) const

Returns the object on which this Callable is called.

int get_object_id ( ) const

Returns the ID of this Callable's object (see Object.get_instance_id).

int hash ( ) const

Returns the hash value of this Callable's object.

bool is_custom ( ) const

Returns true if this Callable is a custom callable whose behavior differs based on implementation details. Custom callables are used in the engine for various reasons. If true, you can't use get_method.

bool is_null ( ) const

Returns true if this Callable has no target to call the method on.

bool is_standard ( ) const

Returns true if this Callable is a standard callable, referencing an object and a method using a StringName.

bool is_valid ( ) const

Returns true if the object exists and has a valid function assigned, or is a custom callable.

bool operator != ( ) operator

bool operator != ( Callable right ) operator

Returns true if both Callables invoke different targets.

bool operator == ( ) operator

bool operator == ( Callable right ) operator

Returns true if both Callables invoke the same custom target.

void rpc ( ... ) vararg const

Perform an RPC (Remote Procedure Call). This is used for multiplayer and is normally not available unless the function being called has been marked as RPC. Calling it on unsupported functions will result in an error.

void rpc_id ( int peer_id, ... ) vararg const

Perform an RPC (Remote Procedure Call) on a specific peer ID (see multiplayer documentation for reference). This is used for multiplayer and is normally not available unless the function being called has been marked as RPC. Calling it on unsupported functions will result in an error.

Callable unbind ( int argcount ) const

Returns a copy of this Callable with the arguments unbound. Calling the returned Callable will call the method without the extra arguments that are supplied in the Callable on which you are calling this method.