File: lazutilities.xml

package info (click to toggle)
lazarus 2.2.6%2Bdfsg2-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 219,980 kB
  • sloc: pascal: 1,944,919; xml: 357,634; makefile: 270,608; cpp: 57,115; sh: 3,249; java: 609; perl: 297; sql: 222; ansic: 137
file content (226 lines) | stat: -rw-r--r-- 8,813 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
<?xml version="1.0" encoding="utf-8"?>
<fpdoc-descriptions>
  <package name="lazutils">
    <!--
    ====================================================================
      LazUtilities
    ====================================================================
    -->
    <module name="LazUtilities">
      <short>
        Contains miscellaneous utility routines and variables used in the Lazarus IDE and LCL.
      </short>
      <descr>
        <p>
          This file is part of the <file>LazUtils</file> package.
        </p>
      </descr>

      <!-- unresolved external references -->
      <element name="Classes"/>
      <element name="SysUtils"/>
      <element name="TypInfo"/>

      <element name="FreeThenNil">
        <short>Ensures that the specified object instance is freed and set to Nil.</short>
        <descr>
          <var>FreeThenNil</var> is a procedure used to ensure that the object instance in <var>obj</var> is freed and set to Nil. If obj has been assigned, it is cast to a <var>TObject</var> instance and its Free method is called. Finally, the pointer to the address in obj is set to Nil.
        </descr>
        <seealso/>
      </element>
      <element name="FreeThenNil.obj">
        <short>Object instance modified in the routine.</short>
      </element>

      <element name="ComparePointers">
        <short>Gets the relative order for the specified Pointers.</short>
        <descr>
          <p>
            <var>ComparePointers</var> is an <var>Integer</var> function used to get the relative order for the specified Pointer values. The following return values are used in the routine:
          </p>
          <dl>
            <dt>1</dt>
            <dd>Returned when p1 &gt; p2.</dd>
            <dt>0</dt>
            <dd>Returned when p1 = p2.</dd>
            <dt>-1</dt>
            <dd>Returned when p1 &lt; p2.</dd>
          </dl>
        </descr>
        <seealso/>
      </element>
      <element name="ComparePointers.Result">
        <short>Numeric value with the relative order for the compared Pointers.</short>
      </element>
      <element name="ComparePointers.p1">
        <short>Pointer compared in the routine.</short>
      </element>
      <element name="ComparePointers.p2">
        <short>Pointer compared in the routine.</short>
      </element>

      <element name="CompareBoolean">
        <short>Compares the specified Boolean values.</short>
        <descr>
          <dl>
            <dt>0</dt>
            <dd>Returned when b1 and b2 have the same value.</dd>
            <dt>1</dt>
            <dd>Returned when b1 is True.</dd>
            <dt>-1</dt>
            <dd>Returned as the default value (when b1 is False ).</dd>
          </dl>
        </descr>
        <seealso/>
      </element>
      <element name="CompareBoolean.Result">
        <short>Numeric value for the comparison.</short>
      </element>
      <element name="CompareBoolean.b1">
        <short>Boolean value compared in the routine.</short>
      </element>
      <element name="CompareBoolean.b2">
        <short>Boolean value compared in the routine.</short>
      </element>

      <element name="GetEnumValueDef">
        <short>Gets the ordinal position for an enumeration value with the specified name.</short>
        <descr>
          <p>
            <var>GetEnumValueDef</var> is an <var>Integer</var> function used to get the ordinal position in the specified enumeration type insformation for the value with the given name.
          </p>
          <p>
            The return value contains the ordinal position in <var>TypeInfo</var> for the enumeration value with the given <var>Name</var>. GetEnumValueDef calls <var>GetEnumValue</var> to find the value in Name in the type information. If the  return value is <b>-1</b>, an enumeration value with the specified name is not found in TypeInfo and the value in <var>DefaultValue</var> is used as the return value.
          </p>
        </descr>
        <seealso>
          <link id="#rtl.typinfo.GetEnumValue">GetEnumValue</link>
          <link id="#rtl.typinfo.PTypeInfo">PTypeInfo</link>
        </seealso>
      </element>
      <element name="GetEnumValueDef.Result">
        <short>Ordinal position for the enumeration value with the specified name.</short>
      </element>
      <element name="GetEnumValueDef.TypeInfo">
        <short>Pointer to the type information examined in the routine.</short>
      </element>
      <element name="GetEnumValueDef.Name">
        <short>Name for the enumeration value to locate in TypeInfo.</short>
      </element>
      <element name="GetEnumValueDef.DefaultValue">
        <short>Default ordinal position for the enumeration value used when Name is not found.</short>
      </element>

      <element name="RoundToInt">
        <short>Rounds the specified Extended value to an Integer value.</short>
        <descr>
          <p>
            Calls <var>Round</var> to round the <var>Extended</var> value, and casts the result to the <var>Integer</var> type used as the return value.
          </p>
        </descr>
        <seealso/>
      </element>
      <element name="RoundToInt.Result">
        <short>Integer value for the rounded numeric value.</short>
      </element>
      <element name="RoundToInt.e">
        <short>Extended type rounded and converted in the routine.</short>
      </element>

      <element name="RoundToCardinal">
        <short>Rounds the specified Extended value to a Cardinal value.</short>
        <descr>
          <p>
            Calls <var>Round</var> to round the <var>Extended</var> value, and casts the result to the <var>Cardinal</var> type used as the return value.
          </p>
        </descr>
        <seealso/>
      </element>
      <element name="RoundToCardinal.Result">
        <short>Cardinal value for the rounded numeric value.</short>
      </element>
      <element name="RoundToCardinal.e">
        <short>Extended type rounded and converted in the routine.</short>
      </element>

      <element name="TruncToInt">
        <short>Truncates the extended value and returns an Integer type.</short>
        <descr/>
        <seealso/>
      </element>
      <element name="TruncToInt.Result">
        <short>Integer type with the truncated value.</short>
      </element>
      <element name="TruncToInt.e">
        <short>Extended value truncated and converted in the routine.</short>
      </element>

      <element name="TruncToCardinal">
        <short>Truncates the extended value and returns a Cardinal type.</short>
        <descr/>
        <seealso/>
      </element>
      <element name="TruncToCardinal.Result">
        <short>Cardinal type with the truncated value.</short>
      </element>
      <element name="TruncToCardinal.e">
        <short>Extended value truncated and converted in the routine.</short>
      </element>

      <element name="StrToDouble">
        <short>Converts the specified string value to a Double type.</short>
        <descr>
          <p>
            Calls <var>StrToFloat</var> to convert the value in <var>s</var>, and casts the result to the <var>Double</var> data type used as the return value.
          </p>
        </descr>
        <seealso/>
      </element>
      <element name="StrToDouble.Result">
        <short>Double type with the converted value.</short>
      </element>
      <element name="StrToDouble.s">
        <short>String value converted in the routine.</short>
      </element>

      <element name="MergeSortWithLen">
        <short>
          Implements a merge sort algorithm for a list of pointers with the given length.
        </short>
        <descr></descr>
        <seealso></seealso>
      </element>
      <element name="MergeSortWithLen.List">
        <short></short>
      </element>
      <element name="MergeSortWithLen.ListLength">
        <short></short>
      </element>
      <element name="MergeSortWithLen.Compare">
        <short></short>
      </element>

      <element name="ConsoleVerbosity">
        <short>Level of detail displayed in IDE console output windows.</short>
        <descr>
          <p>
            <var>ConsoleVerbosity</var> is an Integer variable which indicates the level of detail output from tools like pas2js and CodeTools. ConsoleVerbosity enables debugger output for specific levels of detail.
          </p>
          <dl>
            <dt>-1</dt>
            <dd>Quiet</dd>
            <dt>0</dt>
            <dd>Normal verbosity (No debugger output)</dd>
            <dt>1</dt>
            <dd>Verbose (Debugger output enabled)</dd>
            <dt>2</dt>
            <dd>Very verbose (Debugger output enabled)</dd>
          </dl>
        </descr>
        <seealso/>
      </element>

    </module>
    <!-- LazUtilities -->
  </package>
</fpdoc-descriptions>