ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/trunk/fbintf/changelog
Revision: 359
Committed: Tue Dec 7 09:37:32 2021 UTC (6 months, 3 weeks ago) by tony
File size: 28906 byte(s)
Log Message:
Fixes Merged
Line File contents
1 FBINTF Change Log version (1.3-3 Build 12935) Mon, 06 Dec 2021 23:17:13 +0000
2
3 1. Fix compile error with fpc trunk (3.3.1 and later), due to type change to tzname in "unix" unit.
4
5 2. Remove constraint in IAttachment.HasScollableCursors that returned false when
6 using remote protocol. Scrollable cursors with remote database expected to
7 be support for Firebird 4.0.1 onwards. Note: Firebird 4.0.0 will return
8 a not supported error.
9
10 3. IStatement: new function;
11 TStatementFlag = (stHasCursor,stRepeatExecute,stScrollable);
12 TStatementFlags = set of TStatementFlag;
13 function GetFlags: TStatementFlags;
14
15 4. Revised behaviour for IStatement.ExecuteQuery in order to preserve backwards
16 compatibility.
17 In Firebird 5, Update..Returning may returns multiple rows and hence the statemen
18 type changes from ExecProcedure to Select. So that ExecuteQuery can continue
19 to be used with Update...Retruning statements that return a singleton row,
20 instead of raising an exception when ExecuteQuery is used with a (SELECT) statement,
21 it will open the cursor and return the first row only.
22
23 5. ITransaction: new functions:
24 function GetIsReadOnly: boolean;
25 function GetTransactionID: integer;
26 function GetTrInformation(Requests: array of byte): ITrInformation; overload;
27 function GetTrInformation(Request: byte): ITrInformation; overload;
28
29 The latter two return the Transaction Information block. The first two extract
30 information the Transaction Information block
31
32 6. New function TSQLTokeniser.ReadCharacters
33 Used internally.
34
35 7. IStatement: GetProcessedSQL bug fix. No longer raises and error if SQL contains
36 parameter placeholders instead of named parameters.
37
38 8. ITransaction (Firebird 3 and later): An exception raised when freeing an underlying
39 transaction handle is now ignored if Rollback/Commit is called with Force=true
40
41 FBINTF Change Log version (1.3-2 Build 12889) Sun, 24 Oct 2021 13:49:28 +0100
42
43 1. TFBClientAPI.GetProcAddr. Add check for nil reference.
44
45 2. IStatement: new methods:
46 procedure SetStaleReferenceChecks(Enable:boolean); {default true}
47 function GetStaleReferenceChecks: boolean;
48
49 In previous versions, stale reference checks were always enabled. This allows the
50 user to disable them on a per statement basis. Note this can risk out-of-date
51 statement BLR. See User Guide.
52
53 3. IBUtils: TSQLwithNamedParamsTokeniser now recognises a CASE...END block within a
54 stored procedure and hence avoids replacing named parameters within a containing
55 BEGIN..END block.
56
57 4. ISQLParam: using a string value to set an integer field with a scale factor of
58 zero is now treated as a special case to avoid the risk of floating point
59 rounding errors affecting pure integers.
60
61 5. ISQLParam: Review and tidy-up of SetAsString for numeric types.
62
63 6. ISQLParam is now subclassed from IParamMetaData, which provides access to the mutable
64 SQL Parameter metadata (methods moved from ISQLParam).
65
66 7. ISQLParam: new method
67 function getColMetadata: IParamMetaData;
68 This instance of IParamMetaData returns the original column metadata which is unmutable.
69 Note: ISQLParam metadata can change after a parameter value has been set e.g when
70 setting a VARCHAR column to an integer value.
71
72 8. IStatement: can now set cursor name when opening a cursor. New overloaded method:
73 procedure Prepare(CursorName: AnsiString; aTransaction: ITransaction=nil); overload;
74 also IAttachment:
75 function Prepare(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer; CursorName: AnsiString=''): IStatement; overload;
76 function Prepare(transaction: ITransaction; sql: AnsiString; CursorName: AnsiString=''): IStatement; overload;
77 function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
78 aSQLDialect: integer; GenerateParamNames: boolean=false;
79 CaseSensitiveParams: boolean = false; CursorName: AnsiString=''): IStatement; overload;
80 function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
81 GenerateParamNames: boolean=false;
82 CaseSensitiveParams: boolean = false; CursorName: AnsiString=''): IStatement; overload;
83
84 9. Support for scrollable cursors added. New/updated methods:
85 IAttachment:
86 function HasScollableCursors: boolean;
87 function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
88 Scrollable: boolean=false): IResultSet; overload;
89 function OpenCursor(transaction: ITransaction; sql: AnsiString; Scrollable: boolean=false): IResultSet; overload;
90 function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer; Scrollable: boolean;
91 params: array of const): IResultSet; overload;
92 function OpenCursor(transaction: ITransaction; sql: AnsiString; Scrollable: boolean=false;
93 params: array of const): IResultSet; overload;
94 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer; Scrollable: boolean;
95 params: array of const): IResultSet; overload;
96 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
97 Scrollable: boolean=false): IResultSet; overload;
98 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; Scrollable: boolean=false): IResultSet; overload;
99 function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; Scrollable: boolean;
100 params: array of const): IResultSet; overload;
101 function OpenCursorAtStart(sql: AnsiString; Scrollable: boolean=false): IResultSet; overload;
102 function OpenCursorAtStart(sql: AnsiString; Scrollable: boolean;
103 params: array of const): IResultSet; overload;
104 IStatement:
105 function OpenCursor(Scrollable: boolean; CursorName: AnsiString =''; aTransaction: ITransaction=nil): IResultSet; overload;
106 IResultSet:
107 function FetchPrior: boolean; {fetch previous record}
108 function FetchFirst:boolean; {fetch first record}
109 function FetchLast: boolean; {fetch last record}
110 function FetchAbsolute(position: Integer): boolean; {fetch record by its absolute position in result set}
111 function FetchRelative(offset: Integer): boolean; {fetch record by position relative to current}
112 function IsBof: boolean;
113
114 10. IArray: tidyup of SetAsString method to ensure correct handling of fixed point numbers.
115
116 11. IBUtils: TSQLTokeniser. CRLF now combined by low level parser into sqltEOL token. This
117 may be noticeable when a line separator occurs inside quoted text. The quoted text
118 output by the tokeniser will now use the platform specific lineEnding regardless
119 of whether the input uses the CRLF or LF as a line separator.
120
121 12. IStatement, IResultsSet: Support for scrollable cursors added (note: local databases only)
122
123
124 FBINTF Change Log version (1.3-1 Build 12776) Mon, 23 Aug 2021 11:09:33 +0100
125
126 1. Integer decodes in information blocks (e.g. IDBInfoItem) widened from 32 bit to 64-bit integers.
127
128 2. Support for inline blob encoding. Blob values pass using the "SetAsString" method
129 will now be encoded inline (i.e. as part of the parameter buffer) if they are
130 shorter than a pre-set limit. Longer values continue to be saved as blobs as a
131 separate server interaction. This is intended as a performance optimisation.
132
133 The pre-set limit defaults to 8192 bytes and can be inspected/modified using the new
134 IAttachment interface functions:
135
136 function GetInlineBlobLimit: integer;
137 procedure SetInlineBlobLimit(limit: integer);
138
139 3. Support for Firebird 4 IBatch interface added. This is largely transparent to the API
140 user as the functionality is embedded in the implementation of the IStatement
141 interface. Three new functions are defined:
142
143 procedure AddToBatch;
144 function ExecuteBatch(aTransaction: ITransaction=nil): IBatchCompletion;
145 procedure CancelBatch;
146 function GetBatchCompletion: IBatchCompletion;
147 function GetBatchRowLimit: integer;
148 procedure SetBatchRowLimit(aLimit: integer);
149
150 Also
151
152 function IsInBatchMode: boolean; {true after call to execute(eaDefer)}
153 function HasBatchMode: boolean; {true if and only if IBatch Supported}
154
155 For more information see the User Guide.
156
157 4. Default error message contents. Now aligned with User Guide section 10.2 i.e. error messages
158 provided with the EIBInterBaseError now include all three parts.
159
160 5. Firebird.pas and include files updated to Firebird 4.0.0
161
162 6. New IStatement method: function GetSQLStatementTypeName: AnsiString;
163 Returns SQL Statement type as a text string;
164
165 7. ISQLData.AsInteger and AsInt64 now use "Round" to convert a float field to
166 an integer instead of "trunc". This is for compatibility with TFloatField.AsInteger.
167
168 FBINTF Change Log version (1.2-1 Build 12552) Wed, 09 Jun 2021 13:05:40 +0100
169
170 1. Big fix for Firebird 4.0. A internal change in Firebird 4.0.0 from RC1 flushed out a
171 typo in FB30Statement.pas that caused an unknown parameter error.
172
173 FBINTF Change Log version (1.2-0 Build 12520) Fri, 19 Feb 2021 13:27:23 +0000
174
175 1. Imported (Firebird) constants updated for Firebird 4.
176
177 2. Firebird.pas from Firebird 4 integrated into source code tree.
178
179 3. Added Support for TIMETAMP WITH TIME ZONE and TIME WITH TIME ZONE data types.
180
181 4. Added Support for SQL_DEC16, SQL_DEC34 and extended NUMERIC precision.
182
183 5. New unit 'FBClientLib.pas' added and provides new interface IFBIMasterProvider.
184 QueryInterface may be used to coerce this interface from IFirebirdAPI. The
185 interface provides a single method "function GetIMasterIntf: IMaster". This provides
186 type safe access to the Firebird IMaster interface and avoids the need to turn
187 off object checks when coercing "function GetIMaster: TObject" to IMaster.
188
189 6. New IFirebirdAPI Calls:
190 function HasLocalTZDB: boolean;
191 function HasTimeZoneSupport: boolean;
192 function HasExtendedTZSupport: boolean;
193 procedure SQLDecFloatEncode(aValue: tBCD; SQLType: cardinal; bufptr: PByte);
194 function SQLDecFloatDecode(SQLType: cardinal; scale: integer; bufptr: PByte): tBCD;
195
196 7. New IAttachment Calls:
197 function HasDecFloatSupport: boolean;
198 function GetTimeZoneServices: ITimeZoneServices;
199 function HasTimeZoneSupport: boolean;
200
201 8. New Interface ITimeZoneServices.
202
203 9. New ISQLData API Calls:
204 procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID); overload;
205 procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString); overload;
206 procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID; OnDate: TDateTime); overload;
207 procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString; OnDate: TDateTime); overload;
208 function GetAsUTCDateTime: TDateTime;
209 function GetAsBCD: tBCD;
210
211 10. New ISQLParam API Calls
212 procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID); overload;
213 procedure GetAsDateTime(var aDateTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString); overload;
214 procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID; OnDate: TDateTime); overload;
215 procedure GetAsTime(var aTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString; OnDate: TDateTime); overload;
216 function GetAsUTCDateTime: TDateTime;
217 function GetAsBCD: tBCD;
218 function GetStatement: IStatement;
219 function GetTransaction: ITransaction;
220 procedure SetAsTime(aValue: TDateTime; OnDate: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
221 procedure SetAsTime(aValue: TDateTime; OnDate: TDateTime; aTimeZone: AnsiString); overload;
222 procedure SetAsDateTime(aValue: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
223 procedure SetAsDateTime(aValue: TDateTime; aTimeZone: AnsiString); overload;
224 procedure SetAsUTCDateTime(aUTCTime: TDateTime);
225 procedure SetAsBcd(aValue: tBCD);
226
227 11. New IArray API Calls
228 procedure GetAsDateTime(index: array of integer; var aDateTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID); overload;
229 procedure GetAsDateTime(index: array of integer; var aDateTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString); overload;
230 procedure GetAsTime(index: array of integer; var aTime: TDateTime; var dstOffset: smallint; var aTimezoneID: TFBTimeZoneID; OnDate: TDateTime); overload;
231 procedure GetAsTime(index: array of integer; var aTime: TDateTime; var dstOffset: smallint; var aTimezone: AnsiString; OnDate: TDateTime); overload;
232 function GetAsUTCDateTime(index: array of integer): TDateTime;
233 procedure SetAsDateTime(index: array of integer; aValue: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
234 procedure SetAsDateTime(index: array of integer; aValue: TDateTime; aTimeZone: AnsiString); overload;
235 procedure SetAsTime(index: array of integer; aValue: TDateTime; OnDate: TDateTime; aTimeZoneID: TFBTimeZoneID); overload;
236 procedure SetAsTime(index: array of integer; aValue: TDateTime; OnDate: TDateTime; aTimeZone: AnsiString); overload;
237
238 12. Utility functions in IBUtils
239 function ParseDateTimeTZString(aDateTimeStr: Ansistring; var aDateTime: TDateTime;
240 var aTimezone: AnsiString; aFormatSettings: TFormatSettings; TimeOnly: boolean=false): boolean;
241 procedure FBDecodeTime(aTime: TDateTime; var Hour, Minute, Second: word; var DeciMillisecond: cardinal);
242 function FBEncodeTime(Hour, Minute, Second, DeciMillisecond: cardinal): TDateTime;
243 function FBFormatDateTime(fmt: AnsiString; aDateTime: TDateTime): AnsiString;
244 function FormatTimeZoneOffset(EffectiveTimeOffsetMins: integer): AnsiString;
245 function DecodeTimeZoneOffset(TZOffset: AnsiString; var dstOffset: integer): boolean;
246
247 13. IDPB, ITPB and ISPB: new interface method
248 function AddByTypeName(ParamTypeName: AnsiString): IDPBItem/ITPBItem/ISPBItem;
249 This is used to add a parameter block item by the string equivalent of its
250 symbolic type name. e.g. DPB.AddByTypeName('isc_dpb_user_name').AsString := '...'
251
252 14. IDPBItem/ITPBItem/ISPBItem: new interface method:
253 function getParamTypeName: AnsiString;
254
255 15. fb_shutdown now called before unloading Firebird library. This can avoid a
256 SIGEVENT error when a programme using the embeded server is unloaded.
257
258 FBINTF Change Log version (1.1-6 Build 12237) Tue, 21 Jul 2020 08:54:21 +0100
259
260 1. GetImplementationVersion now correctly returns '3.0' for Firebird 3 API
261 with a Firebrid 3 client library.
262
263 2. Linux Only: FIREBIRD environment variable is now checked when loading the client library.
264 If a client library path is not explicitly provided and the FIREBIRD environment
265 variable is set then the directory given by this variable and any 'lib' subdirectory
266 are searched for the Firebird client library. Only if none is found, is the default
267 client library used.
268
269 3. IUtil.FormatStatus now used to format error messages when using new API
270
271 4. Fixed Array SDL: array_desc_scale now correctly encoded as a signed integer.
272
273 5. SQL_TEXT handling changed. When the value of an SQL_TEXT (i.e. fixed width string) column is
274 returned using GetAsString and the string codepage is UTF8, the string is truncated so
275 that the byte length corresponds to the number of characters specified for the column.
276 SQL_TEXT strings are no longer automatically trimmed to remove all trailing white space. This is
277 correct behaviour but may affect some implementations that relied upon automatic
278 trimming of trailing white space.
279
280 6. New IFirebirdAPI Calls:
281 function GetClientMajor: integer;
282 function GetClientMinor: integer;
283
284 7. IColumnMetaData and IArrayMetaData: new method
285 function GetCharSetWidth: integer;
286
287 FBINTF Change Log version (1.1-5 Build 12022) Fri, 17 Apr 2020 10:35:55 +0100
288
289 1. ISQLParams.GetHasCaseSensitiveParams added. Returns true if param names are
290 case sensitive
291
292 2. Single line SQL comments starting with '--' are now recognised by SQL Parser.
293
294 3. New API Calls:
295 IColumnMetaData.GetStatement
296 IColumnMetaData.GetTransaction
297 ISQLData.GetStrDataLength
298 IResults.GetStatement
299 IAttachment.OpenBlob (using Blob metadata)
300 IAttachment.OpenArray (using array metadata)
301
302 4. FBMessages: removal of unused messages
303
304 5. TFBArray.Create (2nd case): ensure that FFirebirdClientAPI is correctly set.
305
306 6. TIBSQLStatementType: SQLSavePoint added to end of enumeration.
307
308 FBINTF Change Log version (1.1-4 Build 11515) Fri, 28 Dec 2018 10:04:19 +0000
309
310 1. Fix a problem with the SQL parameter parser that failed to recognise parameters
311 where the second character of the parameter name is a numeric.
312
313 2. New method for IAttachment: procedure getFBVersion(version: TStrings);
314 This returns the isc_version connection information as one or more lines.
315 This is the same information as returned by isql with the -z option.
316
317 3. If -dFIREBIRD3APIONLY is used as a compiler option then the legacy Firebird API
318 is no longer compiled in. Likewise, if -dLEGACYFIREBIRDAPIONLY is used as a
319 compiler option then the Firebird 3 API is no longer compiled in.
320
321 4. IColumnMetaData: new method.
322
323 TIBDateTimeFormats = (dfTimestamp, {SQL TIMESTAMP}
324 dfDateTime, {SQL DATETIME}
325 dfTime);
326
327 function GetDateTimeStrLength(DateTimeFormat: TIBDateTimeFormats): integer;
328
329 This returns the max. number of characters returned by the "AsString" method
330 when the SQL type of the column is respectively TIMESTAMP, DATETIME or TIME.
331
332 5. Additional argument for IAttachment.PrepareWithNamedParameters -
333 CaseSensitiveParams: boolean = false
334
335 If this argument is set to true then SQL parameter names are assumed to be case
336 sensitive and must be referenced (using ISQLParams.ByName) using the case
337 sensitive name.
338
339 6. Bug fix: when setting a query parameter, it is now possible, when the parameter
340 is of type VarChar or Char to set the parameter to a numeric value (e.g. using
341 .AsCurrency) and then subsequently to update the value to a non-numeric string
342 using .AsString.
343
344
345
346 FBINTF Change Log version (1.1-3) Wed, 05 Dec 2018 14:28:10 +0000
347
348 1. DARWIN only syntax error: fix missing semi-colon in TFBClientAPI.LoadIBLibrary
349
350 2. Restrict IsMultiThread check to Unix only for compatibility with
351 https://bugs.freepascal.org/view.php?id=30535
352
353 3. New SQL Tokeniser added to IBUtils. This is used to pre-process SQL with
354 named parameters and is intended to avoid problems with (e.g.) Execute Block
355 and processing internal parameters as statement parameters.
356
357 4. New interface IFirebirdLibrary provides access to the underlying firebird DLL
358 or shared object. Available via a new member (GetFBLibrary) of IFirebirdAPI.
359
360 5. New function added to IB.pas
361
362 function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary
363
364 This allows a Firebird Library to be loaded from an explicit path. use the
365 IFirebirdLibrary.GetFirebirdAPI member function to get the Firebird API using
366 the library. It is possible to load Firebird libraries from different locations
367 simultaneously, each with a distinct IFirebirdAPI.
368
369 FBINTF Change Log version (1.1-2) Mon, 16 Apr 2018 09:30:32 +0100
370
371 1. Firebird.pas: {$OBJECTCHECKS OFF} added to file to avoid runtime error when
372 program compiled with -CR command line switch.
373
374 2. IServiceManager additions (informational):
375 function getProtocol: TProtocol;
376 function getPortNo: AnsiString;
377
378 3. IServiceManager improved error handling. Interfaces changed:
379 function Start(Request: ISRB; RaiseExceptionOnError: boolean=true): boolean;
380 function Query(SQPB: ISQPB; Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
381 function Query(Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
382
383 4. IAttachment addition (informational)
384 function GetSecurityDatabase: AnsiString;
385
386 5. IStatement: performance counters now updated after each Fetch. GetPerfStatistics
387 thus now returns accumulated stats for a select statement from opening a cursor
388 up to the last fetch.
389
390 6. DARWIN: uloadlibrary.inc bug fix. Many thanks to Luigi Naimi for correcting
391 the problem.
392
393 7. Type change: "TPerfCounters = array[TPerfStats] of Int64". Note "Int64"
394 replaces deprecated "comp" type.
395
396 10. Testsuite Test10 updated to include thread synchronisation for event reporting.
397
398 11. URL Connection Strings: inet4 and inet6 now recognised.
399
400 12. IBUtils: Parse and Make Connect String now recognise URL style loopback syntax.
401
402 13. IAttachment.CharSetName2CharSetID is now performed case insensitive.
403
404
405 FBINTF Change Log version (1.1-1) Tue, 27 Feb 2018 16:51:16 +0000
406
407 1. IBUtils.QuoteIdentifierIfNeeded: Add check for space character.
408
409 2. IAttachment: add two new methods
410 function HasDefaultCharSet: boolean;
411 function GetDefaultCharSetID: integer;
412
413 These return, respectively, true if a connection default character set was
414 specified and the character set id of the connection default character set.
415 The DefaultCharSetID is cached when the connection is opened and hence does not
416 require a database lookup.
417
418 3. Avoid exception when a text blob is a stored procedure parameter.
419
420 4. Update test suite to include a test for a stored proc returning a text blob.
421
422 5. IAttachment: add
423 function GetRemoteProtocol: AnsiString;
424 function GetODSMajorVersion: integer;
425 function GetODSMinorVersion: integer;
426 function GetAuthenticationMethod: AnsiString;
427
428 These results are cached when the connection is opened and hence do not
429 require a database lookup.
430
431 6. IAttachment: add "function GetConnectString: AnsiString;" This returns the
432 connect string used to create/connect to the database.
433
434 7. IAttachment: Create Database using SQL statement. The username and password
435 are now extracted and used to populate a DPB made available via IAttachment.getDPB.
436 It is now possible to use IAttachment disconnect/connect to reconnect to
437 a database for which the initial connection was established by a create
438 database sql statement. Available in FPC only.
439
440 8. Update Test 1 to test 5, 6 and 7 above.
441
442 9. IBUtils code tidy up.
443
444 10. Parameter Block interfaces "find" method. As documented, this should have
445 returned a nil interface when the item could not be found. Instead, an empty
446 interface item was returned. "Find" now works as documented and will return
447 a nil interface if the item cannot be found.
448
449 11. DBInformation: support added for isc_info_active_tran_count and isc_info_creation_date.
450
451 12. DBInformation: New interfaces: IDIRB and IDIRBItem added to support DB Information
452 requests with additional parameters. This is to enable support for fb_info_page_contents
453 (return of page contents). Response to fb_info_page_contents returned as
454 a string with code page CP_NONE.
455
456 13. DBInformation: Support for fb_info_pages_used and fb_info_pages_free added, plus
457 test suite updated.
458
459 14. DBInformation: Support for fb_info_crypt_key (Firebird 3.0.3 onwards) added as
460 a string type, and fb_info_conn_flags (Firebird 3.0.3 onwards) added as an integer type.
461
462 15. Service Manager: List of protocols supported expanded to include inet, wnet and xnet.
463 An overloaded version of IIFirebirdAPI.GetServiceManager also allows a non
464 default connection port to be specified.
465
466 FBINTF Change Log version (1.1-0) Sun, 07 Jan 2018 15:20:02 +0000
467
468 1. Fix issues with setting SQL Param values using SetAsString with Numeric types.
469 Scale is no longer ignored.
470
471 2. Fix issues with setting SQL Param values using SetAsString with Date values
472 not in locale format but which are recognised by Firebird. Date values that
473 cannot be converted to a string using Pascal library are now passed through
474 to Firebird as Text Strings.
475
476 3. Lookup character set name by codepage amended to ensure that CP_UTF8 returns
477 UTF8 and not UNICODE_FSS.
478
479 4. Charset ID problem. When using Firebird 3, with no default database character set
480 and a column has a non-default collation specified, an incorrect character set
481 id was being reported that could result in a 'division by zero' error when
482 used by IBX. This has now been fixed.
483
484 5. Move GetCharsetName, CharSetID2CodePage, CodePage2CharSetID, CharSetName2CharSetID,
485 CharSetWidth from IFirebirdAPI to IAttachment. This is a better data model as
486 the character sets supported can be updated on a per database basis. That is
487 it is possible to add a (Firebird) user defined character set to a database.
488
489 6. Add RegisterCharSet to IAttachment. This is used to register a user defined character
490 set supported by Firebird with the API.
491
492 7. Add missing isc_info_db_read_only to list of decoded Database Information items
493 in FBOutputBlock.pas and update test suite to include this item.
494
495 8. FB30Client: avoid always using "StartMultiple" when only a single database attachment.
496
497 9. Loading Windows fbclient.dll: when using the FIREBIRD variable to locate the client
498 library or finding it by disk location, the PATH environment variable is now also set to
499 include the FIREBIRD directory. This is to ensure that the correct dlls in the
500 firebird client library dependencies are loaded.
501
502 10. Testsuite: Ensure consistent UTF-8 output on Windows console.
503
504 11. Testsuite: Update Windows script to include FPC 3.0.4 in search path.
505
506 12. FB30Statement: Protect call to "Move" and avoid calling with a nil pointer
507
508 13. FB30Statement: A check has been added to ensure that all SQL Parameters
509 have been given a value (including NULL). Previously, failing to set the
510 value of an SQL Parameter could give rise to unpredictable results or
511 an SQLDA error.
512
513 14. FB30Statement/FB25Statement: Set SQLParam "modified" when string value set.
514
515 15. FBAttachment: Avoid string reference count error when processing an Ansistring
516 parameter in an array of const passed to IAttachment.OpenCursor, etc.
517
518 16. FBAttachment: Allow for WideString and UnicodeString parameters in an array
519 of const passed to IAttachment.OpenCursor, etc.
520
521
522 FBINTF Change Log version (1.0-2) Sat, 04 Mar 2017 14:43:56 +0000
523
524 1. Change syntax to Mode Delphi
525
526 2. Change all uses of string type to explicit AnsiString in order to ensure
527 compatibility between Delphi and FPC.
528
529 3. Various syntax changes to ensure Delphi and FPC compilation including GUIDs
530 defined for each interface.
531
532 4. Generics syntax variations for Delphi added
533
534 5. PChar replaced with PByte expect where an actual string is being referenced,
535 where PAnsiChar is used instead.
536
537 6. Review of type definitions in IBExternals to ensure Delphi compatibility
538
539 7. Testsuite updated for Delphi
540
541 FBINTF Change Log version (1.0-1) Fri, 24 Feb 2017 12:17:57 +0000
542
543 1. Limit maximum Blob segment read/write to MaxuShort. Avoids data loss with
544 large blobs and the FB3 API.
545
546 2. Update Event Handling algorithm to avoid looping due to recreation of the
547 event block.
548
549 3. Avoid invalid XSQLDA error when the only parameter is updated to null
550
551 4. Array Handling: fix problem with text arrays with character set none. When the
552 DB connection has a default character set (e.g. UTF8), an error is raised by
553 Firebird if the space allocated is not enough to allow for transliteration, even
554 though it is not required for character set none.
555
556 5. IBUtils: List of reserved words brought up-to-date
557
558 6. Add ISQL style performance statistics collection to IStatement
559
560 7. Add IFirebirdAPI.CreateDatabase variant to allow execution of user provided
561 CREATE DATABASE statement.
562
563 8. Update SQL Statement parsing to allow for Array Dimensions. That is so that the ':' in
564 an array dimension is not mistaken for a named parameter prefix.
565
566 9. Trim function no longer applied to result of GetAsString for SQL_TEXT
567 when Character set is octets. Avoids loss of non printable characters at start of string.
568
569 10. Add function GetPerfStatistics to IStatement. This returns ISQL like performance
570 statistics for the last action. Requires use of procedure IStatement.EnableStatistics
571 to enable stats gathering.
572
573 11. API Version information added as constants to IB.pas
574
575 12. BlobMetaData character set id should now be the same as that given by IColumnMetaData.GetCharSetID
576
577 13. Firebird Character set "NONE" now interpreted as codepage CP_ACP.
578
579 FBINTF Change Log version (1.0-0) Tue, 06 Dec 2016 10:33:47 +0000
580
581 1. Initial Release
582