fbdocs: wiki snapshow 2021.06.28 - new pages

Author: jayrm

doc/manual/cache/CatPgFullIndex.wakka

@@ -558,6 +558,7 @@ Alphabetical listing of keywords, macros and procedures.
 	- {{fbdoc item="keyword" value="KeyPgTan|TAN"}}
 	- {{fbdoc item="keyword" value="KeyPgThen|THEN"}}
 	- {{fbdoc item="keyword" value="KeyPgThis|THIS"}}
+	- {{fbdoc item="keyword" value="KeyPgThiscall|THISCALL"}}
 	- {{fbdoc item="keyword" value="KeyPgThreadCall|THREADCALL"}}
 	- {{fbdoc item="keyword" value="KeyPgThreadCreate|THREADCREATE"}}
 	- {{fbdoc item="keyword" value="KeyPgThreadDetach|THREADDETACH"}}

doc/manual/cache/CatPgFunctIndex.wakka

@@ -534,6 +534,7 @@ List of ""FreeBASIC"" keywords sorted by the function they perform.
 	- {{fbdoc item="keyword" value="KeyPgMemberSub|SUB (Member)"}}
 	- {{fbdoc item="keyword" value="KeyPgStdcall|STDCALL"}}
 	- {{fbdoc item="keyword" value="KeyPgThis|THIS"}}
+	- {{fbdoc item="keyword" value="KeyPgThiscall|THISCALL"}}
 	- {{fbdoc item="keyword" value="KeyPgVirtual|VIRTUAL (member)"}}
 
 {{fbdoc item="section" value="Variadic Procedures"}}

doc/manual/cache/CatPgProcedures.wakka

@@ -54,6 +54,8 @@ Keywords that work with procedures.
 		Specifies the standard calling convention in the C and C""++"" languages.
 	=={{fbdoc item="keyword" value="KeyPgPascal|Pascal"}}==
 		Specifies the standard calling convention in the Fortran, Pascal and Microsoft ""QuickBASIC""/QBasic languages.
+	=={{fbdoc item="keyword" value="KeyPgThicsall|Thiscall"}}==
+		Specifies the thiscall calling convention for 32-bit member procedures.
 <<>>{{anchor name="PARAMCONV"}}{{fbdoc item="section" value="Parameter passing conventions"}}
 	=={{fbdoc item="keyword" value="KeyPgByref|Byref"}}==
 		Specifies passing an argument by reference.

doc/manual/cache/KeyPgThicsall.wakka

@@ -0,0 +1,47 @@
+{{fbdoc item="title" value="__THISCALL"}}----
+Specifies the //Thiscall// calling convention in a member procedure declaration
+
+{{fbdoc item="syntax"}}##
+	[[KeyPgType|Type]] //typename//
+		declare [[KeyPgSub|Sub]] //name// **""__Thiscall""** [[[KeyPgOverload|Overload]]] [[[KeyPgAlias|Alias]] //"""alias"""//] ( //parameters// )
+		declare [[KeyPgFunction|Function]] //name// **""__Thiscall""** [[[KeyPgOverload|Overload]]] [[[KeyPgAlias|Alias]] //"""alias"""//] ( //parameters// ) [ [[KeyPgByrefFunction|Byref]] ] [[KeyPgAs|as]] //return_type//
+	End Type
+##
+{{fbdoc item="desc"}}
+	In member procedure declarations, ##**""__Thiscall""**## specifies that a procedure will use the ##**Thiscall**## calling convention. In the //Thiscall// calling convention, the implicit and hidden [[KeyThis|This]] parameter is passed in the ##ECX## register.
+	
+	The ##//Thiscall//## calling convention is for 32-bit x86 targets only and is only partially implemented.  It should work when using //-gen gcc// backend, but as of fbc-1.08.0, it is not implemented for the //-gen gas// backed.
+	
+	It is not needed for normal fbc usage, and would typically only be needed for linking to and using ""g++/c++"" libraries.
+
+{{fbdoc item="ex"}}
+{{fbdoc item="filename" value="examples/manual/procs/thicall.bas"}}%%(freebasic)
+'' __thiscall only makes sense on windows 32-bit
+#if defined(__FB_WIN32__) and not defined(__FB_64BIT__)
+	#define thiscall __thiscall
+#else
+	#define thiscall
+#endif
+
+extern "c++"
+type UDT
+	value as long
+	'' fbc doesn't automatically add the __thiscall calling convention
+	'' therefore, currently needs to be explicitly given where needed
+	declare constructor thiscall ()
+	declare destructor thiscall ()
+	declare sub someproc thiscall ()
+	'' etc
+end type
+end extern
+%%
+
+{{fbdoc item="diff"}}
+	- New to ""FreeBASIC""
+
+{{fbdoc item="see"}}
+	- ##[[KeyPgCdecl|Cdecl]]##, ##[[KeyPgStdcall|Stdcall]]##
+	- ##[[KeyPgDeclare|Declare]]##
+	- ##[[KeyPgSub|Sub]]##, ##[[KeyPgFunction|Function]]##
+
+{{fbdoc item="back" value="CatPgProcedures|Procedures"}}