Skip to content

Add extern to global struct variables in GDExtension C example #11389

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 22, 2025
+27 −19
Merged

Add extern to global struct variables in GDExtension C example #11389

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 27 additions & 19 deletions tutorials/scripting/gdextension/gdextension_c_example.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -306,17 +306,17 @@ We'll start by creating an ``api.h`` file in the ``src`` folder:

// API methods.

struct Constructors
extern struct Constructors
{
GDExtensionInterfaceStringNameNewWithLatin1Chars string_name_new_with_latin1_chars;
} constructors;

struct Destructors
extern struct Destructors
{
GDExtensionPtrDestructor string_name_destructor;
} destructors;

struct API
extern struct API
{
GDExtensionInterfaceClassdbRegisterExtensionClass2 classdb_register_extension_class2;
} api;
Expand Down Expand Up @@ -345,6 +345,10 @@ in the ``src`` folder, adding the following code:

GDExtensionClassLibraryPtr class_library = NULL;

struct Constructors constructors;
struct Destructors destructors;
struct API api;

void load_api(GDExtensionInterfaceGetProcAddress p_get_proc_address)
{
// Get helper functions first.
Expand Down Expand Up @@ -539,7 +543,7 @@ So let's change the ``api.h`` to include these new functions:
.. code-block:: c

...
struct API
extern struct API
{
GDExtensionInterfaceClassdbRegisterExtensionClass2 classdb_register_extension_class2;
GDExtensionInterfaceClassdbConstructObject classdb_construct_object;
Expand Down Expand Up @@ -862,13 +866,13 @@ structs:

.. code-block:: c

struct Constructors {
extern struct Constructors {
...
GDExtensionVariantFromTypeConstructorFunc variant_from_float_constructor;
GDExtensionTypeFromVariantConstructorFunc float_from_variant_constructor;
} constructors;

struct API
extern struct API
{
...
GDExtensionInterfaceGetVariantFromTypeConstructor get_variant_from_type_constructor;
Expand Down Expand Up @@ -1006,19 +1010,19 @@ function for actually binding our custom method.

.. code-block:: c

struct Constructors
extern struct Constructors
{
...
GDExtensionInterfaceStringNewWithUtf8Chars string_new_with_utf8_chars;
} constructors;

struct Destructors
extern struct Destructors
{
...
GDExtensionPtrDestructor string_destructor;
} destructors;

struct API
extern struct API
{
...
GDExtensionInterfaceClassdbRegisterExtensionClassMethod classdb_register_extension_class_method;
Expand Down Expand Up @@ -1328,7 +1332,7 @@ the ``api.h`` file:

.. code-block:: c

struct API {
extern struct API {
...
GDExtensionInterfaceClassdbRegisterExtensionClassProperty classdb_register_extension_class_property;
} api;
Expand Down Expand Up @@ -1487,7 +1491,7 @@ We'll also add a new struct to this file, to hold function pointers for custom o

.. code-block:: c

struct Operators
extern struct Operators
{
GDExtensionPtrOperatorEvaluator string_name_equal;
} operators;
Expand All @@ -1496,6 +1500,8 @@ Then in the ``api.c`` file we'll load the function pointer from the API:

.. code-block:: c

struct Operators operators;

void load_api(GDExtensionInterfaceGetProcAddress p_get_proc_address)
{
// Get helper functions first.
Expand Down Expand Up @@ -1654,20 +1660,20 @@ new one for holding engine methods to call.

.. code-block:: c

struct Constructors
extern struct Constructors
{
...
GDExtensionPtrConstructor vector2_constructor_x_y;
} constructors;

...

struct Methods
extern struct Methods
{
GDExtensionMethodBindPtr node2d_set_position;
} methods;

struct API
extern struct API
{
...
GDExtensionInterfaceClassdbGetMethodBind classdb_get_method_bind;
Expand All @@ -1678,6 +1684,8 @@ Then in the ``api.c`` file we can grab the function pointers from Godot:

.. code-block::

struct Methods methods;

void load_api(GDExtensionInterfaceGetProcAddress p_get_proc_address)
{
// Get helper functions first.
Expand Down Expand Up @@ -1807,7 +1815,7 @@ register a signal, the other is a helper function to wrap the signal binding.

.. code-block:: c

struct API
extern struct API
{
...
GDExtensionInterfaceClassdbRegisterExtensionClassSignal classdb_register_extension_class_signal;
Expand Down Expand Up @@ -1928,28 +1936,28 @@ helper function for the call:

.. code-block:: c

struct Constructors
extern struct Constructors
{
...
GDExtensionVariantFromTypeConstructorFunc variant_from_string_name_constructor;
GDExtensionVariantFromTypeConstructorFunc variant_from_vector2_constructor;
} constructors;

struct Destructors
extern struct Destructors
{
..
GDExtensionInterfaceVariantDestroy variant_destroy;
} destructors;

...

struct Methods
extern struct Methods
{
...
GDExtensionMethodBindPtr object_emit_signal;
} methods;

struct API
extern struct API
{
...
GDExtensionInterfaceObjectMethodBindCall object_method_bind_call;
Expand Down
Loading