Merge pull request #11389 from dsnopek/gdextension-c-extern

Add `extern` to global struct variables in GDExtension C example

Author: mhilbrunner

tutorials/scripting/gdextension/gdextension_c_example.rst

@@ -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;
@@ -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.
@@ -537,7 +541,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;
@@ -860,13 +864,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;
@@ -1004,19 +1008,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;
@@ -1326,7 +1330,7 @@ the ``api.h`` file:
 
 .. code-block:: c
 
-    struct API {
+    extern struct API {
         ...
         GDExtensionInterfaceClassdbRegisterExtensionClassProperty classdb_register_extension_class_property;
     } api;
@@ -1485,7 +1489,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;
@@ -1494,6 +1498,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.
@@ -1652,20 +1658,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;
@@ -1676,6 +1682,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.
@@ -1805,7 +1813,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;
@@ -1926,28 +1934,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;