You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/manual/cache/CompilerOpts.wakka
+3Lines changed: 3 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -10,11 +10,14 @@ Sets the executable subsystem
10
10
11
11
{{fbdoc item="desc"}}
12
12
The ##-s## compiler option specifies the executable subsystem. Allowed subsystems are ##gui## and ##console## (by default, ##console## is used). Specifying a ##gui## subsystem prevents the console window from appearing behind the program window.
13
+
14
+
The intrinsic macro ##[[KeyPgDdfbgui|__FB_GUI__]]## is set to non-zero (-1) if the option with ##gui## as subsystem was specified, and set to zero (0) otherwise.
Copy file name to clipboardExpand all lines: doc/manual/cache/KeyPgErase.wakka
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ Statement to erase arrays
15
15
Using ##**Erase**## on a fixed-length array resets all elements without freeing the allocated memory.
16
16
In case of objects, there is destruction then re-construction.
17
17
18
-
Using ##**Erase**## on a variable-length array (array already sized) frees the memory used by the element data (does not allow to after resize it with a different number of dimensions).
18
+
Using ##**Erase**## on a variable-length array (array already sized) frees the memory allocated for the array elements, but the array remains declared at its same scope level (with the same datatype and number of dimensions).
19
19
In case of objects, there is destruction before freeing memory.
Copy file name to clipboardExpand all lines: doc/manual/cache/KeyPgOpDeleteOverload.wakka
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ Member operator to overload memory deallocation process part provided by ##[[Key
15
15
16
16
##**Delete[] Overload**## operator is the array-version of ##**Delete Overload**## operator and overloads the memory deallocation process provided by the ##**Delete[] Statement**## operator when applying to a UDT (User Defined Type).
17
17
18
-
Memory freed with ##**Delete Overload**## operator must have be allocated with ##[[KeyPgOpNewOverload|New Overload]]## operator. Memory freed with ##**Delete[] Overload**## operator must have been allocated with ##**New[] Overload operator**##, the array-version of ##[[KeyPgOpNewOverload|New Overload]]## operator. You cannot mix and match the different versions of the operators.
18
+
Memory freed with ##**Delete Overload**## operator must have be allocated by also defining a ##[[KeyPgOpNewOverload|New Overload]]## operator. Memory freed with ##**Delete[] Overload**## operator must have been allocated by also defining a ##**New[] Overload operator**##, the array-version of ##[[KeyPgOpNewOverload|New Overload]]## operator. You cannot mix and match the different versions of the operators.
19
19
20
20
Member operators ##**Delete Overload**##, and ##**Delete[] Overload**## are always static, even if not explicitly declared (##[[KeyPgStaticMember|static]]## keyword is unnecessary but allowed). Thus, they do not have an implicit ##[[KeyPgThis|This]]## instance argument passed to them (because instance already been destroyed).
Copy file name to clipboardExpand all lines: doc/manual/cache/KeyPgOpNewOverload.wakka
+64-1Lines changed: 64 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -18,11 +18,74 @@ Member operator to overload dynamic memory allocation process part provided by #
18
18
19
19
##**New[] Overload**## operator is the array-version of the ##**New Overload**## operator and overloads the dynamic memory allocation process provided by the ##**New[] Expression**## operator when applying to a UDT (User Defined Type).
20
20
21
-
Memory allocated with ##**New Overload**## operator must be freed with ##[[KeyPgOpDeleteOverload|Delete Overload]]## operator. Memory allocated with ##**New[] Overload**## operator must be freed with ##**Delete[] Overload**## operator, the array-version of ##[[KeyPgOpDeleteOverload|Delete Overload]]## operator. You cannot mix and match the different versions of the operators.
21
+
Memory allocated with ##**New Overload**## operator must be freed by also defining a ##[[KeyPgOpDeleteOverload|Delete Overload]]## operator. Memory allocated with ##**New[] Overload**## operator must be freed by also defining a ##**Delete[] Overload**## operator, the array-version of ##[[KeyPgOpDeleteOverload|Delete Overload]]## operator. You cannot mix and match the different versions of the operators.
22
22
23
23
Member operators ##**New Overload**##, and ##**New[] Overload**## are always static, even if not explicitly declared (##[[KeyPgStaticMember|static]]## keyword is unnecessary but allowed). Thus, they do not have an implicit ##[[KeyPgThis|This]]## instance argument passed to them (because instance not yet been constructed).
24
24
25
25
{{fbdoc item="ex"}}
26
+
Dynamic allocation displayer for UDT, by using the member operators "New([]) Overload" and "Delete([]) Overload" (very simple example, only for syntax usage):
27
+
- displaying of memory allocations: addresses, sizes,
Declare Operator New (ByVal size As UInteger) As Any Ptr
37
+
Declare Operator Delete (ByVal buf As Any Ptr)
38
+
Declare Operator New[] (ByVal size As UInteger) As Any Ptr
39
+
Declare Operator Delete[] (ByVal buf As Any Ptr)
40
+
Private:
41
+
Declare Static Function allocation (Byref N As String, Byval size As Uinteger) As Any Ptr
42
+
Declare Static Sub deallocation (Byref D As String, Byval p As Any Ptr)
43
+
End Type
44
+
45
+
Operator UDTdisplayer.New (ByVal size As UInteger) As Any Ptr
46
+
Return UDTdisplayer.allocation("New", size)
47
+
End Operator
48
+
49
+
Operator UDTdisplayer.Delete (ByVal buf As Any Ptr)
50
+
UDTdisplayer.deallocation("Delete", buf)
51
+
End Operator
52
+
53
+
Operator UDTdisplayer.New[] (ByVal size As UInteger) As Any Ptr
54
+
Return UDTdisplayer.allocation("New[]", size)
55
+
End Operator
56
+
57
+
Operator UDTdisplayer.Delete[] (ByVal buf As Any Ptr)
58
+
UDTdisplayer.deallocation("Delete[]", buf)
59
+
End Operator
60
+
61
+
Function UDTdisplayer.allocation (Byref N As String, Byval size As Uinteger) As Any Ptr
62
+
Dim As Any Ptr p = Allocate(size)
63
+
Print "memory allocation for " & size & " bytes from '" & N & "' at address: " & p
64
+
Return p
65
+
End Function
66
+
67
+
Sub UDTdisplayer.deallocation (Byref D As String, Byval p As Any Ptr)
68
+
Print "memory deallocation from '" & D & "' at address " & p
69
+
Deallocate p
70
+
End Sub
71
+
72
+
73
+
Randomize
74
+
Dim As UDTdisplayer Ptr pu1 = New UDTdisplayer
75
+
Dim As UDTdisplayer Ptr pu2 = New UDTdisplayer[3]
76
+
Delete pu1
77
+
Delete[] pu2
78
+
79
+
Sleep
80
+
%%
81
+
82
+
Output example:
83
+
%%
84
+
memory allocation for 1048576 bytes from 'New' at address: 32677920
85
+
memory allocation for 3145728 bytes from 'New[]' at address: 33775648
86
+
memory deallocation from 'Delete' at address 32677920
87
+
memory deallocation from 'Delete[]' at address 33775648
88
+
%%
26
89
27
90
Aligned memory allocator:
28
91
- by using the member operators "New Overload" and "Delete Overload", any created User object is aligned to a multiple of "ALIGN" bytes (256 bytes in this example),
0 commit comments