Qore Programming Language Reference Manual 2.2.1
Loading...
Searching...
No Matches
Release Notes

Qore 2.2.1

Release Summary
Minor bugfix release including compatibility with GCC 16; see below for more information

Bug Fixes in Qore

  • DataProvider module
    • fixed the bulk record interface to allow implementations to return NOTHING or an empty hash at the end of iteration
    • added the missing field and all entries to the expression role code map
  • GmailDataProvider module
    • allow message event objects to be created when optional email headers are missing
  • MewsRestDataProvider module
    • use an absolute 90-day default query interval to ensure that DST transitions cannot produce requests longer than the Mews API limit
  • RestClient module
    • fixed parsing URL-encoded OAuth2 token responses and Content-Type parameters in non-blocking pings (issue 4993)
  • SqlUtil module
    • fixed PostgreSQL table discovery and description support for partitioned tables
  • WebSocketHandler module
    • removed a debug logging call from the message send path that could cause an infinite loop
  • fixed a crash when destroying uninitialized thread-local storage on Alpine Linux
  • fixed an infinite loop with a memory leak caused by a missing break statement in internal Socket SSL error-handling code (issue 4994)
  • fixed a scanner macro collision that prevented Qore from being compiled with GCC 16 (issue 5391)

Qore 2.2.0

Release Summary
Minor new features and minor bugfixes; see below for more information

New Features in Qore

Bug Fixes in Qore

Fixes That Can Affect Backwards-Compatibility

  • DataProvider module
    • the AbstractDataProviderType::getAcceptTypeHash(*bool) and AbstractDataProviderType::getReturnTypeHash(*bool) abstract methods now take an optional argument; classes inheriting this class and reimplementing these methods must add the argument and the logic to respect it
  • fixed the list range operator to no longer return NOTHING values for out of range elements
  • Subtracting NOTHING from any value will result in the same value; previously this would result in NOTHING

Bug Fixes in Qore

  • BulkSqlUtil module
    • fixed a bug executing bulk upsert operations with constant data (issue 4902)
  • ConnectionProvider module
    • fixed a bug where the I/O thread could stall and no longer ping any connection (issue 4896)
    • fixed a bug where control characters in URLs were silently accepted (issue 4866)
  • HttpServer module
    • fixed a deadlock due to lock starvation in the HttpServer regarding reloading HTTP certificate info (issue 4887)
    • fixed a bug where the HTTP server did not disconnect idle connections (issue 4878)
  • OracleSqlUtil module
  • SqlUtil module
    • eliminated locking from DML operations (issue 4886)
    • fixed a bug where SqlUtil::AbstractTable::getDropAllConstraintsAndIndexesOnColumnSql() did not work on foreign constraints (issue 4875)
  • Swagger module
    • fixed validating Swagger schemas with objects that declare no properties (issue 4906)
    • fixed JSON and YAML parsing from HTTP messages without charset=utf-8 in the headers (issue 4895)
    • fixed a bug converting arguments to fit the Swagger schema to avoid spurious and very difficult to debug type errors (issue 4825)
    • fixed a bug where any additionalProperties would cause all properties to be accepted (issue 4823)
  • fixed a bug where Qore could crash due to excess usage of pthread thread-local keys (issue 4927)
  • fixed a bug where copy methods were passed the new object as an argument instead of the old object
  • fixed a bug where a RUNTIME-TYPE-ERROR exception could be raised with valid calls at runtime (issue 4920)
  • fixed a bug calculating relative date/time values against absolute dates on macOS (issue 4919)
  • fixed a bug where control characters were not percent-encoded by encode_url() (issue 4917)
  • fixed a crash in Qore::pow(number, number) when y was 0n (issue 4916)
  • improved the weak assignment operator to allow weak references to hashes and list containers (issue 4909)
  • fixed a bug in deterministic garbage collection with class copy() methods (issue 4905)
  • fixed a bug where Qore would raise recusive constant exceptions when parsing in cases where values were not in a reference loop (issue 4903)
  • fixed a bug resolving static class variables that could cause spurious errors (issue 4894)
  • allow the persistent flag to be cleared without disconnecting in the HTTPClient class (issue 4882)
  • reconnect HTTP client objects if already connected and a send/receive operation immediately gets disconnected (issue 4879)
  • fixed a bug with the -= operator and lvalues with *hash types (issue 4873)
  • fixed a bug where outputting complex data structures with deleted objects would cause spurious exceptions (issue 4862)
  • fixed a bug where sockets could be prematurely closed due to I/O timeouts in some cases (issue 4858)
  • fixed a bug with the cast<>() operator and compatible typed hashes (issue 4840)
  • fixed a bug where a hash subtracted by NOTHING resulted in NOTHING instead of the same hash (issue 4834)

Qore 1.19.2

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • ConnectionProvider module
    • added the encode_chars HTTP / REST connection option (issue 4869)
    • fixed a deadlock issue with connection updates in code using this module (issue 4860)
    • do not change the connection status based on whether or not a connection can be made (issue 4852)
    • allow connections to be added, updated, and removed while already holding the connection lock (issue 4849)
  • CsvUtil module
    • fixed the CSV writer to automatically detect headers (issue 4838)
  • DataProvider module
    • fixed conversion of soft binary, bool, float, int, and number "or nothing" types from an empty string to NOTHING (issue 4836)
  • Logger
    • Fixed a bug where file rotate could result in logging exceptions; removed explicit atomic lock operations and implemented low-level atomic file handling instead (issue 4842)
  • Mapper
    • fixed a bug handling default values for output fields with required (not-null) types (issue 4847)
    • fixed a bug handling the trunc option in mappers when bulk processing (issue 4845)
  • RestClient
    • fixed a bug where the OAUth2 refresh token was sometimes dropped when an access token was acquired (issue 4821)
    • fixed a bug returning the token URL (issue 4809)
  • SalesforceRestClient
    • fixed a bug where the REST headers were not set up to accept JSON responses when the REST client was used with a token, this also caused breakage in the SalesforceRestDataProvider module (issue 4813)
  • SqlUtil module
    • set the column size in the type when creating types for VARCHAR columns (issue 4832)
  • Swagger module
    • fixed support of nullable object properties (issue 4854)
  • fixed bugs handling base64-URL-encoded strings (issue 4871)
  • fixed a bug where Qore would crash if an on_error statement referred to the active exception when erroneously called after a thread_exit statement (issue 4864)
  • fixed a bug where the HTTP connection path would be silently overwritten when processing redirects (issue 4841)
  • fixed a bug setting the local time zone on macOS Sonoma (issue 4818)
  • fixed a bug where Qore could characters with the incorrect character encoding to strings while processing HTTP headers in HTTP calls (issue 4810)

Qore 1.19.1

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • HttpServer
    • allow context info to be cleared after handling each request to ensure that context info (like thread-local data) does not leak into other connections on the same thread (issue 4802)
  • RestClient
    • do not try to get another OAuth2 token if the token was just retrieved (issue 4796)
  • fixed a bug where user variants would not always set the varargs flags from ellipses (issue 4804)
  • fixed an extraneous SOCKET-NOT-OPEN exception when running socket callbacks after a socket was closed (issue 4795)

Qore 1.19.0

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

Bug Fixes in Qore

  • ConnectionProvider module
    • assume connections are up until they are proven to be down (issue 4789)
    • fixed a bug where the ConnectionProvider::InvalidConnection class would report an invalid url hash (issue 4785)
  • RestClient module
    • implemented consistent support for OAuth2 authorization flows including for OAuth2 with non-blocking I/O and non-blocking retrieval of Swagger schemas for REST clients (issue 4766)
    • fixed a bug where polling pings did not respect connection options or the validator (issue 4764)
  • fixed a bugs handling the signal mask that could cause hard-to-debug problems such as deadlocks in JIT in the JVM on macOS aarch64 (issue 4793)
  • fixed a bug handling non-blocking I/O for socket connections on Darwin / macOS (issue 4791)
  • fixed a bug where function and method variants did not report varargs in the signature (issue 4787)
  • fixed a bug where an access exception could be raised when a reference to a private member was used in a static class method (issue 4778)
  • fixed a bug where the stack guard was not properly enforced when the JVM assumed enforcement responsibility; in addition, due to the fact that thread stacks are allocated from overcommitted memory, reducing the thread stack size to 512KB had no effect on the memory size of Qore programs but did affect Qore, Java, and Python programs, therefore the stack limit for all threads was reset to 8MB as of this release (issue 4768)

Qore 1.18.1

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

Qore 1.18.0

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

Bug Fixes in Qore

  • ConnectionProvider module
    • fixed a bug where the HttpConnection scheme could not be used (issue 4753)
    • fixed a bug where invalid connection options were silently accepted (issue 4751)
  • fixed date subtraction when the RHS is 1970-01-01Z (issue 4747)
  • set the default connect timeout for HTTP connections to 60 seconds (issue 4743)

Qore 1.17.0

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

Bug Fixes in Qore

  • DataProvider module
    • added missing base64binary and hexbinary type support (issue 4732)
  • Swagger module
    • ensure that URI paths are created without duplicated slashes by handling the base path consistently (issue 4728)
  • fixed a bug where TIDs would be reassigned immediately to other threads once all TIDs in the thread list had been assigned; now TIDs are assigned in a cyclic order based on which TIDs are free in all cases (issue 4735)
  • fixed a bug where it was not possible to declare methods as accepting varargs with ellipses; this caused problems with importing abstract Qore methods into Java, for example (issue 4738)

Qore 1.16.1

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

Qore 1.16.0

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

  • ConnectionProvider module
    • added a transaction capability flag for data providers to the connection info hash (issue 4722)
  • WebSocketClient module
    • new API data provider child to allow WebSocket messages to be received from a WebSocketClient data provider (issue 4716)

Bug Fixes in Qore

Qore 1.15

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

Bug Fixes in Qore

Qore 1.14.2

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

Qore 1.14.1

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

Qore 1.14

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

Bug Fixes in Qore

Qore 1.13

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

  • FileLocationHandler module
    • added support for rest:// and rests:// locations (issue 4669)
    • added support for runtime extensibility from an environment variable (QORE_FILE_LOCATION_HANDLERS) (issue 4667)
  • RestSchemaValidator module
    • parse and report path arguments when processing REST requests on the server side (issue 4661)
  • Swagger module
    • parse and report path arguments when processing REST requests on the server side (issue 4661)
  • Util module
    • added a path_params element to the UriQueryInfo typed hash to allow for reporting path arguments in calls supported by REST schemas (issue 4661)
  • added the get_safe_url() function to avoid exposing passwords in URLs (issue 4671)

Bug Fixes in Qore

Qore 1.12.4

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

Qore 1.12.3

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • DebugUtil module
  • RestHandler module
    • implemented "RestHandler::errorResponseHeaders()" to allow subclasses to return custom headers in error responses, such as when a request cannot be deserialized (issue 4646)
  • RestSchemaValidator module
    • REST handlers must throw a DESERIALIZATION-ERROR when deserialization errors occur, so that a 400 Bad Request response is returned (issue 4647)
    • allow for the client's time zone locale to be set for data serialization / deserialization (issue 4639)
  • Schema module
    • allow the user to determine if a schema alignment operation was a first-time creation or an update (issue 4637)
  • Swagger module
    • REST handlers must throw a DESERIALIZATION-ERROR when deserialization errors occur, so that a 400 Bad Request response is returned (issue 4647)
    • do not reserialize already deserialized data when processing responses (issue 4640)
    • allow for the client's time zone locale to be set for data serialization / deserialization (issue 4639)
  • WebSocketHandler module
    • fixed a bug in WebSocketHandler::sendOne() (issue 4634)
  • fixed crashes in set_signal_handler() and remove_signal_handler() with negative signal values (issue 4643)

Qore 1.12.2

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • DataProvider module
    • added DataProvider::getFactoryObjectWithTemplate() and AbstractDataProviderFactory::createWithTemplate() to allow data providers to be created from factories with template arguments (issue 4624)
    • AbstractDataProvider::search*() fails with record-based data providers that do not provide a record definition (issue 4624)
    • AbstractDataProvider::search*() methods fail with an empty where hash argument (issue 4622)
  • FileLocationHandler module
    • added support for immediate data:// locations (issue 4626)
  • DbDataProvider module
    • fixed sequence and sequence_currval mapper options in DbTableDataProvider (issue 4628)
  • Mapper module
    • fixed Mapper::mapAuto() to accept an iterator argument (issue 4629)
  • SqlUtil module
    • fixed a bug serializing and deserializing Table objects using the odbc driver (issue 4620)
  • Util module
    • fixed a bug in substitute_env_vars() where an exception would be thrown if any referenced environment variable was not set (issue 4632)
Release Summary

Qore 1.12.1

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

  • OdbcFirebirdSqlUtil module
    • added the OdbcFirebirdSqlUtil module to enable Firebird databases to be used with SqlUtil

Bug Fixes in Qore

  • fixed a bug in the cast<> operator where class casts would not enforce the specified class at runtime (issue 4610)
  • fixed a bug in the cast<> operator where it could not be used on lvalues (issue 4609)
  • fixed a bug where the unreferenced-variable warning was raised in situations where it was not warranted, such as when a local variable is assigned a new object and the destructor performs resource cleanup when the local variable goes out of scope (issue 4607)
  • fixed a bug where methodGate() and memberGate() methods were not respected in some cases when referring to undeclared members or methods of a class with the method in question defined as an abstract method (issue 4605)

Qore 1.12.0

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

Bug Fixes in Qore

  • ConnectionProvider module
    • fixed a bug acquiring a data provider object from connection objects (issue 4584)
  • DataProvider module
    • fixed a bug accepting the element type in SoftListDataType (issue 4603)
  • Logger module
    • fixed a race condition handling log file rotation with active logs (issue 4583)
  • PgsqlSqlUtil module
    • fixed bugs handling table objects in schemas other than public (issue 4602)
  • SwaggerDataProvider module
    • fixed a bug where HTTP method names were not accepted as wildcard values in URI paths (issue 4598)
    • fixed a bug setting the data provider name in Swagger schemas provided by files (issue 4587)
  • fixed bugs handling CONNECT messages to HTTP proxies for HTTPS connections to the target server (issue 4601)
  • fixed a bug handling redirect messages with message bodies (issue 4600)

Qore 1.11.0

Release Summary
Bugfix release with minor new features in user modules; see below for more information

New Features in Qore

Qore 1.10.0

Release Summary
Bugfix release with minor new features in user modules; see below for more information

New Features in Qore

Bug Fixes in Qore

Qore 1.9.1

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • SwaggerDataProvider module updates:
    • fixed a bug where data providers could return local names as paths with "/" characters in them, breaking some clients traversing the data provider hierarchy (issue 4555)
  • WebUtil module updates:
    • fixed a bug where files outside the root directory could be served with specially-formatted requests (issue 4550)
  • fixed a bug building with openssl 3+ that could cause a runtime crash when encryption is used (issue 4553)
  • fixed a bug where it was not possible to set the minimum TLS level to v1.3 for encrypted connections (issue 4551)

Qore 1.9.0

Release Summary
Bugfix release with minor new features in user modules; see below for more information

Bug Fixes in Qore

  • FreetdsSqlUtil module
    • fixed the prepend and append column operators (issue 4548)
    • implemented support for generating queries based on generic expressions using the DataProvider module's generic expression support (issue 4538)
  • MysqlSqlUtil module
    • fixed the prepend and append column operators (issue 4548)
    • implemented support for generating queries based on generic expressions using the DataProvider module's generic expression support (issue 4538)
  • PgsqlSqlUtil module
    • implemented support for generating queries based on generic expressions using the DataProvider module's generic expression support (issue 4538)
  • OraclelSqlUtil module
    • implemented support for generating queries based on generic expressions using the DataProvider module's generic expression support (issue 4538)
  • Sqlite3SqlUtil module
    • implemented support for generating queries based on generic expressions using the DataProvider module's generic expression support (issue 4538)
  • SqlUtil module
    • implemented support for generating queries based on generic expressions using the DataProvider module's generic expression support (issue 4538)
  • DataProvider module
    • allow data providers to be introspected with additional information about children (issue 4543)
  • Swagger module
    • fixed a bug where empty definitions could be ignored (issue 4545)

Qore 1.8.1

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • fixed a bug building documentation with autotools (issue 4542)
  • fixed bugs in C++ QoreSocket::send*() methods not used in the Qore language but exposed in the public C++ API that could cause a crash in case of errors (issue 4541)
  • fixed a bug building documentation with release files created from the autotools makefile target, as well as bugs in the cmake configuration generating documentation for builtin modules (issue 4540)

Qore 1.8.0

Release Summary
Bugfix release with minor new features in user modules; see below for more information

Bug Fixes in Qore

  • CsvUtil module
    • updated with initial support for generic expressions for searches (issue 4538)
  • DataProvider module
    • updated with initial support for generic expressions for searches (issue 4538)
    • addded support for data provider options to support default values (issue 4532)
    • addded search_operators to the data provider response to report supported search operators (issue 4528)
    • fixed a type error in DataProvider::search*() calls with an empty where hash argument (issue 4511)
  • FixedLengthUtil module
    • updated with initial support for generic expressions for searches (issue 4538)
  • RestClient module
    • fixed a bug where REST schema validation was not applied in all contexts with specialized REST clients; this was enabled by refactoring the internal code that allowed the validation to be applied (issue 4518)
  • RestHandler module
    • do not raise a validation error when a response with an unknown code has a message body; this hides the true error message from the caller in case of error messages (issue 4534)
    • allow a logger to be set in validators (issue 4509)
  • RestSchemaValidator module
    • allow a logger to be set in validators (issue 4509)
  • ServiceNowRestDataProvider module
    • fixed bugs handling the orderby, orderbydesc, and groupby search options (issue 4536)
  • Sqlite3SqlUtil module
  • Swagger module
    • allow a logger to be set in validators (issue 4509)
  • SwaggerDataProvider module
    • fixed a bug where array types failed due to missing item definitions (issue 4526)
    • fixed a bug where object types in Swagger schemas could be converted directly to object types in Qore instead of hash (issue 4520)
  • fixed a bug where the cast<>() operator threw parse-time exceptions with hashdecls that could succeed at runtime (issue 4531)
  • fixed a bug handling types at parse time with the minus operator and complex hash operands (issue 4529)
  • fixed a static memory leak in libqore shutting down the library when built with openssl 3+ (issue 4522)
  • fixed a bug where HTTP redirect messages were encoded twice causing redirect failures in cases where the redirect URI path had encoded elements (issue 4515)
  • fixed a crash related to stack exhaustion resolving deeply-nested references (issue 4513)

Qore 1.7.2

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

Qore 1.7.1

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • DataProvider module
    • made it possible to determine the default field type in HashDataType (issue 4491)
  • FsUtil module
    • fixed join_paths() to handle an arbitrary number of paths as arguments (the most common use case) (issue 4495)
  • RestHandler module
    • improved error handling and sending error messages when exceptions contain non-serializable objects (issue 4501)
  • Swagger module
    • fixed a bug where global consumes and produces declarations were not respected (issue 4494)
  • Fixed a bug handling reference assignments and calculating matches with overloaded functions and methods (issue 4503)
  • Fixed a bug with compilers that do not guarantee left to right argument execution order such as g++ 12+; note that the C++ standard does not guarantee this in any case (issue 4493)
  • Fixed cast<> operator handling of "or nothing" types at parse and runtime (issue 4497)
  • Load the default provider with OpenSSL3+ to make it work on platforms where this provider is not automatically loaded (ex: Fedora 36) (issue 4394)

Qore 1.7.0

Release Summary
Bugfix release with minor new features; see below for more information

New Features in Qore

Bug Fixes in Qore

  • SwaggerDataProvider module
    • fixed a bug where SwaggerDataProvider did not report binary and date types correctly (issue 4484)
    • fixed a bug where SwaggerDataProvider::getDesc() throws an exception when created without a RestClient option (issue 4475)
    • fixed a bug where the "from file" tag was not respected in constructor options (issue 4473)

Qore 1.6.0

Release Summary
Release with minor new features; see below for more information

New Features in Qore

Bug Fixes in Qore

  • DataProvider module
    • fixed a bug where DataProvider types based on string that accept multiple input types with conversions but are not soft types threw spurious errors at runtime with non-string types (issue 4471)
    • fixed a bug where hash types incorrectly claimed compatibility with incompatible hashes (issue 4463)
  • Mapper module
    • fixed an error mapping bulk data with custom output field handlers (regression) (issue 4460)
  • SwaggerDataProvider module
    • fixed a bug where request messages were not validated and processed correctly (issue 4469)

Qore 1.5.1

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • Mapper module
    • fixed an error mapping bulk data with custom output field handlers (issue 4460)

Qore 1.5.0

Release Summary
Release with minor new features; see below for more information

New Features in Qore

Bug Fixes in Qore

Qore 1.4.0

Release Summary
Release with minor new features; see below for more information

New Features in Qore

  • DataProvider module
    • added support for tags on data provider types (i.e. DataProvider::AbstractDataProviderType) (issue 4442)
    • fixed data provider factory info to provide info about the actual data provider factory instead of only provider info; note that the data provider factory abstract API has changed with this fix (issue 4438)
    • Added "from example" APIs to data provider factories:
      • AbstractDataProviderFactory::getExampleProviderRecordOutput()
      • AbstractDataProviderFactory::getProviderFromExample() (issue 4433)
    • Added generic search capabilities to data providers with no native search functionality (issue 4430)
  • Util module
    • Implemented the serialize_to_string() API (issue 4428)
  • RestHandler module
    • Added missing make*() methods with REST responses to the RestHandler class
  • added the CipherMap constant providing a hash of known ciphers
  • new functions:

Bug Fixes in Qore

  • Util module
    • parse_uri_query() fails if the string has newlines in it (issue 4429)
  • Fixed building on the latest versions of Alpine (v3.15) (issue 4444)
  • Support for OpenSSL 3+ added; when Qore is compiled with OpenSS 3 or greater, all cipher and digest algorithms known to the encryption library are supported with dynamic APIs (issue 4394)
  • Removed code that generated unnecessary ILLEGAL-CALL exceptions at parse time (issue 4404)

Qore 1.3.0

Release Summary
Bugfix release; see below for more information

New Features in Qore

Bug Fixes in Qore

  • fixed a bug handling committing parse operations where final checks were not always made before committing (issue 4426)
  • fixed return type for Type::isAssignableFrom(Type) in the reflection module (issue 4423)
  • fixed bugs in variant matching that could lead to unexpected results at runtime as well as errors with inherited Java code (issue 4421)
  • fixed a bug dispatching method and function calls at runtime in certain cases (issue 4419)

Qore 1.2.0

Release Summary
Minor new features added to Qore

New Features in Qore

  • DataProvider module
    • added a logger to the AbstractDataProvider class to enable logging (issue 4409)
    • added support for creating, updating, and deleting data providers (issue 4395)
  • DbDataProvider module
    • added support for creating, updating, and deleting data providers (issue 4395)

Bug Fixes in Qore

  • FreetdsSqlUtil module
    • fixed a bug where offset and limit were not properly supported with MS SQL Server DBs (issue 4408)
    • fixed a bug where date/time values in other time zones were not bound correctly (issue 4403)
    • fixed a bug handling transaction savepoints (issue 4402)
  • MysqlSqlUtil module
    • allow a VARCHAR column to be created without a size, assume a default size (issue 4399)
  • OracleSqlUtil module
    • allow a VARCHAR column to be created without a size, assume a default size (issue 4399)
  • PgsqlSqlUtil module
    • fixed a bug where objects created did not always contain the actual name used to create it (issue 4396)
  • SqlUtil module
    • respect "or nothing" Qore types when mapping to column types (issue 4400)
  • fixed a bug in certain type errors involving complex types where the specific complex type was omitted from the error message (issue 4412)
  • fixed a bug initializing constant values at parse time; now all constant expressions requiring evaluation are evaluated after all other parsing is done (issue 4404)

Qore 1.1.0

Release Summary
Minor new features added to Qore

New Features in Qore

Bug Fixes in Qore

  • fixed a bug in the stack guard implementation where additional guard area was needed in the primary thread on some platforms (issue 4392)
  • fixed bugs tagging functions and constants provided by builtin modules with their module name; required to consistently provide unique binary names when imported into Java, for example (issue 4383)
  • fixed a bug initializing constant values that could result in spurious errors (issue 4382)
  • added regex APIs to the C++ string class (issue 4379)
  • added a warning for constant operands with the square bracket operator that are not integers (issue 3409)
  • fixed a bug handling EOF conditions while parsing the final part of regular expressions (issue 2096)

Qore 1.0.13

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • Mapper module
    • fixed a bug where it was not possible to use a Mapper with an output provider only for the output data type (issue 4369)
  • SwaggerDataProvider module
    • fixed a regression caused by the bug fix for recursive data structions in the previous version of Qore (issue 4351)
  • fixed bugs tagging namespaces provided by builtin modules with their module name; required to consistently provide unique binary names when imported into Java, for example (issue 4378)
  • updated QUnit constructors to work better with Python and Java subclasses (issue 4377)
  • added internal C++ APIs to allow namespaces to store language-specific information to facilitate bridging Python and Java through the python and jni modules (issue 4373)
  • fixed a bug in qpp (the Qore C++-pre-processor used for building Qore from sources) that failed to recognize methods with multi-line signatures (issue 4366)
  • removed invalid assert()s that caused an unnecessary crash with debug builds when destructors caused program local data to be created in destructors while destroying a Program object (issue 4299)

Qore 1.0.12

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • DataProvider module
    • implemented AbstractDataProvider::beginTransaction() to support starting a transaction in data providers that support transaction management (issue 4346)
  • DbDataProvider module
    • implemented DbDataProvider::beginTransaction() and DbTableDataProvider::beginTransaction() to support starting a transaction when using the AbstractDataProvider API with databases and tables (issue 4346)
  • HttpServer module
    • fixed a bug where incorrect URI decoding was applied to URLs in received HTTP messages instead of URL decoding (issue 4363)
  • MailMessage module
    • various fixes from downstream to mail message data handling (issue 4352)
  • Mime module
    • various fixes from downstream to Mime data handling (issue 4352)
  • PgsqlSqlUtil module
    • fixed handling column names that use reserved words (issue 4348)
  • RestClient module
    • removed erroneous / extraneous URI encoding on REST paths before sending (issue 4360)
  • SqlUtil module
    • fixed upsert usage with unique constraints and indices when there is a non-matching PK (issue 4347)
    • implemented AbstracTable::beginTransaction() to support starting a transaction when using the SqlUtil API with databases and tables (issue 4346)
  • Swagger module
    • fixed a bug where schemas with recursive references could not be loaded (issue 4350)
  • SwaggerDataProvider module
    • fixed a bug where recursive definitions in a Swagger schema resulted in runtime errors using the schema (issue 4351)
  • Util module
    • fixed a bug in parse_to_qore_value() with floats and numbers with trailing zeros (issue 4349)
  • fixed issues encoding URLs in the HTTPClient class according to RFC 1738 section 2.2 (issue 4361)
  • fixed a bug parsing URLs with a query after the port (ex: "http://host:1234?query=true") (issue 4358)
  • fixed a crashing bug when sorting large lists in background threads caused by excessive recursion and stack exhaustion (issue 4355)
  • fixed a bug that caused a core dump with implicit object method calls in arguments in the background operator expression (issue 4344)

Qore 1.0.11

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • cmake builds broken without a build directory (issue 4341)

Qore 1.0.10

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • fixed a bug in calculating abstract overrides in child classes that could cause spurious errors (issue 4338)
  • implemented the Qore::parse_url(string, *int) variant to allow for percent decoding in URL strings (issue 4332)
  • fixed C++ foreign thread registration APIs to support TID reuse to provide thread affinity for language modules such as Python and Java with successive rapid transitions into Qore in callbacks (issue 4331)

Qore 1.0.9

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • fixed stack size reporting for the initial thread on Linux; Linux autoextends the initial thread in any case, so a large stack size is reported (8MB) regardless of the actual stack size reported by pthreads APIs; this allows code that requires a larger stack to run normally on Linux platforms that allocate a small initial stack (such as Alpine, for example, current versions allocate a 128KiB stack which caused stack exceptions in Qore or recursion exceptions in Python to be thrown in the main thread with code that would otherwise work on Linux) (issue 4325)

Qore 1.0.8

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • fixed stack size reporting for the initial thread to reflect the actual stack size used instead of the default stack size for new threads; this allows the python module to correctly calculate the recusion depth for Python modules, allowing more Python modules to be loaded without changing the default stack size in single-threaded programs (issue 4323)

Qore 1.0.7

Release Summary
Bugfix release; see below for more information

New Features

Bug Fixes in Qore

  • HttpServer module
    • HttpServer::addListeners() has no mechanism for returning errors to the caller (issue 4312)
  • Mapper module
    • fixed bugs handling escaped "." characters in field names (issue 4315)
  • fixed a bug where the return type of map expressions would be reported incorrectly at parse time when the iterator expression was a constant value (issue 4319)
  • fixed a bug where the return type of map expressions would be stripped of complex type information at runtime when the iterator experssion was an AbstractIterator object (issue 4318)

Qore 1.0.6

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • DataProvider module
    • return the base_type key in input type info in \ AbstractDataProviderType::getInputInfo() (issue 4311)

Qore 1.0.5

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • DbDataProvider module
    • detect duplicate insert errors and throw a DUPLICATE-RECORD exception with record creation errors (issue 4308)
  • FreetdsSqlUtil module
    • added APIs to enable duplicate record creation errors to be detected (issue 4308)
  • Mapper module
    • fixed handling automatically-acquired input and output data structions with dots in field names; un-deprecated the allow_dot and allow_output_dot options (issue 4309)
  • MysqlSqlUtil module
    • added APIs to enable duplicate record creation errors to be detected (issue 4308)
  • OracleSqlUtil module
    • added APIs to enable duplicate record creation errors to be detected (issue 4308)
  • PgsqlSqlUtil module
    • added APIs to enable duplicate record creation errors to be detected (issue 4308)
  • SqlUtil module
    • added APIs to enable duplicate record creation errors to be detected (issue 4308)

Qore 1.0.4

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • DataProvider module
    • greatly improved dataprovider and type acquisition speed from clients requiring initialization from the environment (issue 4305)

Qore 1.0.3

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

Qore 1.0.2

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • RestHandler module
    • fixed a bug handling errors registering stream errors with a stream handler (issue 4291)

Qore 1.0.1

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • HttpServer module
    • allow dynamic handlers to be removed without waiting for all connections to terminate (issue 4273)
    • allow for full logging of authentication errors if HTTP server debugging is enabled (issue 4217)
  • fixed a bug matching types at parse time that could cause unexpected and confusing results (issue 4284)
  • fixed abstract method matching in inherited Java classes overriding abstract methods (issue 4282)
  • fixed a bug where trying to export or import code in other languages in a Program object with pending parse structures could cause a crash (issue 4279)
  • fixed a bug in Qore::sleep() and Qore::usleep() where calls could return early on platforms with nanosleep() if a signal arrived when sleeping (issue 4275)

Qore 1.0

Release Summary
Bugfix release; see below for more information

Fixes That Can Affect Backwards-Compatibility

  • Some server-side APIs have changed due to the integration of the Logger module in the HttpServer and the HttpServerUtil modules, in particular the errorlogger listener option has been removed, and the type of the logger listener option has been updated to require a Logger object. Additionally, deprecated APIs have been removed from these modules.
  • Implemented the invalid-catch warning when types are required by parse options, byt the exception variable declaration has no type; this was also added to the default warning mask for modules

New Features in Qore

  • added support for Alpine Linux
  • added support for thread-local global variables; see the thread_local keyword
  • new constants:
  • updated methods:
  • type errors with function and method resolution will report the full namespace paths of class and hashdecl types
  • Qore builds now support outputting javadoc for Qore sources to support code completion in Java IDEs for dynamic imports of Qore APIs
  • fixed bugs reporting parse errors where a single error could cause many more unrelated errors to be output
  • module updates:
    • ConnectionProvider module:
      • updated the AbstractConnection::getInfo() method
      • added the AbstractConnection::getExtendedInfo() method
    • DataProvider module:
      • added the limit search option to the DefaultRecordIterator class (issue 4225)
    • HttpServer module:
      • allow dynamic handlers to be disabled before being removed (issue 4173)
      • integrated the Logger module
      • removed deprecated APIs
    • HttpServerUtil module:
      • integrated the Logger module
    • Logger module:
      • added support for the %h and %P patterns for hostname and PID, respectively (issue 4179)
      • allow file appenders to be reopened (issue 4171)
      • enable serialization for LoggerEvent objects as well as for them to be submitted directly to Logger objects (issue 4164)

Bug Fixes in Qore

  • ConnectionProvider module
    • connection path options are subjected to environment variable substitution (issue 4236)
  • HttpServerUtil module
    • fixed a bug handling wildcard address binds in http_get_url_from_bind() (issue 4266)
  • MailMessage module
    • fixed message serialization for SMTP handling; default to base64 encoding for attachments and if the message body has a single "." character on a line; convert any single "." characters on a line to two ".." characters if using only quoted printable encoding (issue issue 3275)
  • Mime module
    • fixed bugs parsing binary data in multipart messages (issue 4223)
  • PgsqlSqlUtil module
    • fixed bugs dropping foreign constraints and indices when aligning tables (issue 4246)
  • Qdx module
    • fixed stripping the final \ character in multi-line entries in tables (issue 4195)
  • SqlUtil module
    • fixed a bug handling foreign constraints backed by indices on DBs that link indices and constraints automatically (issue 4269)
  • SmtpClient module
    • fixed message serialization for SMTP handling in case of single "." characters on a line in serialized data (issue issue 3275)
  • fixed a bug where negative timeouts with lock methods and internal condition variable wait calls would return immediately instead of waiting indefinitely with some objects (issue 4263)
  • fixed bugs reporting parse errors where a single error could cause many more unrelated errors to be output (issue 4260)
  • fixed a bug in method resolution in class hierarchies that could lead to spurious parse errors (issue 4250)
  • fixed a bug handling complex softlist<...> values where illegal matches were allowed under some circumstances leading to runtime errors (issue 4184)
  • fixed a bug handling private:internal members in base classes with multiple inheritance (issue 4175)
  • fixed a bug in Socket where multiple Content-Length headers could be sent in HTTP responses (issue 4168)
  • fixed a crash when adding the same module from a path multiple times with debug builds (issue 4159)
  • fixed bugs handling namespaces in imported binary classes (issue 4142)
  • fixed line number reporting for statements and expressions where the first element is optional (issue 2946)
  • added a warning when strings and non scalar types are mixed with the + and += operators; these operations are errors when %strict-types is in effect (issue 2943)
  • fixed a bug where the ";charset=xxx" string was not added to the Content-Type header when sending HTTP messages with strings with non-ISO-8859-1 character encodings (issue 1824)

Qore 0.9.15

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • DataProvider
    • fixed a bug where the data type was not supported correctly as a data provider type (issue 4232)
  • fixed a potential crash when raising a large number of exceptions or parse warnings that can cause an unprotected stack exhaustion error; max 20 exceptions can be raised at any one time; the rest are ignored (issue 4257)
  • fixed a potential deadlock loading user modules with complex initialization code (issue 4254)
  • fixed a bug where SSL errors were not properly cleared before I/O operations in all cases, leading to incorrect spurious errors being raised in rare cases (issue 4242)
  • fixed a bug where empty binary values could not be deserialized (issue 4238)
  • fixed handling Qore program destruction in a foreign thread in a binary module that could cause a crash (issue 4228)

Qore 0.9.14

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • OracleSqlUtil module updates:
    • fixed a bug where pseudocolumn references were used ambiguously in joins (issue 4214)
    • fixed a bug where pseudocolumn names were quoted in queries leading to errors (issue 4210)
    • fixed a bug generating queries with limit and forupdate (issue 4206)
  • SqlUtil module updates:
    • fixed a bug where pseudocolumn references were used ambiguously in joins (issue 4214)
  • Swagger module updates:
    • fixed a bug where unknown string format types were not ignored but instead caused an exception to be thrown (issue 4203)
  • Util module updates:
    • fixed a bug in parse_memory_size() with numbers larger than 9 (issue 4198)
  • fixed module path handling on Windows to respect the ';' separator as well as the ':' character (issue 4154)

Qore 0.9.13

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • Mapper module updates:
    • fixed a bug handling the struct key in mappers (issue 4189)

Qore 0.9.12

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • fixed path handling on Windows to respect the ';' separator (issue 4154)

Qore 0.9.11

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • CsvUtil
    • updated read and write data providers to provide verbose option support (issue 4139)
    • implemented support for the missing bool and *bool types (issue 4118)
  • DataProvider
    • fixed an issue where it was not possible for pipeline to flush any pending data or to perform reset or purge operations when pipeline processing is complete; for this the AbstractDataProcessor::flush() and AbstractDataProcessor::flushImpl() methods were implemented (issue 4107)
  • FixedLengthUtil
    • updated read and write data providers to provide verbose option support (issue 4139)
  • HttpServer
    • fixed a bug shutting down dedicated socket I/O handlers (issue 4130)
    • fixed a bug where invalid HTTP responses were sent with error messages and chunked transfer encoding (issue 4124)
    • fixed a bug where HTTP stream handlers could not also implement protocol switching (issue 4111)
  • HttpServerUtil
    • fixed a bug where it was not possible to include CORS headers or any context-sensitive information in a 401 response (issue 4136)
    • fixed a bug where HTTP stream handlers could not also implement protocol switching (issue 4111)
    • fixed a bug handling responses to streaming requests with HEAD requests with a Transfer-Encoding: chunked response (issue 4109)
  • ServiceNowRestDataProvider
    • fixed a type error in DataProvider API support (issue 4104)
  • fixed support for 64-bit ARM CPUs; added stack guard support (issue 3965)
  • fixed a bug handling types in assignments with complex hashes (issue 4133)
  • fixed a bug in the remove operator when used with a slice of a hash or an object; hash keys for nonexistent values were returned in a manner inconsistnent with the hash slice operator when not used with the remove operator (issue 4122)
  • fixed a bug in the cast<> operator; invalid exceptions were raised during parsing for values that could still inherit the target class; the check must only be made at runtime (issue 4113)
  • fixed a bug in the instanceof operator; invalid exceptions were raised during parsing for values that could still inherit the target class; the check must only be made at runtime (issue 4112)
  • fixed a bug where it was not possible to poll for I/O on more than one Socket at a time; for this the Socket::poll() static method was implemented (issue 4069)

Qore 0.9.10

Release Summary
Bugfix release; see below for more information

New Modules in Qore

Bug Fixes in Qore

  • WebUtil module updates:
    • fixed a bug serving files did not work in server contexts with multiple threads (issue 4096)
  • fixed an invalid assert in class handling in complex hierarchies (issue 4094)

Qore 0.9.9

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • RestClient module updates:
    • additional fixes to REST path handling with schema validators with a base path (issue 4059)

Qore 0.9.8

Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

Qore 0.9.7

Release Summary
Bugfix release; see below for more information

Release Notes

Note that when a REST validator is present in a REST connection, any URI path in the connection URL is ignored; to change the base path specified by a REST validator, use the swagger_base_path connection option.

Bug Fixes in Qore

  • DataProvider module updates:
    • fixed type-handling bugs handling data provider options (issue 4062)
  • RestClient module updates:
    • fixed a bug where the base path in the Swagger schema was ignored; note that when a REST validator is present, any URI path in the connection URL is ignored; to change the base path specified by a REST validator, use the swagger_base_path connection option (issue 4059)
  • Swagger module updates:
    • fixed a type error in Swagger::getBasePath() for the case when the base path is not set (issue 4064)
  • WebSocketHandler module updates:
    • fixed a bug handling the case when a connection object is deleted in a callback method (issue 4063)

Qore 0.9.6

Note
From Qore 0.9.6 onwards, Qore releases will use semantic versioning.
Release Summary
Bugfix release; see below for more information

Bug Fixes in Qore

  • DataProvider module updates:
    • fixed invalid default return values for AbstractDataProcessor methods (issue 4043)
  • RestClient module updates:
    • added the swagger_base_path option to REST clients and connections to allow for Swagger schemas to have their base path overridden (issue 4059)
  • SwaggerDataProvider module updates:
    • fixed a bug where the base path in the Swagger schema was ignored (issue 4059)
  • fixed a problem with lazy resolution of static class variables that could lead to incorrect runtime execution (issue 4045)
  • fixed a symbol conflict with the gettid() C++ function; use q_gettid() instead to avoid potential symbol conflicts that can result in a crash (issue 4046)
  • fixed a bug handling the class context in closures created with the background operator when created in the context of a subclass of the method called (issue 4051)
  • fixed a bug that could cause a crash destroying thread-local vars when threads terminate (issue 4053)
  • fixed a race condition that could cause a crash when deleting closure-local variable data while holding a lock (issue 4055)

Qore 0.9.5

Release Summary
Bugfix release with minor new features; including full ARM CPU support; see below for more information

Fixes That Can Affect Backwards-Compatibility

  • The ConnectionProvider module was updated with support for verbose option reporting and a connection cache; support for the deprecated constructor was removed from HttpConnection, HttpBasedConnection, as well as from other connection classes
  • The mkdir() function was modified to provide consistent behavior and a consistent return value with and without the parents argument; this function never throws an exception now, and always returns either 0 (meaning no error occurred) or 1 (meaning an error occurred) and no longer returns the number of directories created when parents = True. Use Dir::create() to get the number of directories created as in previous versions of Qore;
    See also
    Qore::mkdir_ex()
  • Fixed broken range() and xrange() where the upper limit of the range was included in the result for maximum compatibility with other languages. To get the old behavior, use the %broken-range parse directive.
  • Floating-point values are always converted to strings with a decimal point; in previous releases of Qore, round floating-point values were converted to strings without any decimal point; i.e. 1.0 will now be converted to "1.0" (in previous releases of Qore, it would be converted to simply "1")

New Features in Qore

  • CdsRestClient
    • new module providing APIs for communicating with the Microsoft Common Data Service REST API
  • CdsRestDataProvider
    • new module providing a data provider API for the Microsoft Common Data Service REST API
  • ConnectionProvider
    • added support for verbose connection option reporting
    • added a connection cache
    • all connection classes updated to support verbose option reporting
  • DataProvider module updates:
    • added new Qore base types to the data type hierarchy
    • implemented the following classes:
      • AbstractDataProcessor
      • DataProviderBulkRecordIterator
      • DataProviderPipeline
        (issue 3876)
    • added the DUPLICATE-RECORD exception documentation for AbstractDataProvider::createRecord()
    • updated to allow data provider type attributes to appear as children in the type hierarchy (issue 4015)
  • FsUtil module updates:
  • reflection module updates:
    • added AbstractConstant::getModuleName()
    • added AbstractReflectionFunction::getCodeFlags()
    • added AbstractReflectionFunction::getCodeFlagList()
    • added AbstractReflectionFunction::getDomain()
    • added AbstractReflectionFunction::getDomainStringList()
    • added AbstractReflectionFunction::getModuleName()
    • added Namespace::getModuleName()
    • added TypedHash::doCast()
  • RestClient
    • added the no_charset option to options (issue 3328)
  • RestSchemaValidator
    • added the no_charset option to options (issue 3328)
  • Schema module updates:
    • allow schema operations to be executed with no output (verbose < 0) (issue 3996)
  • SqlUtil module updates:
    • new AbstractTable methods returning a hash with info about the operation as well as the SQL and any bind arguments used
  • Util module updates:
    • added the parse_memory_size() function (issue 4004)
  • New data type:
  • New methods:
  • New functions:
  • Added stack guard support for ARM processors (issue 3965)

Bug Fixes in Qore

  • DataProvider module updates:
    • fixed a bug where HashDataType would not enforce fields or field types when checking for type and value compatibility (issue 4037)
  • FreetdsSqlUtil module updates:
    • fixed a bug generating literal date/time values for SQL queries (issue 3948)
  • HttpServer module updates:
    • fixed a bug where the HTTP server would not always stop the ThreadPool which caused process shutdowns to hang (issue 3999)
    • fixed a bug where the Expect header was not supported and where binary message bodies were read as strings (issue 4035)
  • MysqlSqlUtil module updates:
    • fixed a bug generating literal date/time values for SQL queries (issue 3948)
  • PgsqlSqlUtil module updates:
    • implemented atomic merge / upsert support (issue 3963)
    • fixed a bug generating literal date/time values for SQL queries (issue 3948)
  • Qdx module updates:
    • fixed a bug where Qore-language post processing fixes were applied to non-Qore docs (issue 3985)
  • QUnit module updates:
    • updated to allow tests to be run with argument handling from languages that do not support lvalue references (issue 3934)
  • fixed a bug in range() and xrange() where the upper limit of the range was included in the result (issue 4031)
  • fixed a bug in exception handling with external language modules where stack trace elements were added in reverse order (issue 4030)
  • fixed a bug in Qore::mkdir() with parents = True (issue 3992)
  • fixed a bug where complex formatting output with sprintf() and related dunctions would have "." separators instead of "," separators when floating-point values were included in the output (issue 3947)
  • fixed a bug handling embedded nulls in UTF-8 strings (issue 2942)

Qore 0.9.4.7

Release Summary

Bugfix release; see details below

Bug Fixes in Qore

Qore 0.9.4.6

Release Summary

Bugfix release; see details below

Bug Fixes in Qore

Qore 0.9.4.5

Release Summary

Bugfix release; see details below

New Features in Qore

Bug Fixes in Qore

  • Mapper module updates:
    • fixed a bug handling external runtime keys with bulk input for keys that do not require the current input value (issue 3931)
  • fixed a race condition in closure-bound variable reference handling that could result in a runtime crash (issue 3939)

Qore 0.9.4.4

Release Summary

Bugfix release; see details below

New Features in Qore

  • Mapper module updates:
    • added support for mapper context in mapper field key handlers (issue 3893)
    • added support for nested mappers and the submappers option (issue 3414)
    • implemented the output_create_ignore_duplicates option
  • added support for freestanding expression evaluation:

Bug Fixes in Qore

  • CsvUtil module updates:
    • fixed FixedLengthWriteDataProvider to return the record created with the createRecord() call (issue 3914)
  • DataProvider module updates:
    • added the DUPLICATE-RECORD exception documentation for AbstractDataProvider::createRecord()
  • FixedLengthUtil module updates:
    • fixed CsvWriteDataProvider to return the record created with the createRecord() call (issue 3914)
  • Mapper module updates:
    • fixed a bug where mapper output data was not logged in case of an error in an output provider (issue 3909)
    • updated mapper key handler calling convertion + docs (issue 3894)
    • fixed Mapper::mapAuto() to return NOTHING with no input (issue 3872)
  • SalesforceRestDataProvider module updates:
    • fixed a bug deleting records with no matches (issue 3921)
    • fixed serializing DATE fields (issue 3908)
  • fixed a bug in class copy methods with private:internal members (issue 3901)
  • fixed bugs running qdbg (issue 3900)

Qore 0.9.4.3

Release Summary

Bugfix release; see details below

New Features in Qore

  • DataProvider module updates:
    • added new classes:
      • AbstractDataProcessor
      • DataProviderBulkRecordIterator
      • DataProviderPipeline
      (issue 3876)
  • Mapper module updates:
    • added the Mapper::mapAuto() method and the disable_bulk option (issue 3872)
    • Mapper now inherits DataProvider::AbstractDataProviderRecordProcessor (issue 3876)

Bug Fixes in Qore

  • fixed a bug in the ThreadPool class where queued tasks were discarded without being executed when ThreadPool::stopWait() was called (issue 3897)
  • fixed a bug determining method signature compatibility with variants of the softlist type (issue 3887)
  • fixed a parse-time type error taking a slice of a hashdecl value (issue 3882)
  • fixed HTTP responses with no message body and no Transfer-Encoding header to include a Content-Length: 0 header to correctly support RFC-2616 (issue 3879)
  • fixed a crash in handling reference arguments in call references in mixed class contexts (issue 3869)
  • fixed a memory leak in the code that manages remote client certificates in the Socket class (issue 3865)

Qore 0.9.4.2

Release Summary

Bugfix release; see details below

New Features in Qore

Bug Fixes in Qore

Qore 0.9.4.1

Release Summary

Bugfix release; see details below

New Features in Qore

  • New FileLocationHandler module: provides an API for retrieving file data based on a URL-like location string

Bug Fixes in Qore

  • DataProvider module:
    • allow type paths to resolved to internal fields in DataProvider::getType() and DataProvider::getTypeEx() (issue 3791)
  • Mapper module:
    • added the Mapper::setNullableOutput() method and the output_nullable option (issue 3788)
  • Swagger module:
    • added support for the x-nullable attribute to allow for nullable values (issue 3785)
    • fixed support for types with no type declaration (issue 3775)
  • SwaggerDataProvider module:
    • fixed support for requests that do not require a request hash (issue 3784)

Qore 0.9.4

Release Summary
The main new feature in this release is the DataProvider API, which provides a generic API for introspecting and manipulating data in any format and over any protocol. Qore 0.9.4 also contains many usability and consistency fixes as well.

Fixes That Can Affect Backwards-Compatibility

  • RestHandler module: renamed RestHandler::getPossibleSubClasses() to RestHandler::doGetPossibleSubClasses() in order to avoid a collision with a REST method name (issue 3614)
  • fixed broken cast<> operator handling; in previous releases, cast<> would accept and return NOTHING without raising an error with type specifications that did not accept or return NOTHING. To get the old behavior, use the %broken-cast parse directive.
  • disallowed the use of the deprecated returns keyword by default. To get the old behavior, use the %allow-returns parse directive.
  • classes inheriting AbstractConnection must be serializable; the AbstractConnection::getConstructorInfo() and AbstractConnection::getConstructorInfoImpl() methods have been removed and are ignored in child classes
  • the following are now reserved words in Qore to prohibit them from being redefined:

New Features in Qore

Bug Fixes in Qore

Bug Fixes in Qore

  • fixed bugs in handling object members assigned to references (issue 3523)
  • fixed bugs in thread-local variable handling and Program destruction (issue 3521)
  • fixed a bug where a crash would result when serializing imported typed hashes (issue 3518)
  • fixed a bug where attempting to serialize a weak references to a serializable object would result in an exception (issue 3515)
  • fixed a bug where new DatasourcePool connections were left in place when calls to DatasourcePool::beginTransaction() would fail with an exception (issue 3509)
  • fixed bugs importing user modules with an injected API in an existing Program container (issue 3504)
  • fixed a memory leak in Serializable::deserialize(string)
  • fixed a memory leak (crash in debug mode) related to deterministic garbage collection (issue 3481)
  • fixed a bug where HTTP redirect messages with a simple path and not a full URL were not processed correctly (issue 3475)
  • fixed a bug where HTTP connections with UNIX domain sockets were sending an incorrect Host: header without URL encoding (issue 3474)
  • fixed bugs affecting injection and Program API management (issue 3461)
  • fixed a bug where a '/' character in an HTTP username would cause a URL to be parsed incorrectly (issue 3457)
  • added optional flags to the following methods to allow them to open file streams in nonblocking mode to handle opening named pipes independently of the writer without blocking: (issue 3451)
  • fixed a bug compiling with openssl with the MDC2 algorithm disabled (issue 3443)
  • fixed a confusing error message with runtime overload type errors where complex type information was missing (issue 3441)
  • fixed parse-time error handling complex types in hashes (issue 3438)
  • fixed many type errors with complex types (issue 3429)
  • fixed inconsistent behavior of references with pseudo-methods (issue 3417)
  • fixed bugs in the return types of Qore::regex_extract() and <string>::regexExtract() (issue 3416)
  • fixed documentation links between dependent modules (issue 3406)
  • fixed a bug where an lvalue with a complex type accepted incompatible assignments from values without complex types if the base type was the same; this fix also ensures that complex type declarations with auto are not treated as identical to the base type without any complex type restrictions, in addition abstract type matching was loosened to accept near matches with parameter types so that ab stract method with a parameter type of hash<auto> can be implemented with a concrete method with a hash parameter type, for example. (issue 3404)
  • fixed a bug where a crash could result when deserializing invalid integer data (issue 3395)
  • fixed a parse type error in initialization using return value of abstract method (issue 3387)
  • fixed a bug where sort functions were incorrectly sorting strings with different lengths (issue 3378)
  • fixed a member initialization bug with imported classes (issue 3368)
  • HttpServer module:
    • shut down dedicated socket conenctions last in order to allow for effective keep-alive implementations with WebSocket for example (issue 3488)
    • fixed a bug where disconnected connections could cause unhandled exceptions to be output in the connection thread (issue 3415)
    • fixed certificate and key errors for HTTPS listeners to generate user-friendly exceptions (issue 3397)
  • Logger module:
  • Mime module:
    • fixed bugs parsing binary data in multipart messages (issue 2936)
  • PgsqlSqlUtil module:
    • fixed comparison of triggers with column restrictions with table alignment (issue 3466)
  • Pop3Client module:
    • fixed the timeout value for upgrading the SSL connection in Pop3Client (issue 3388)
  • QUnit module:
    • allow binary modules to be subjected to dependency injections (issue 3382)
  • RestHandler module:
    • fixed RestHandler losing internal exception info when response was considered invalid by schema validator (issue 3435)
    • fixed RestHandler incorrectly handling Accept header of incoming requests (issue 3426)
    • added debug logging for REST schema validation errors (issue 3410)
  • RestSchemaValidator module:
    • fixed NullRestSchemaValidator not respecting set Content-Type header from RestClass (issue 3427)
  • SmtpClient module:
    • fixed the timeout value for upgrading to SSL connection in SmtpClient (issue 3381)
  • SqlUtil module:
    • fixed quoting of reserved words in column names in table alignment (issue 3400)
    • implemented the AbstractDatabase::getPhysicalSize() method (issue 3385)
  • Util module:
    • fixed a bug parsing nested lists in parse_to_qore_value() (issue 3483)

Qore 0.9.2

Release Summary

Bugfix release; see details below

New Features in Qore

  • qdbg-remote supports an option to provide HTTP headers for WebSocket connections (issue 3350)

Bug Fixes in Qore

  • implemented support for deserializing data from a binary string (issue 3357)
  • fixed a bug with class initialization that could sometimes result in members of parent classes not being initialized when objects were constructed (issue 3355)
  • fixed a bug in the SqlUtil module that could lead to a deadlock when DML methods are used with a datasource pool with connection contention (issue 3352)

Qore 0.9.1

Release Summary

Bugfix release; see details below

New Features in Qore

  • the serialization protocol has been updated to version 1.1; it still reads both binary- and data-serialized data from v1.0
  • added the ListSerializationInfo hashdecl to support serializing and deserializing lists with complex type information
  • new user modules:

Bug Fixes in Qore

  • fixed a bug where the Salesforce rest connection returns 'rest' type instead of 'sfrests' (issue 3346)
  • fixed a bug where an invalid parse exception would be raised with an assignment of a global variable to another global variable with the same name in a different namespace (issue 3337)
  • implemented support for serializing and deserializing complex type information in lists and hashes (issue 3318)
  • fixed bugs handling unassigned lvalues with complex type declarations with the push and unshift operators (issue 3317)
  • fixed a memory leak in copy constructor execution in complex class hierarchies (issue 3312)
  • implemented support for automatically initializing the Qore library from Java when dynamically loaded from the JVM; additionally in this case the jni module is loaded automatically immediately after the Qore library is initialized (issue 3310)
  • implemented support for performing binary searches in binary data by adding the following new pseudo-methods: (issue 3300)
  • Util module fixes:
    • fixed a bug in get_exception_string() with Java exceptions (issue 3304)
  • QUnit module fixes:
    • fixed a bug where tests could not be nested (issue 3306)
  • RestClient:
    • fixed a bug with charset in the RestClient module (issue 3328)
    • fixed default option handling in REST connections including timeout handling (issue 3321)
  • SalesforceRestClient:
    • fixed default option handling in REST connections including timeout handling (issue 3321)
  • SewioRestClient:
    • fixed default option handling in REST connections including timeout handling (issue 3321)
  • WebUtil:
    • fixed a bug when StaticTemplateManager does not respect constructor's parse options in templates (issue 3334

Qore 0.9

Release Summary
This is a major release of Qore with large portions of code subject to extensive optimizations leading to large memory and performance improvements along with more control of Program logic containers, multithreading, and a reflection API. This release breaks binary compatibility with older versions of Qore as well, requiring binary modules to support the new API and ABI.

Changes That Can Affect Backwards-Compatibility

  • Qore classes and functions are now immutable once created; any attempt to add a new user variant to an existing function or method or to add new declarations to an existing class will result in a parse error.
  • Program objects now only support a single complete parse action (Program::parse() or Program::parseCommit()); subsequent attempts to parse code into the same Program object will fail with an exception. If parsing fails due to a parse exception, the Program object is generally no longer usable and must be recreated to be used.
  • Program::parseRollback() is now deprecated; this action removes all user code and most builtin code from the Program object; delete the object instead of using this method
  • the transient keyword has been introduced to support control over object serialization; see also %no-transient

New Features in Qore

Bug Fixes in Qore

  • fixed a bug in parse_url() with single-character hostnames with a port number (issue 3287)
  • fixed a minor bug handling error info in exception handling in the RestClient module (issue 3280)
  • fixed a crash in acquiring a new connection with datasource options (issue 3262)
  • fixed a bug reporting the source location for runtime type errors related to missing return statements (issue 3255)
  • fixed bugs where Datasource::getConfigString() and Datasource::getConfigHash() would require a connection to the server, making it impossible to check option before connecting (issue 3247)
  • fixed a bug with weak references in some assignment expressions (issue 3202)
  • fixed bugs in sprintf(), vsprintf(), and all variants where NOTHING was not treated the same as no value (issue 3184)
  • worked around a potential COW bug in std::string in GNU libdstdc++ 6+ (issue 3179)
  • fixed a bug with simple additional and subtraction with mixed timeout and date values; updated docs that arithmetic operations with timeout values are not recommended and can return unexpected values in some situations (issue 3157)
  • fixed a bug in deterministic garbage collection where Queue objects were not scanned and therefore cycles due to Queue elements would cause a memory and reference leak (issue 3101)
  • fixed a bug where call references did not set the execution context with builtin functions and therefore calls to builtin functions in modules (such as jni) with per-program private data would fail (issue 3024)
  • fixed a bug where rvalue references with complex subtypes could get modified during an assignment (issue 2891)
  • Fixed a bug where class members could be initialized multiple times in a class with multiple inheritance where the same class is inherited multiple times in the hierarchy (issue 2741)
  • Fixed bugs handling abstract methods in complex hierarchies with multiple inheritance (issue 2741)
  • Fixed bugs handling object scope in background expressions (issue 2653)
  • Fixed a bug: hash(list<auto>) where l has an odd number of elements never returns (issue 2860)
  • Fixed a bug where no error is issued when an expression does not have meaning as a top-level statement (issue 2826), and also where such expression is an argument to the background operator (issue 2747)
  • Fixed a bug where the parser does not recognize that a return value of a function call is not ignored if it is an object and its method is immediately called (issue 2863),
  • Fixed a bug where public and private members of classes inherited with private:internal inheritance were not initialized when objects were created (issue 2970),
  • Module fixes:
    • QUnit:
      • fixed error reporting with type errors with number values (issue 2984)

Qore 0.8.13.9

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

  • fixed a bug handling start and end arguments in replace() that would cause a crash (issue 3345)
  • fixed a bug handling invalid DB driver options in datasource creation that could lead to a crash with some drivers (issue 3243)
  • fixed a memory error in internal list handling that could lead to memory corruption and crashes (issue 3206)
  • fixed calls to Dir::list*() methods which failed whenever there was a symlink with a non-existent target in a directory (issue 3192)
  • fixed a bug handling illegal abstract method definitions of special class methods (issue 3126)
  • fixed handling 304 Not Modified responses in the HTTPClient class (issue 3116)
  • fixed a crashing bug in the Transform class when used with encryption algorithms (issue 3111)
  • fixed a crash with multiple hash keys when parsing the hash map operator (issue 3108)
  • module fixes:

Qore 0.8.13.8

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

Qore 0.8.13.7

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

  • module fixes:
  • fixed a race condition in ThreadPool destruction that could cause a crash (issue 2906)
  • fixed a hard to reproduce bug with internal runtime type matching that sometimes caused invalid runtime exceptions to be raised with base class constructors (issue 2928)
  • fixed an error handling attach errors to Program objects from foreign threads after the program has been deleted (issue 2950)
  • fixed a bug that would cause a crash if an unknown "Content-Encoding" value were received by the HTTPClient class (issue 2953)
  • fixed a memory leak with binary objects in certain operations such as when reading a file into a binary object (issue 2982)

Qore 0.8.13.6

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

Qore 0.8.13.5

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

  • fixed a bug where user modules with global variables could not be loaded into Program containers where PO_NO_GLOBAL_VARS was set (issue 2807)
  • fixed a deadlock with RWLock and Condition objects when the read lock is held recursively (issue 2817)
  • module fixes:
    • CsvUtil:
      • implemented the number_format option to allow numbers with alternative decimal separators to be parsed and generated (issue 2806)
    • RestClient:
      • added support for REST requests with binary message bodies; added the "bin" serialization method (issue 2816)
    • RestSchemaValidator:
      • fixed the null validator to handle binary message bodies; fixed issues with "text" serialization with binary message bodies (issue 2816)
    • Mime:
      • fixed a bug in mime_parse_form_urlencoded_string() where repeated elements would be overwriteen by subsequent keys with the same name (issue 2761)

Qore 0.8.13.4

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

  • fixed a bug where hashes and lists with subtype auto were not created correctly with implicit initialization causing excess type stripping which could lead to performance issues with large data structures (issue 2767)
  • implemented a new optional DBI statement method to allow for statement execution only for describing the result set to solve performance issues when describing statements with large data sets (issue 2773)
  • fixed a performance bug by eliminating overzealous and unnecessary internal type stripping (issue 2791)
  • module fixes:
    • CsvUtil:
      • implemented the csvutil_set_global_compat_force_empty_string() function and the compat_force_empty_string CSV parsing option to force "*string" fields with no value to return an empty string when parsing rather than NOTHING for backwards compatibility with very early versions of CsvUtil (issue 2476)
    • Mime:
      • mime_parse_form_urlencoded_string raies a parse exception when there is no value for a key (issue 2760)
    • OracleSqlUtil module changes
      • synonym resolving can fail with duplicated object name (issue 758)
    • SqlUtil:
      • implemented the AbstractTable::getRowIteratorNoExec() method (issue 2773)
    • TableMapper:
      • updated to use the new SQL statement DBI method for efficient execution of queries only for describing result sets with outbound mappers to solve performance problems related to mappers that have statements with large data sets (issue 2773)
      • fixed RawSqlStatementOutboundMapper to be usable without subclassing (issue 2775)

Qore 0.8.13.3

Release Summary
Bugfix release; see details below

New Features in Qore

  • improved debugging support:
    • added support for a Visual Studio Code debug adapter for Qore
    • the debugger can now retrieve sources when running from a remote debug server
    • debugger options can now be set from command line (verbosity etc.)
    • the onAttach() event is now executed synchronously when the program thread context starts
    • the onDetach() event is executed properly when program thread contexts terminate
    • the onStep() now provides the breakpointId value if available
    • the onExit() event was added for greater control over code execution in the debugger
    • the onException() event was improved
    • server commands now support frameid as a parameter
    • added the following methods to support retrieving source code in the debugger:
  • new module:

Bug Fixes in Qore

  • module fixes:
    • QUnit:
      • improved output in assertion failures for strings with special whitespace and for multi-line data structures (issue 2680)
    • WebUtil:
      • made it possible for FileHandler subclasses to add headers to response (issue 2686)
  • HttpServerUtil:
    • improved HTTP log masking to mask fewer false positives when attempting to mask sensitive data (issue 2621)
  • fixed a crashing bug initializing constants with recursive references to code (issue 3027)
  • fixed a crashing bug in the += operator with objects and hashes when %require-types is not in force (issue 2634)
  • fixed a crashing bug in the background operator with non-constant hash expressions with local variable references (issue 2637)
  • worked around an Oracle bug in materialized view creation in the OracleSqlUtil module where when the schema user is missing the CREATE MATERIALIZED VIEW grant the table backing the view is created but the materialized view itself is not created causing future creation actions to fail (issue 2643)
  • implemented support for an optional error-handling method in SQL callbacks in the SqlUtil module to allow SqlUtil to recover from error scenarios in schema creation/alignment (issue 2643)
  • fixed a design bug where an empty list () and an empty hash {} could not be assigned to complex types, leading to excess typing and casting for simple operations (issue 2647)
  • fixed a bug in the map operator with complex types and empty list expressions (issue 2651)
  • fixed a bug where implicitly-declared values of complex "or nothing" types would not be declared with the correct runtime type information (issue 2652)
  • fixed a bug affecting class initialization with out of order initialization (issue 2657)
  • implemented support for the more concise declaration of immediate typed hash values (issue 2675)
  • fixed a bug where a crash would result when evaluating certain expressions in the brackground operator due to a memory error (issue 2679)
  • fixed date formatting output with the Z placeholder to always output the UTC offset as documented (issue 2684)
  • fixed program thread context to return frames properly (issue 2674)
  • fixed an internal memory bug that could cause unallocated memory to be read when creating objects (issue 2712)
  • fixed a memory issue with typed hashes that could lead to a runtime creash (issue 2725)

Qore 0.8.13.2

Release Summary
Bugfix release; see details below

New Features in Qore

  • "thread list", "backtrace all" commands implemented for the debugger (issue 2608)
  • QUnit: overloaded the testAssertionValue() method to support auto/number/float and more verbose output when a difference in number/float values is found (issue 2556)
  • qdbg-remote supports ConnectionProvider connections (issue 2613)
  • new method: Breakpoint::getProgram()

Bug Fixes in Qore

  • module fixes:
    • DebugCmdLine:
      • improved breakpoint usability (issue 2604)
      • fixed a bug parsing call signatures when setting breakpoints (issue 2601)
    • DebugProgramControl:
      • improved breakpoint usability (issue 2604)
      • fixed a bug providing the programId context (issue 2603)
    • QUnit:
      • improved error location reporting by providing all stack location information up until the QUnit call to cover the case when multiple code layers are used such as one or more test modules (issue 1720)
    • SqlUtil:
      • implemented support for literal values in column operators taking column arguments with cop_value() (issue 2555)
    • WebSocketClient:
      • added WebSocketClient::pong() to allow unsolicited PONG messages to be sent (issue 2566)
    • WebSocketHandler:
      • fixed a bug where unsolicited PONG messages caused the connection to be prematurely closed (issue 2566)
  • fixed a bug with implicit initialization of typed hashes; this is now illegal and a HASHDECL-IMPLICIT-CONSTRUCTION-ERROR exception is raised in such cases (issue 2491)
  • fixed a bug with Condition variable handling on macOS High Sierra due to an internal undocumented API change (issue 2576)
  • fixed a memory error with the += operator and uninitialized date/time values (issue 2591)
  • fixed a bug in the remote debugger qdbg-remote where wss:// schemes were not accepted (issue 2596)
  • fixed a bug in an error message in ProgramControl::findFunctionStatementId() (issue 2600)
  • fixed a crash when HTTPClient::setDefaultPath() was called with no argument (issue 2610)
  • fixed a bug in debugger when program is not set (issue 2603)

Qore 0.8.13.1

Release Summary
Bugfix release; see details below

New Features in Qore

  • the sqlutil script has been updated with the –select option to allow dumped table rows to be filtered (issue 2509)

Bug Fixes in Qore

  • fixes in modules:
    • astparser module fixes:
      • fixed memory leaks in AstParser::parseFile() and AstParser::parseString() methods (issue 2261)
      • fixed incorrect flex code regarding parse options leading to segfaults (issue 2262)
    • DebugCmdLine module fixes:
      • fixed value setting to process all remaining arguments on the command line (issue 2294)
    • DebugCmdLine module fixes:
      • the debugger should report ambiguous partial matches as an error (issue 2292)
    • MailMessage module fixes:
      • fixed Message::addBody() with no body present (issue issue 2360)
    • Mapper module fixes:
      • fixed a bug in the STRING-TOO-LONG exception (issue 2405)
    • PgsqlSqlUtil module fixes:
      • fixed a bug where default column values were compared incorrectly leading to false positives when comparing and aligning DB schemas (issue 2527)
    • Qdx module fixes:
    • QUnit fixes:
      • added missing comparison methods (issue 1588):
        • Test::assertRegex()
        • Test::assertNRegex()
        • Test::assertNeq()
        • Test::assertNeqSoft()
        • Test::assertGt()
        • Test::assertGtSoft()
        • Test::assertGe()
        • Test::assertGeSoft()
        • Test::assertLt()
        • Test::assertLtSoft()
        • Test::assertLe()
        • Test::assertLeSoft()
        • Test::assertNothing()
    • RestHandler module fixes:
      • updated to return a 400 Bad Request error when REST schema validation fails on messages received issue 2344)
      • updated to return a 400 Bad Request error when there are string encoding errors with messages received (issue 2398)
      • updated to return a 404 Not Found error when REST subclass does not exist (issue 2405)
      • updated to return a 400 Bad Request error when ENCODING-CONVERSION-ERROR occurs during request parsing (issue 2543)
    • RestSchemaValidator module fixes:
      • updated docs for AbstractRestSchemaValidator::parseRequest() to reflect how validation exceptions should be raised for proper error reporting (issue 2344)
      • fixed handling of messages with non-object (i.e. non-hash) bodies (issue 2366)
    • SqlUtil module changes
      • implemented support for custom column operators (issue 2314)
    • OracleSqlUtil module changes
      • implemented support for chained synonyms (issue 2408)
      • allow to use DBA_* views instead of ALL_* if possible (issue 2418)
    • Swagger module fixes:
      • fixed handling of string type date and date-time formats (issue 2341)
      • fixed example value for binary type (issue 2342)
      • fixed serialization of date/time values (issue 2349)
      • updated to return a 400 Bad Request error when REST schema validation fails on messages received issue 2344)
      • fixed handling of non-string enum types (issue 2364)
      • fixed confusing error messages with invalid parameter types (issue 2365)
      • fixed handling of messages with non-object (i.e. non-hash) bodies (issue 2366)
      • fixed handling of optional parameters (issue 2369)
      • fixed handling of non-string query parameters (issue 2388)
      • fixed a bug where string value constraints were only enforced in requests but not responses (issue 2396)
      • fixed a bug where invalid date, binary, and byte values would cause a 500 Internal Server Error response to be returned instead of a 400 Bad Request error (issue 2397)
      • fixed a bug where date values were formatted incorrectly in Swagger responses (issue 2409)
      • fixed a bug which made it impossible to send data with other content/mime types than json, yamlrpc, FormUrlEncoded or MultipartFormData (issue 2497)
      • fixed handling of string/binary values (issue 2505)
      • fixed a bug where consumes property of operations was sometimes ignored (issue 2507)
      • fixed parsing of responses without Content-Type header (issue 2517)
      • fixed path matching for paths not beginning with a slash (issue 2516)
    • TableMapper module fixes:
      • fixed issues where where description fields of input and output records for automatically-generated options did not reflect column comments and could not be overridden with user input (issue 2520)
  • fixed bugs affecting debugging matching function/method variants and finding statements with special methods and with complex types (issue 1865)
  • fixed a bug in qpp generating hashdecl code in a specific namespace (issue 2255)
  • fixed an error in a hashdecl documentation example (issue 2299)
  • made C++ APIs for complex types for modules public (issue 2271)
  • fixed inconsistencies in the behavior of the range operator (..) and the square brackets operator [] with lists and ranges between immediate evaluation and lazy functional evaluation and aligned the behavior of the operators among supported data types with the remove and delete operators (issue 2260)
  • fixed a bug handling statement indices with parse errors (issue 2312)
  • fixed too-agressive class hierachy checks that disallowed legal hierarchies where the same base class appears more than once in the hierarchy (issue 2317)
  • fixed a crashing bug in the background operator when the object in context goes out of scope with the thread and an exception is thrown (issue 2319)
  • fixed sending duplicate headers when header hash keys differ only in case; headers that differ only in case will be overwritten by the last header in the hash with a matching name with a case-insensitive search (issue 2340)
  • fixed q_absolute_path_windows to correctly recognize relative Windows paths beginning with a drive letter (issue 2377)
  • fixed a bug in private:internal in method execution within a class hierarchy in some cases (issue 2380)
  • fixed an obscure bug handling runtime errors in code calls with a variant matched at parse time where a runtime exception could occur (issue 2392)
  • improved breakpoints (enabled by default), extended help texts, load/save debug history and session (issue 2401)
  • fixed a bug in an error message regarding binary module signal assignments (issue 2439)
  • added C++ functions to allow binary modules to allocate and deallocate multiple signals atomically (issue 2440)
  • eliminated a warning in a header file when building with g++ 7+ (issue 2449)
  • implemented a fix in qdbg to resume any blocked threads before exiting to ensure a clean and correct shutdown of the debugger; fixes a problem when the process ould freeze on quit (issue 2472)
  • fixed bugs in Windows builds (issue 2529)

Qore 0.8.13

Release Summary
Major new features and bug fixes including input and output stream support and sigificant new functionality including several new modules.

Changes That Can Affect Backwards-Compatibility

  • fixed broken continue and break statements that were accepted anywhere in the source and behaved like a return statement; now such statements outside a loop context will result in a parse exception; to get the old behavior, use %broken-loop-statement in your source code
  • fixed broken reference and *reference type restrictions which had no effect prior to this release; to get the old behavior, use %broken-references in your source code
  • the random number generator is always seeded with a random number when the Qore library is initialized; to get a predictable sequence from rand(), you must explicitly seed the random number generator by calling srand() with a predefined seed number
  • the synchronized keyword now operates differently depending on the context; synchronized functions have a global reentrant lock associated with the function (as in previous versions of Qore), whereas now synchronized normal class methods share a reentrant lock associated with the object, while synchronized static class methods share a reentrant lock associated with the class itself. This aligns Qore's synchronized behavior with that of Java and [MethodImpl(MethodImplOptions.Synchronized)] .NET/CLR (issue 894).
  • classes may not have the name "auto" due to the introduction of this identifier as a special type name
  • a new keyword hashdecl has been introduced to support type-safe hash declarations

New Features in Qore

Bug Fixes in Qore

  • fixed a bug causing AbstractQuantifiedBidirectionalIterator not being available (issue 968)
  • BulkSqlUtil module fixes:
    • fixed the module to work properly even with DB drivers that do not support parameter array binding (issue 1154)
  • CsvUtil module fixes:
    • fixed a bug in an error message validating input data (issue 1062)
    • added an exception when detected headers do not match the fields option (issue 2179)
  • HttpServer module fixes:
    • added logic to attempt to mask passwords in log messages (issue 1086)
  • HttpServerUtil module fixes:
    • fixed a bug where the msg arg to AbstractAuthenticator::do401() was ignored (issue 1047)
  • RestHandler module fixes:
    • added logic to allow sensitive data to be masked in log messages (issue 1086)
  • SqlUtil module fixes:
    • fixed a bug in update and upsert statement generation when the given data does not have enough columns to use the unique index found, an error message is generated that contains all the columns names instead of just the column names required by the index (issue 1013)
  • WebSocketClient module fixes:
    • fixed a thread lock starvation race condition (issue 2130)
  • UTF-16 fixes:
  • fixed a bug where break and continue statements were accepted outside of loops (issue 976)
  • fixed a bug compiling on Solaris SPARC with g++ where MPFR_DECL_INIT() is compiled incorrectly with -O1 or greater (issue 958)
  • fixed a bug causing an infinite loop in decompression functions (issue 966)
  • fixed an issue where an internal C++ API (QoreProgram::parseCmdLineDefines()) performed a needless copy of a data structure (issue 1099)
  • fixed a stack corruption bug with asynchronous I/O on UNIX systems with ReadOnlyFile methods (issue 1106)
  • fixed bugs with inconsistent conversions of int, float, and boolean values to date/time values, now they are all converted uniformly to relative date/time values (issue 1156)
  • fixed a bug where Qore allowed code to be declared both public and private without a warning (issue 1187)
  • fixed a bug where the instanceof operator would return True with objects that did not publically inherit the given class or where the given class is not accessible (issue 1191)
  • fixed a bug in qpp support of the 'final' class flag (issue 1222)
  • fixed a bug where the + operator provided access to private members from outside the class (issue 1209)
  • fixed a bug where different overloaded method variant resolution rules were used at parse time (best match in hierarchy) and runtime (best match in first matching class) in a class hierarchy (issue 1229)
  • fixed a bug where exceptions in base class constructor calls did not reflect the actual source location (issue 1230)
  • fixed a bug where runtime function/method variant matching was incorrectly biased towards default matches for missing arguments (issue 1231)
  • fixed bugs where calls to Socket::upgradeClientToSSL() and Socket::upgradeServerToSSL() were ignored with no exception thrown if the socket was not connected (issue 1258)
  • fixed a bug where a closure created in an object scope could not be called if the object had been deleted, even if the closure did not refer to the object (issue 1303)
  • fixed a bug where ord() would return negative numbers for bytes with the high bit set with compilers where char is the same as signed char (issue 1385)
  • fixed a bug where int(number) returned rounded value instead of the integer part (while int(float) behaved correctly; also cf. initializing a softint value from a number vs. from a float) (issue 1463)
  • File::read() now uses character semantics for the length argument (issue 1548)
  • fixed a bug with strongly-typed lvalue assignments with classes created in different Program objects (issue 1551)
  • fixed a bug where an ASCII string and the same string in a different encoding and with diacritics could incorrectly be marked as equal (issue 1579)
  • fixed bugs in HTTPClient methods where string message bodies were not converted to the object's character encoding before transmission (issue 1813)
  • fixed a bug in the reference and *reference assignment restrictions; previously any value was accepted, now only references are accepted as the initial assignment values (issue 1819)
  • fixed a bug in handling the SqlUtil::BLOB type in the FreetdsSqlUtil module (issue 1852)
  • fixed a bug in overloaded call variant matching where missing arguments were counted towards the match (issue 1897)
  • fixed many bugs where parse-time errors could be reported at an incorrect source location; parse-time error location reporting has been completely overhauled and reimplemented for correctness (issue 1930)
  • fixed a bug where code signatures would accept parameter variables without "$" signs even when %allow-bare-refs was not in effect (issue 1941)
  • fixed memory leaks in the scanner related to EOF conditions (issue 1976)
  • rewrote Qore functions Qore::gethostbyname(), Qore::gethostbyname_long() and Qore::gethostbyaddr() to use standard C functions getaddrinfo(3) and getnameinfo(3) internally instead of the deprecated gethostbyname(3) and gethostbyaddr(3) (issue 1952)
  • fixed cmake builds on Darwin (issue 1980)
  • fixed a bug where immediate date-time values were not marked with their type at parse time (issue 2001)
  • fixed a bug where the *data type restriction would allow all types to be assigned at runtime (issue 2002)
  • Qore::RangeIterator::constructor(int) and Qore::xrange(int) were updated; the second arguments were removed to avoid ambiguity with the other overloaded variants (issue 2016)
  • fixed a bug where Qore::replace() could get in an infinite loop with arguments with embededed nulls (issue 2098)
  • fixed a bug in regular expression extraction where an infinite loop could occur (issue 2083)
  • fixed a bug where a call reference to an object method that crosses Program boundaries could result in a core dump when called due to an error managing thread-local data (issue 2145)
  • fixed crashes in scanner due to EOF in comments (issue 2175)

Qore 0.8.12.12

Release Summary
Bugfix release; see details below

New Features in Qore

  • added the HAVE_DSS constant to indicate if the outdated DSS(), DSS1(), DSS_bin(), DSS1_bin(), DSS_HMAC(), and DSS1_HMAC() functions are available in the opnessl library used to compile Qore

Bug Fixes in Qore

  • fixed a bug handling argv in base class constructor execution (issue 2030)
  • fixed a bug handling the connection status in the HTTPClient class (issue 2058)
  • fixed building with openssl 1.1+ (issue 2135)
  • fixed binding more than one wilcard port on a specific address in the HttpServer module (issue 2155)
  • fixed a bug in SqlUtil with column aliases that are reserved words (issue 2163)
  • fixed a memory bug in the splice operator with a binary operand (issue 2303)
  • fixed a bug where calling any SQLStatement method in another thread with an active connection from a DatasourcePool causes a crash (issue 2334)
  • fixed a bug in RestHandler regarding inconsistent handling of URI parameter arguments; the "action" key was only removed from the ah hash when there were no other arguments, introducing an inconsistency in argument handling in REST services (issue 2479)
  • fixed a bug where ENCODING-CONVERSION-ERROR exceptions were not thrown with newer GNU iconv libraries with an API change (issue 2500)

Qore 0.8.12.11

Release Summary
Bugfix release; see details below

New Features in Qore

Bug Fixes in Qore

  • fixed documentation regarding escaping of characters in strings and added a parse exception in case of trying to escape octal values in range 400-777 (issue 50)
  • fixed a crashing bug where Datasource::getConfigString() was called without a connection, also could crash in an implicit internal call to this method with the DatasourcePool class when connections were lost and the warning callback should be called (issue 1992)
  • fixed a bug where Datasource::getConfigHash() returned different values depending on if the object was connected or not (issue 1994)

Qore 0.8.12.10

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

Qore 0.8.12.9

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

  • fixed a memory leak where references participate in recursive references (issue 1774)
  • fixed a build issue with clang++ (issue 1768)
  • fixed a memory leak in the Queue copy constructor when the Queue was used in other objects (such as an event queue, etc; issue 1749)
  • Mapper module fixes:
    • fixed bugs handling the allow_dot and allow_output_dot options (issue 1690)
    • fixed TableMapper bugs introduced in Qore 0.8.12.7 (issue 1754)

Qore 0.8.12.8

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

  • fixed a memory leak in %try-module error handling (issue 1690)
  • fixed a bug in trunc_str() when the string has an invalid multi-byte character at the end of the string and the string is exactly the byte width requested (issue 1693)
  • fixed a bug where ReadOnlyFile::getchar() did not respect character semantics as documented (issue 1547)
  • OracleSqlUtil module fixes:
    • fixed a bug in character_semantics for standalone column (issue 1688)
  • Mapper module fixes:
    • fixed a bug in handling "list mode" data such as submitted by InboundTableMapper::queueData() (issue 1736, bug introduced in Qore 0.8.12.7 with the fix for issue 1626)
  • SqlUtil module fixes:
    • fixed schema alignment skipping column with name "driver" (issue 1684)
    • fixed sqlutil schema management: functional indexes are rejected without () in name (issue 1610)
  • TableMapper module fixes:
    • fixed a bug in handling "list mode" data with optimized inserts (issue 1736, bug introduced in Qore 0.8.12.7 with the fix for issue 1626)
  • WebSocketClient module fixes:
  • WebSocketHandler module fixes:
  • WebSocketUtil module fixes:
  • fixed a bug where a type conversion error in an lvalue assignment could generate a confusing unrelated runtime exception (issue 1697)
  • fixed a bug where invalid characters in the port specification in a URL were ignored (issue 1728)
  • fixed a bug with SSL socket communication the remote closing the connection during a send operation could cause the current thread to go into an infinite loop consuming 100% CPU (issue 1729)
  • fixed a bug in the HashListIterator class iterating hashes with a mix of lists and single values such as used by bulk DML binds; now the single values will appear as the current value for all list elements as per the original design instead of throwing a runtime exception (issue 1738)

Qore 0.8.12.7

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

  • fixed bug in internal string generation with size_t arguments that could cause invalid data to be output or crashes on 32-bit platforms (issue 1640)
  • fixed a runtime memory leak and invalid runtime behavior with undetected recursive lvalue references (issue 1617)
  • improved prompt collection performance with large graphs of objects by eliminating additional unnecessary graph scans, resulting in further large performance improvements in the garbage collector (issue 1363)
  • improved InboundTableMapper::queueData() performance (in the TableMapper module) when used with data in hash of lists format to use bulk DML in input and output without internal data conversions (issue 1626)
  • OracleSqlUtil module fixes:
    • worked around ORA-22165 from op_in() caused by Oracle's limit on number of collection elements (issue 1660)
    • fixed a bug in the force option (i.e. cascade) for dropping types (issue 1683)
  • improved %try-module error reporting and documentation (issue 1648)

Qore 0.8.12.6

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

  • fixed a bug in Qore::parse_url() parsing single-character hostnames (issue 1524)
  • fixed a bug where PO_LOCKDOWN was not set when parsing init and del attributes in user module headers (issue 1535)
  • fixed a bug parsing exception catch block parameter errors (in debug builds only; issue 1558)
  • fixed a bug dereferencing binary values with the [] operator; the behavior now corresponds to the documentation (issue 1566)
  • fixed a bug that would result in a crash if a method were declared both static and abstract (issue 1590)
  • fixed performance issues with the Mapper module (and by extension the TableMapper module) for mappers with many identity (i.e. 1:1) and constant mappings (issue 1620)
  • fixed a bug in the BulkInsertOperation class in the BulkSqlUtil module where inserts would fail or silently insert invalid data in the second or later blocks when constant hashes were used (issue 1625)

Qore 0.8.12.5

Release Summary
Bugfix release; see details below

New Features in Qore

  • added the SalesforceRestClient module for communicating with Salesforce.com using the REST APIs
  • module SqlUtil
    • has support for native default values in tables (issue 1428)
    • has support for Oracle named types (eg. spatial types) for Schema.qm and SchemaReverse.qm. (issue 1465)

Bug Fixes in Qore

Qore 0.8.12.4

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

  • fixed a reference bug in the Queue class introduced in the last release (issue 1309)
  • fixed a bug where database types could not be correctly aligned if they had dependencies (issue 1314); entailed updates in the following modules:
  • fixed a bug in trunc_str() where an infinite loop could be triggered with certain arguments and multi-byte character encodings (issue 1327)
  • improved prompt collection performance with larger graphs of objects by eliminating unnecessary graph scans made during object method calls (issue 1363)
  • fixed bugs in date(string) and date(string, string) where invalid input data was ignored and invalid dates were returned (issue 1369)
  • CsvUtil module:
    • fixed a bug in AbstractCsvIterator::identifyTypeImpl() generating an error message (issue 1355)
  • MailMessage module:
    • fixed a bug using the default encoding in Message::attach() (issue issue 1352)
  • SqlUtil module:
    • fixed the ignored character_semantics column option in schema alignmed (issue 1379)
    • implemented the cop_length() column function (issue 1395)
  • OracleSqlUtil module:
    • OraclePackage attribute body_src is now public to access package bodies
  • Qorize module:
    • Qorize module: new qorize_val() set of functions; qorize_named() introduced; qorize tests
  • TableMapper module:
    • fixed runtime option propagation to TableMapper::SqlStatementMapperIterator from TableMapper::AbstractSqlStatementOutboundMapper::iterator() (issue 1418)
    • fixed SqlStatementMapperIterator::getCount() (issue 1417)
    • added the following methods:
      • TableMapper::AbstractSqlStatementOutboundMapper::getRowIterator()
      • TableMapper::InboundTableMapper::iterator()
      • TableMapper::InboundTableMapperIterator::getRuntime()
      • TableMapper::InboundTableMapperIterator::replaceRuntime()
      • TableMapper::InboundTableMapperIterator::setRuntime()
      • TableMapper::SqlStatementMapperIterator::getRuntime()
      • TableMapper::SqlStatementMapperIterator::replaceRuntime()
      • TableMapper::SqlStatementMapperIterator::setRuntime()
  • QUnit module:
    • fixed showing the assertion location when there are test modules on top of QUnit (issue 1046)
  • fixed inconsistency between list splice operator and splice function (issue 1380)

Qore 0.8.12.3

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

Qore 0.8.12.2

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

Qore 0.8.12.1

Release Summary
Bugfix release; see details below

Bug Fixes in Qore

Qore 0.8.12

Release Summary
Major new release with major new features and bug fixes as well as packaging fixes:
  • added support for deterministic garbage collection
  • standardized function naming convention
  • new functions, methods, constants, operators, and user modules
  • greatly improved support on Windows

Changes That Can Affect Backwards-Compatibility

  • fixed broken list parsing; in previous releases, Qore's parser re-wrote lists without parentheses used as top-level statements with certain assignment operators (=, +=, -=, *=, and /=, but not with others) so that statements like list l = 1, 2, 3; were valid assignments. Due to operator precedence, such statements should normally be interpreted as (list l = 1), 2, 3;, which is not a valid expression. Not only were the rules applied with only some assignment operators, but such lists were only rewritten if used as top-level statements, therefore the rules were applied inconsistenctly depending on where the expression was located in the parse tree. As of Qore 0.8.12, these inconsistencies have been eliminated by default from Qore; all lists are processed according to the precedence rules defined in operators. This could break old code that relied on the old, broken behavior. To get the old behavior, use the %broken-list-parsing parse directive.
  • fixed broken int and softint assignments; previously runtime type errors with these type restrictions were ignored and all values were silently converted to integers for the assignment, now runtime type errors are thrown according to the original design. Parse errors are detected as before. This could break old code that relied on the old, broken behavior. To get the old behavior, use the %broken-int-assignments parse directive.
  • fixed broken multi-character operator parsing; the Qore parser has been updated to no longer accept multi-character operators with whitespace between the chacters making up the operator; it is believed that this was never used and simply caused the parser to be needlessly complicated and caused Qore to be less compatible with other languages. To get the old behavior, use the %broken-operators parse directive.
  • the push, unshift, pop and shift operators now throw an exception when their first operand is not a list and %strict-args is in effect

New Features in Qore

Bug Fixes in Qore

  • fixed format of octal constant - there was an error if a string contained octal constant that is shorter than 3 digit
  • HttpServer module fixes:
    • fixed a bug setting the response encoding in HttpServer::setReplyHeaders() where the Socket encoding was not set properly and therefore the encoding in the Content-Type in the response header did not necessarily match the encoding of the response
    • fixed a socket / connection performance problem with HTTPS listeners where the SSL connection was being negotiated inline with the accept instead of in the connection thread, thereby blocking new connections from being accepted
    • fixed bugs where URI strings were improperly encoded and decoded (also fixed in the RestClient module)
    • fixed a bug in the HttpServer module where chunked sends were not received and decoded properly in all cases for handlers that did not explicitly handle chunked messages
    • fixed a bug in HttpServer::addListener() with an integer argument; a UNIX socket was opened instead of a wildcard listener on the given port
    • fixed typos causing bugs in HTTP error logging (issue 308)
    • fixed a bug formatting IPv6 host addresses in the return value to HttpServer::http_get_url_from_bind() (issue 821)
  • RestClient module fixes:
    • fixed bugs where URI strings were improperly encoded and decoded (also fixed in the HttpServer module)
    • fixed a bug where URI paths were sent as relative paths instead of absolute paths
    • fixed issues where multiple leading "/" chars were sometimes present in the request URI path
    • fixed an issue where a trailing "/" char was sometimes added to the request URI path (issue 899)
  • CsvUtil module fixes:
    • fixed a bug where the "format" field option was not usable with fields assigned type "*date"
    • fixed the default field type as "*string" (from "string") to avoid parsing and outputting empty strings for missing input data
  • Schema module fixes:
    • AbstractSchema::combineOptions() fails when an option variable contains NOTHING instead of a valid hash
    • fixed a bug with "insert-only reference data" with the verbose option; the upsert strategy was changed to UpsertSelectFirst which means that insert-only reference data could also be updated
    • fixed a bug where it was not possible to provide Database options when creating schemas (issue 501)
  • Mapper module fixes:
    • moved field length checks after all transformations have been applied
    • fixed bugs in the "timezone" and "input_timezone" options, documented those options
    • fixed a bug where "constant" field tags assigned to a value that evaluated to boolean False were not recognized (issue 610)
  • SqlUtil module fixes:
    • fixed a bug with queries using a desc argument with the orderby query option with multiple sort columns; the "desc" string was added only to the last column but should have been added to all columns
    • fixed a bug where foreign key constraints with supporting indexes were not tracked and therefore schema alignment on DBs that automatically create indexes for foreign key constraints would fail
    • fixed a bug where driver-specific objects were not included when dropping a schema
    • fixed a bug in subquery handling where bind-by-value arguments from the subquery were lost
    • fixed a bug in the partition by/over operator where column names as given in the query argument hash were not properly recognized
    • fixed a bug in schema alignment; when aligning a schema and an index supporting a PK constraint is introduced in the new schema, the alignment would fail when a constraint is attempted to be disabled that doesn't exist
    • fixed a bug generating select statements for tables accessed through a synonym when used with join clauses; previously inconsistent schema prefixes could be used which could cause errors parsing the SQL statements generated
    • fixed a bug where the AbstractTable lock was held while executing SQL to determine the upsert strategy to use with UpsertAuto
    • fixed a bug where complex bind values as hashes (such as used by the pgsql and oracle drivers) were rejected by SqlUtil (issue 494) when updating
    • fixed a bug where wildcard columns in join tables were not working (issue 499)
    • fixed a bug in "op_in()" where invalid SQL was generated with an argument of 0 (issue 500)
    • fixed bugs in cop_seq() and cop_seq_currval() (issue 624)
    • fixed a bug in join_inner() where the cond argument was ignored (issue 645)
    • fixed "uop_lower()" and "uop_upper()" operators to allow nesting (issue 657)
    • fixed a bug where SqlUtil was generating invalid SQL for some DBs where a wilcard was used with explicit column names (issue 708)
    • fixed a bug where updating an index without any source constraints caused an invalid exception to be raised (issue 768)
    • fixed a bug in AbstractTable::update() with sequence operators (issue 942)
  • OracleSqlUtil module fixes:
    • fixed a bug where column names that are reserved words were not quoted in generated SQL
    • fixed bugs in cop_seq() and cop_seq_currval() (issue 624)
  • PgsqlSqlUtil module fixes:
    • fixed a bug in PgsqlTable::tryInsertImpl(); added an explicit "begin" call to make the savepoint work with PostgreSQL 9.3+ servers
    • fixed a bug retrieving foreign constraints; columns were not guaranteed to be returned in declaration order
    • fixed a bug handling tablespaces in unique constraints
    • fixed a bug handling "time" columns; they were being issued as "time6" instead of "time(6)" (issue 385)
    • fixed support for the following datatypes and aliases: "bit", "bit varying", "char", "character", "character varying", "char varying", "oid", "varchar"
    • fixed bugs in cop_seq() and cop_seq_currval() (issue 624)
  • MysqlSqlUtil module fixes:
  • WebUtil module fixes:
    • fixed a bug where template programs with Qore::PO_ALLOW_BARE_REFS set did not work
    • fixed a bug serving index files in FileHandler::tryServeRequest() where index files could be incorrectly served with a "204 No Content" response (issue 616)
  • WebSocketHandler module fixes:
    • fixed a bug where the connection object was deleted when the connection closes which could cause excess exceptions in multithreaded server code
    • added the WebSocketConnection::connectionClosed() method to be called when the connection is closed
  • WebSocketClient module updates:
    • updated module to version 1.3
    • ignore SOCKET-NOT-OPEN errors when closing (server already closed the connection)
  • RestHandler module fixes:
    • fold all possible arguments in the REST request body into the argument hash so that complex REST requests can be made with clear URI strings
    • fixed a bug where an error calling an internal nonexistent method would be reported with an incorrect error message
    • send errors are now reported in the AbstractRestStreamRequestHandler object so they can be properly logged (issue 734)
    • unknown REST class errors with the base class are now reported consistently like all other such errors (issue 859)
    • fixed an issue where request URI paths with multiple consecutive "/" chars were handled incorrectly (issue 900)
  • Util module fixes:
    • fixed normalize_dir_windows() handling of UNC paths (issue 813)
  • fixed a memory error in error-handling with type errors when parsing user module headers that could cause a crash
  • fixed a memory leak in Socket::setWarningQueue(): when a callback argument is used, the argument can be leaked when the Socket is destroyed
  • fixed a bug where the HTTPClient class did not send the X.509 certificate and private key when making a client SSL connection
  • fixed a bug in the ThreadPool class where an error in shutdown handling could cause a crash in rare conditions when ThreadPool methods are called while the pool is shutting down
  • fixed a crashing bug initializing some lvalues with type restrictions; affected static class variables at least
  • fixed a bug where a class calling an overridden method in a base class constructor that referred to a member that should have been initialized in the subclass would be executed before the subclass's members were initialized causing the method call to fail
  • fixed a memory leak in classes with multiple inheritance and base classes that are inherited multiple times with member initialization
  • fixed a bug in the %include and %append-module-path parse directives where relative paths were not calculated from the script's directory but instead were calculated from the current working directory, causing such paths to fail
  • fixed a bug in Qore::get_qore_library_info() that could cause a crash due to treating the Build attribute as a string when it was an integer
  • fixed a bug in the divide-equals (/=) operator where an exception was not thrown when an operand of zero with arbitrary-precision numeric arguments is used
  • fixed a bug where the connection mode would be reset for every connection in the Qore::FtpClient class
  • fixed a bug in the Qore::FtpClient class where connection problems in the data channel when executing certain FTP commands could cause a crash due to missing error checking
  • fixed a bug in Qore's internal strcasestr() function on platforms that do not support this function (ex: Solaris) that could result in a crash
  • fixed a bug in Qore where string data formatted with %n, %N, or %y could be added to another string with a different character encoding without any automatic conversions, therefore resulting in an improperly-encoded string
  • fixed a crash when parsing when parsing function, method, or closure arguments when either of the duplicate-local-vars or duplicate-block-vars warnings are set due to an error handling thread-local variable info in parse initialization
  • fixed a bug where code with mixed coding styles (old and new) could result in invalid parse errors when parsing base class constructor calls to a base class defined in another coding style
  • fixed a bug where an HTTP response with an unknown Content-Encoding header would cause a crash
  • fixed a memory error with receiving HTTP chunked data with receive callbacks where the buffer object was reset with reference counts > 1
  • fixed a bug in the FtpClient class where socket errors would not cause the connection to be closed automatically and therefore further use of the object required a manual disconnect even though the object supports transparent auto-reconnection
  • fixed a bug where conversions from float to number would introduce inaccuracy in the arbitrary-precision number; ex: 737.38.toNumber() -> 737.3799999999999954525264911353588104248
  • fixed a bug where %requires would fail loading a user module inside a %try-module block
  • fixed a bug in Qore::Program::importClass() where the import would fail if a namespace-justified class name was given and any element of the namespace path didn't already exist in the target whereas the same import would succeed if the namespace were omitted in the call
  • fixed bugs in Qore::Program::importClass(), Qore::Program::importFunction(), and Qore::Program::importGlobalVariable() when namespace-justified arguments were given, in this case when namespaces were created in the target, the internal root namespace index was not updated so the imported objects could not be found with namespace-justified references until the root indexes were updated
  • fixed a bug in the %requires directive where relative paths were not calculated from the script's directory but rather from the current working directory
  • fixed various bugs in path handling on Windows in the following areas:
  • fixed a bug in parsing constant value assignment expressions where such expressions could use or instantiate classes with uncommitted changes and therefore a crash could result
  • fixed a bug in user module initialization and destruction where call references were not accepted, contrary to the documentation and design goals
  • fixed a bug in Qore::Socket::acceptSSL() and Qore::Socket::connectSSL() where the timeout argument was not respected for SSL protocol negotation by implementing non-blocking I/O support for the internal SSL calls for upgrading the socket connection
  • fixed a memory leak in exception handling in the Qore::FtpClient::put() method (thanks to nros)
  • fixed a memory error in string handling in the Qore::FtpClient class's FTP response handling code
  • fixed a bug in aligning table data in the sqlutil example program
  • fixed a bug when loading modules by a path argument; if the module is already loaded, then do not throw an exception
  • adjusted the stack guard buffer for x86_64 from 20K -> 32K which solved some rare crashes related to stack exhaustion (ex: make check works consistently now on x86_64 Linux)
  • fixed a bug handling HTTP send callbacks that returned zero-length strings and binary objects which would cause invalid chunked data to be sent violating the HTTP protocol
  • fixed a bug in the DatasourcePool::getServerVersion() method where the connection to the server was not guaranteed to be in place before the call, in case of connection errors in the pool a crash could result
  • fixed a crash in Qore::FileLineIterator::copy() when no eol attribute is set
  • fixed a bug importing invalid user modules with no module declaration
  • fixed bugs in Qore::Socket::accept() and Qore::Socket::acceptSSL() where the SSL configuration was not copied to the new Qore::Socket
  • fixed some object encapsulation violation bugs where access to methods of a privately-inherited class was allowed from a subclass in certain situations
  • fixed inconsistent object encapsulation enforcement with method references; if a reference to a method is created inside the class, then when executed the call inherits the access rights at the time of creation
  • fixed inconsistent thread gating for code data structures in Program containers that could have theoretically lead to crashes in Program containers that parse code while threads are running
  • fixed a bug in Qore::Program::importFunction() with function names with a namespace path
  • fixed a bug in closure calls when a closure is called from within a closure and referes to closure-bound locally variables in the internal closure call which would previously result in a crash
  • fixed a parse-time memory leak in call reference calls when the callable object is resolved from a class constant
  • fixed a bug in maintaining the conditional compilation status when parsing %include directives and %requires directives with user modules
  • fixed an obscure bug when a thread terminates in a Program object after the Program container itself has already been deleted where the termination would hang while waiting for the Program's thread count to reach zero while the last thread doing the waiting also held the last thread reference
  • fixed a bug where incompatible class definitions were not verified at parse time which could cause a crash in debug builds and unpredictable behavior in non-debug builds
  • fixed a race condition in finalizing thread-local data in Program objects during Program destruction that could lead to a runtime crash
  • fixed a crash when user modules have recursive dependencies
  • fixed a bug with %push-parse-options when used multiple times in the same file; now multiple appearances of this parse directive are ignored
  • fixed a bug initializing static class variables in the parse commit phase where a crash could result due to an error in managing parse commit dependencies
  • fixed Qore::is_writable():
    • on Windows when used with a directory
    • on UNIX to return a value for the current permissions the program is running under
  • fixed a bug in Qore::regex_extract() and in the regex_extract_operator where the result buffer was not resized when it was too small, limiting regular expressions to nine subpatterns; the maximum has been raised to between 90 and 100 before an exception is raised (since the subpattern buffer is allocated on the stack, we need to enforce a limit)
  • fixed a bug with the cast<>() operator where compatible classes were not recognized at runtime that would otherwise be recognized correctly without the cast - fixed the return type in @ref Qore::getcwd() to @ref string_or_nothing_type *string" - fixed a bug in the @ref return "return statement" where the runtime return type was used at parse time which did not work when parsing embedded code - fixed a bug validating return values in method evaluation that could lead to a qore crash - fixed a bug in the @ref requires "requires" directive when applied to builtin features where code to manage user module dependencies was inappropriately applied - fixed a bug nesting 3 levels or more of parse conditionals (@ref ifdef "ifdef" and @ref ifndef "ifndef") where the conditional parse state could be lost (and an assertion was made in debug mode) - fixed a bug where ==, >, and < operators applied type precedence incorrectly when applying optimizations at parse time in relation to arbitrary-precision numeric values - fixed a static memory leak in the parser handling out of line method declarations - fixed a bug in handling socket disconnection errors in SSL operations where the SSL helper object was deleted and then used causing a crash - fixed a bug where @ref deprecated and @ref return-value-ignored warnings were reported at the incorrect source location - fixed a bug in @ref Qore::set_thread_init() where thread initialization did not occur when foreign threads attached to a @ref Qore::Program object with thread initialization set - fixed a bug in call references and objects by replacing string references to the containing Program object with weak references which solved a recursive reference / memory leak issue - fixed a memory leak when a thread init call reference was used with @ref Qore::Program objects - fixed bugs in Qore SSL socket handling when the remote connection is disconnected while performing an SSL upgrade (client or server) that could cause a crash - fixed a bug where the sending an invalid HTTP header to the @ref Qore::Socket::sendHTTPResponse() method could cause a crash - fixed bugs in @ref Qore::system() "system()": - the shell was not being used to execute commands with commands where shell meta-characters were not found with a manual search which caused such commands to fail; additionally \c & (ampersand) characters were not recognized as shell meta-characters - fixed problems with signal handling in child processes on UNIXes: @ref Qore::system() "system()" now always performs a \c fork(2), enables all signals, and calls <tt>execl("/bin/sh", "sh", "-c", </tt><i>command</i><tt>, 0)</tt> in the child process (on UNIX systems; on Windows, system(3) is used directly as before) - fixed a race condition in the @ref Qore::SQL::DatasourcePool "DatasourcePool" class when opening new datasources after a connection error in the first datasource which could cause a crash. Now the first datasource is no longer a "special" datasource used for configuration information; configuration information is contained in a separate object which serves as an internal Datasource factory - fixed a problem where \c SIGCHLD was blocked by default which caused deadlocks when spawning child processes that in turn waited on grandchild processes - now %Qore no longer blocks \c SIGCHLD on UNIX platforms - fixed a bug in BinaryNode::clear() where the internal pointer was freed but not set to 0 leading to a subsequent crash when the object is destroyed; affected HTTPClient chunked reads of binary data when used with a callback - fixed a bug where the runtime exception location could be reported in the wrong location - fixed a bug where the bzip2 library can request a buffer size that could not be handled by the bzip2 library which is not handled by qore and causes a crash while decompressing certain input - fixed a bug handling closure-bound local variables when closures are created in the background operator expression that caused a core dump - fixed the precedence of the @ref assignment_operator "assignment operator (=)"; now the precedence of this operator is the same as the other assignment operators (@ref plus_equals_operator "+=", @ref minus_equals_operator "-=", @ref multiply_equals_operator "*=", and @ref divide_equals_operator "/=", etc); this does not break any code, but does align %Qore with other programming languages (such as C, among others) and allows for expressions such as @code{.py} a = b += 2@endcode to be correctly parsed - fixed a parse-time bug in the @ref trim "trim operator" where the operator's return type was incorrectly returned as @ref int_type "int" instead of the type of the lvalue - fixed a bug initializing object members with a closure that refers to \a self - fixed bugs in the documentation and return types of: - @ref Qore::ReadOnlyFile::readBinaryFile() - @ref Qore::ReadOnlyFile::readTextFile() - fixed a bug in @ref Qore::GetOpt::parse(softlist<auto>), @ref Qore::GetOpt::parse2(softlist<auto>), and @ref Qore::GetOpt::parse3(softlist<auto>) where call-by-value and copy-on-write semantics were not enforced and a shared list argument could be modified - fixed a bug in zoneinfo file parsing where invalid bands with no UTC offset changes against the previous band could cause invalid date/time values to be displayed by Qore for dates on the invalid transition - fixed a bug where imported global variables (@ref Qore::Program::importGlobalVariable()) were added to the pending global variable list and therefore were removed if a parse exception occurred, hwoever the namespace indexes remained, which could lead to unexpected problems at runtime including a crash. Additionally the pending global variable list was not checked which could lead to a memory leak if the a single global variable name is pending, imported, and then committed to the @ref Qore::Program "Program" object. - fixed memory errors managing program feature lists in the CharPtrList class by copying string memory instead of using sometimes temporary values in the list - fixed minor bugs with directive parsing, mostly related to error reporting - fixed bugs in relative date arithmetic where operands were swapped with the @ref minus_operator "- operator" if the first operand was a @ref relative_dates "relative date/time value", additionally an operation with the @ref minus_operator "- operator" where the first operand is a @ref relative_dates "relative date" and the second operand is a @ref absolute_dates "absolute date" is now calculated using the @ref absolute_dates "absolute date"'s epoch offset (offset in seconds and microseconds from \c 1970-01-01Z), and a @ref relative_dates "relative date/time value" is produced - fixed a bug normalizing the result of date arithmetic between hour and minute components of @ref relative_dates "relative date/time value" - fixed a bug where time components of absolute date/time values before the UNIX epoch were returned with invalid values - fixed a bug where the @ref exec-class "exec-class" directive did not check for classes with unimplemented abstract variants - fixed a bug where the @ref push "push" and @ref unshift "unshift" operators applied to a variable declared as softlist did not use the default value - fixed a bug where calls to @ref Qore::HTTPClient::setConnectTimeout() had no effect (<a href="https://github.com/qorelanguage/qore/issues/323">issue 323</a>) - fixed several bugs with logical comparison operators and arbitrary-precision numeric values (<a href="https://github.com/qorelanguage/qore/issues/330">issue 330</a>) - fixed a bug where @ref Qore::HashListIterator (and therefore @ref Qore::zzz8hashzzz9::contextIterator()) would not iterate a simple hash with non-list values once but would instead silently ignore the hash (<a href="https://github.com/qorelanguage/qore/issues/336">issue 336</a>) - fixed a bug where a warning was not always issued when square brackets were used on unsuitable types (<a href="https://github.com/qorelanguage/qore/issues/184">issue 184</a>), internally ported the square bracket operator to the C++ QoreOperatorNode hierarchy - fixed a bug handling return type information for method and pseudo-method calls; uninitialized memory could be used which could cause a runtime crash (<a href="https://github.com/qorelanguage/qore/issues/364">issue 364</a>) - corrected the name of the @ref modulo_operator "modulo operator" (was incorrectly referred to as the "modula" operator earlier: <a href="">issue 389</a>) - fixed a bug handling identifiers in parentheses used to dereference hashes or objects; the identifer is not resolved properly whereas previoulsy it was incorrectly interpreted as a string literal (<a href="https://github.com/qorelanguage/qore/issues/416">issue 416</a>) - fixed a bug with handling local variables in const initializers (<a href="https://github.com/qorelanguage/qore/issues/421">issue 421</a>) - fixed a bug where \c select(2) was called after \c EINTR without reinitializing the descriptor array argument (<a href="https://github.com/qorelanguage/qore/issues/435">issue 435</a>) - fixed a crashing bug on all platforms where select(2) was being called with socket descriptor values > \c FD_SETSIZE (<a href="https://github.com/qorelanguage/qore/issues/436">issue 436</a>) - fixed inconsistencies @ref reldate_comparisons "comparing relative date/time values" (<a href="https://github.com/qorelanguage/qore/issues/437">issue 437</a>) - fixed a bug where @ref on_exit and @ref on_error statements were not being executed if an exception was raised in an earlier-executed @ref on_exit, @ref on_error, or @ref on_success statement (<a href="https://github.com/qorelanguage/qore/issues/380">issue 380</a>) - fixed a bug where @ref Qore::HTTPClient::get() and @ref Qore::HTTPClient::post() would try to retrieve a message body even if <tt>Content-Length: 0</tt> was returned (or if no \c Content-Length header was returned at all) which would result in a deadlock until the server would close the connection (<a href="https://github.com/qorelanguage/qore/issues/434">issue 434</a>) - fixed a bug where regular expression substitution would go into an infinite loop when used with an empty pattern and the global flag (@ref Qore::RE_Global, <a href="https://github.com/qorelanguage/qore/issues/329">issue 329</a>) - fixed a bug with connection handling in the @ref Qore::SQL::SQLStatement "SQLStatement" class; an exception is now thrown if a @ref Qore::SQL::SQLStatement "SQLStatement" object tries to execute its prepared SQL on a connection other than the original connection used to prepare the statement (<a href="https://github.com/qorelanguage/qore/issues/465">issue 465</a>) - fixed a bug where @ref Qore::is_executable() would return NOTHING instead of False (as per documentation) when called with non-existent path as it's parameter (<a href="https://github.com/qorelanguage/qore/issues/470">issue 470</a>) - fixed precedence of logical and bitwise \ref operators (<a href="https://github.com/qorelanguage/qore/issues/481">issue 481</a>) - fixed a bug where nested lists were not parsed correctly in some cases (<a href="https://github.com/qorelanguage/qore/issues/320">issue 320</a>) - fixed a bug where the type of catch parameter was ignored (<a href="https://github.com/qorelanguage/qore/issues/28">issue 28</a>) - fixed a bug where namespace hierarchies were not indexed during parse time when added to already-committed namespaces which lead to symbol resolution errors for valid code (<a href="https://github.com/qorelanguage/qore/issues/538">issue 538</a>) - fixed a bug where a @ref Qore::Socket "Socket" operation attempted in another thread while a callback operation on the same socket was in progress would result in a confusing error message (<a href="https://github.com/qorelanguage/qore/issues/530">issue 530</a>) - fixed a bug where local variable declarations in class member initialization expressions caused a crash (<a href="https://github.com/qorelanguage/qore/issues/574">issue 574</a>) - fixed a bug where HTTP data in HTTP socket events was modified even though it was shared which caused data consistency problems and crashes in the worst case (<a href="https://github.com/qorelanguage/qore/issues/576">issue 576</a>) - fixed a bug where the `+=` operator handled NOTHING values incorrectly (<a href="https://github.com/qorelanguage/qore/issues/582">issue 582</a>) - fixed a bug where a non-numeric define specified on the command line could cause a crash (<a href="https://github.com/qorelanguage/qore/issues/583">issue 583</a>) - fixed a bug where the @ref Qore::SQL::SQLStatement::describe() method would not grab the transation lock even when statements were implicitly executed (<a href="https://github.com/qorelanguage/qore/issues/591">issue 591</a>) - fixed the order of initialization of class members (<a href="https://github.com/qorelanguage/qore/issues/42">issue 42</a>) - fixed a bug in @ref Qore::TimeZone::date(string) where the date returned was in the current contextual time zone and not that of the object (<a href="https://github.com/qorelanguage/qore/issues/584">issue 584</a>) - fixed a bug parsing windows paths in URLs with @ref Qore::parse_url() (<a href="https://github.com/qorelanguage/qore/issues/618">issue 618</a>) - fixed a bug in @ref Qore::TimeZone::constructor(string) on Windows when used with an absolute path (<a href="https://github.com/qorelanguage/qore/issues/626">issue 626</a>) - fixed an I/O-handling bug in the @ref Qore::ReadOnlyFile and @ref Qore::File classes where I/O errors in read operations were silently ignored (<a href="https://github.com/qorelanguage/qore/issues/627">issue 627</a>) - fixed bugs in @ref Qore::ReadOnlyFile::readTextFile() and @ref Qore::ReadOnlyFile::readBinaryFile() would return @ref nothing instead of an empty object when reading empty files; now empty objects are returned in these cases (<a href="https://github.com/qorelanguage/qore/issues/508">issue 508</a>) - fixed a bug in *printf() outputs on Windows with scientific notation with floating-point values (<a href="https://github.com/qorelanguage/qore/issues/631">issue 621</a>) - fixed a bug where the precision of numbers during arithmetic operations was not adjusted correctly (<a href="https://github.com/qorelanguage/qore/issues/630">issue 630</a>, <a href="https://github.com/qorelanguage/qore/issues/908">issue 908</a>) - fixed a bug where the type of subtraction of two numbers was inferred as NOTHING during parsing (<a href="https://github.com/qorelanguage/qore/issues/636">issue 636</a>) - fixed a bug on Windows with @ref Qore::Dir::create() (<a href="https://github.com/qorelanguage/qore/issues/643">issue 643</a>) - fixed a bug where CRLF line endings were not handled correctly by the %exec-class parse directive (<a href="https://github.com/qorelanguage/qore/issues/653">issue 653</a>) - fixed a bug on Windows where @ref Qore::glob() would return paths beginning with \c "." by default (<a href="https://github.com/qorelanguage/qore/issues/660">issue 660</a>) - fixed a bug on Windows where @ref Qore::glob() would fail on \c "\*" or \c xxx "/*" (<a href="https://github.com/qorelanguage/qore/issues/664">issue 664</a>) - fixed a bug on Windows where @ref Qore::glob() would not return paths in sorted order by default (<a href="https://github.com/qorelanguage/qore/issues/665">issue 665</a>) - fixed a bug on Windows where the @ref Qore::Dir class would incorrectly normalize UNC paths by stripping the leading backslash (<a href="https://github.com/qorelanguage/qore/issues/666">issue 666</a>) - fixed a bug where the @ref int_type "int" type restriction would accept any data type at runtime instead of throwing a \c RUNTIME-TYPE-ERROR exception (<a href="https://github.com/qorelanguage/qore/issues/683">issue 683</a>) - fixed bugs reporting the current method context with certain @ref Qore::HTTPClient "HTTPClient" methods that would report the @ref Qore::Socket "Socket" class instead (<a href="https://github.com/qorelanguage/qore/issues/689">issue 689</a>) - fixed a bug handling aborted HTTP chunked transfers; now any data available for reading on a socket when a chunked transfer is aborted is read instead of having a \c SOCKET-SEND-ERROR thrown when the remote end closes the socket during the transfer (<a href="https://github.com/qorelanguage/qore/issues/691">issue 691</a>) - fixed a bug with socket handling where SSL send failures did not cause an exception to be thrown in all cases (<a href="https://github.com/qorelanguage/qore/issues/732">issue 732</a>) - fixed a bug on Windows where @ref Qore::glob() returned files matched without the leading path component (<a href="https://github.com/qorelanguage/qore/issues/761">issue 761</a>) - fixed a bug with socket connection refused handling on Windows where connections were waiting until the timeout instead of returning an error immediately (<a href="https://github.com/qorelanguage/qore/issues/763">issue 763</a>) - fixed a bug where it was not possible to escape an escape character before a \c '$' character in a regular expression substitution target string (<a href="https://github.com/qorelanguage/qore/issues/777">issue 777</a>) - fixed a bug where object member references were treated as expressions returning a constant value which could cause a crash when used in an expression used to initialize a constant value at parse time (<a href="https://github.com/qorelanguage/qore/issues/817">issue 817</a>) - fixed a bug parsing IPv6 localhost (\c "::") with @ref Qore::parse_url() (<a href="https://github.com/qorelanguage/qore/issues/822">issue 822</a>) - fixed a bug in Windows timezone handling caused by erroneous region names (<a href="https://github.com/qorelanguage/qore/issues/824">issue 824</a>) - fixed an internal memory-handling bug that caused a crash when cleaning up the qore library on FreeBSD with clang++ and possibly other platforms (<a href="https://github.com/qorelanguage/qore/issues/839">issue 839</a>) - fixed a bug where \c CALL-WITH-TYPE-ERROR exceptions were thrown based on the parse options in the caller instead of in the target when calling across a @ref Qore::Program "Program" barrier (<a href="https://github.com/qorelanguage/qore/issues/841">issue 841</a>) - fixed a bug where @ref Qore::is_writable() and @ref Qore::is_readable() could return an incorrect value in some cases (<a href="https://github.com/qorelanguage/qore/issues/852">issue 852</a>) - fixed a bug where @ref Qore::format_number() would return an invalid string when the number of decimals to be returned was 0 (<a href="https://github.com/qorelanguage/qore/issues/851">issue 851</a>) - fixed a bug where the @ref delete "delete" and @ref remove "remove" operators would incorrectly create hash keys when attempting to delete inside complex hash structures with non-existent keys (<a href="https://github.com/qorelanguage/qore/issues/855">issue 855</a>) - fixed a bug where duplicate global variable declarations caused a crash (<a href="https://github.com/qorelanguage/qore/issues/891">issue 891</a>) - fixed a memory leak in @ref Qore::SQL::DatasourcePool "DatasourcePool" initialization when the minimum connections cannot be established (<a href="https://github.com/qorelanguage/qore/issues/994">issue 994</a>) - fixed handling of NaN values in logical operators (<a href="https://github.com/qorelanguage/qore/issues/915">issue 915</a>) - fixed sort_descending_stable so that it keeps (instead of reversing) the original order of items that compare equal (<a href="https://github.com/qorelanguage/qore/issues/940">issue 940</a>) - fixed a bug in \c copy() method argument parsing; compatible type declarations were not accepted (<a href="https://github.com/qorelanguage/qore/issues/946">issue 946</a>) @section qore_0811 Qore 0.8.11 @par Release Summary Minor bugfix release for UNIX, major bugfixes for Windows @subsection qore_0811_new_features New Features in Qore - added the @ref Qore::AFMap and @ref Qore::AFStrMap constants - <a href="../../modules/WebUtil/html/index.html">WebUtil</a> updates: - added logic to the default file serving code to determine if the file is a binary or text file from the MIME type - @ref Qore::HTTPClient::sendWithSendCallback() "HTTPClient::sendWithSendCallback()" and @ref Qore::HTTPClient::sendWithSendCallback() "HTTPClient::sendWithSendCallback()" updated such that if a response is received while the chunked send operation is still in progress, an error is assumed, the send operation is aborted, and the response header is read immediately @subsection qore_0811_bug_fixes Bug Fixes in Qore - Windows fixes: - fixed TimeZone copying to use the standard name instead of the display name so that the info can be found in the registry - <a href="../../modules/Util/html/index.html">Util</a> module fixes: - fixed get_random_string() on Windows - fixed absolute_path_windows() - <a href="../../modules/HttpServer/html/index.html">HttpServer</a> module fixes: - when binding a wildcard address with @ref Qore::AF_UNSPEC "AF_UNSPEC" on Windows with HttpServer::addListeners() and both IPv6 and IPv4 addresses are returned, bind both addresses since Windows doesn't direct the IPv4 requests to the wildcard-bound IPv6 listener - fixed file reading by always opening in binary mode - added support for the WSAECONNABORTED socket error - replaced Mime::MultiPartMessage::getRandomString() with Util::get_random_string() to make it work on Windows - fixed a bug in the DBI layer where calling @ref Qore::SQL::SQLStatement::describe() "SQLStatement::describe()" would crash when called with an older module that did not implement this method - other fixes in the <a href="../../modules/Util/html/index.html">Util</a> module (in addition to the Windows-specific fixes above): - fixed \c parse_to_qore_value() with hashes with a comma in the first key name - read from /dev/urandom instead of /dev/random since reads from the latter can block for long periods to fill the entropy pool - do not start signal thread after a fork() if signal handling is enabled, pthread_create() is not async-signal safe (on FreeBSD at least this reliably causes segfaults) @section qore_0810 Qore 0.8.10 @par Release Summary Major release with many many bugfixes and new features such as much improved HTTP and REST support (ex: chunked transfer support + new client and server classes for REST support for chunked transfers and data streaming), improved DB support (ex: new <a href="../../modules/Schema/html/index.html">Schema</a> module, <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> improvements), and much more. @subsection qore_0810_new_features New Features in Qore - better HTTP support; support for chunked sends and receives for streaming data over HTTP and other improvements: - @ref Qore::HTTPClient::sendWithSendCallback() "HTTPClient::sendWithSendCallback()" - @ref Qore::HTTPClient::sendWithRecvCallback() "HTTPClient::sendWithRecvCallback()" - @ref Qore::HTTPClient::sendWithCallbacks() "HTTPClient::sendWithCallbacks()" - @ref Qore::HTTPClient::setPersistent() "HTTPClient::setPersistent()" - @ref Qore::Socket::readHTTPChunkedBodyBinaryWithCallback() "Socket::readHTTPChunkedBodyBinaryWithCallback()" - @ref Qore::Socket::readHTTPChunkedBodyWithCallback() "Socket::readHTTPChunkedBodyWithCallback()" - @ref Qore::Socket::sendHTTPMessageWithCallback() "Socket::sendHTTPMessageWithCallback()" - @ref Qore::Socket::sendHTTPResponseWithCallback() "Socket::sendHTTPResponseWithCallback()" - @ref Qore::Socket::pendingHttpChunkedBody() "Socket::pendingHttpChunkedBody()" - added a minimum body size threshold for compression to <a href="../../modules/HttpServer/html/index.html">HttpServer</a> - <a href="../../modules/RestClient/html/index.html">RestClient</a> module updates: - configurable content encoding for send request message bodies is now supported (ie optional compression) - new user modules: - <a href="../../modules/Schema/html/index.html">Schema</a>: for DB-independent schema management - new public C++ socket performance instrumentation API - new functions: - @ref Qore::close_all_fd() - new constants: - @ref Qore::Err::ESRCH "ESRCH": search error - getModuleHash() and getModuleList() no longer return the \c "filename" key when run in a @ref Qore::Program "Program" context with @ref Qore::PO_NO_EXTERNAL_INFO set - <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> updates: - added insert operator support; for example, for inserting with values from sequences - added new upsert constant maps - added static SqlUtil::AbstractSqlUtilBase::getDatasourceDesc() method - added new Table::insertFromSelect*() variants taking Table arguments - added SqlUtil::Table::checkExistence() method - added support for the \c "forupdate" select option - <a href="../../modules/OracleSqlUtil/html/index.html">OracleSqlUtil</a> updates: - fixed selects with "limit" but no "offset" - convert date/time values to timestamps with microseconds resolution instead of dates with second resolution when dynamically inserting values as strings in SQL (binding by value not affected) - <a href="../../modules/CsvUtil/html/index.html">CsvUtil</a> module updates: - added the \c "write-headers" option to \c AbstractCsvWriter and subclasses to enable headers to be suppressed - added the \c "optimal-quotes" option to \c AbstractCsvWriter and subclasses to enable more efficient csv output (now the default) - added @ref Qore::SQL::AbstractDatasource::currentThreadInTransaction() "AbstractDatasource::currentThreadInTransaction()" which is reimplemented as @ref Qore::SQL::Datasource::currentThreadInTransaction() "Datasource::currentThreadInTransaction()" and @ref Qore::SQL::DatasourcePool::currentThreadInTransaction() "DatasourcePool::currentThreadInTransaction()"; the base class method throws an exception when called; it was not added as an abstract method in order to not break existing subclasses of AbstractDatasource - enhanced module license support - module license strings may now be specified in binary and user modules - @ref Qore::getModuleHash() and @ref Qore::getModuleList() now report license information for each module @subsection qore_0810_bug_fixes Bug Fixes in Qore - fixed an issue with class constant parse initialization where invalid recursive class constant definition parse exceptions could be raised and in some cases also crashes could result - <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a> module: fixed missing username and missing password errors - fixed a bug where a qore switch statement with no case conditions and only a default label would erroneously never have it's default code executed - fixed a reference leak related to exception handling with invalid arguments with @ref Qore::Socket::setWarningQueue() and @ref Qore::HTTPClient::setWarningQueue() - fixed several bugs where the parse location could be reported incorrectly for type errors regarding in-object variable references - fixed a bug where an error could result with @ref Qore::Thread::Condition::wait() "Condition::wait()" with timeouts > 2147483648ms - fixed bugs handling "bigint" and "double precision" column types with schema alignments with the <a href="../../modules/PgsqlSqlUtil/html/index.html">PgsqlSqlUtil</a> module - fixed a bug handling parse initialization of constant values requiring run-time evaluation after other parse exceptions have been raised that could cause a parse-time crash - fixed a bug where qore could crash on exit with certain openssl versions by calling ERR_remove_state(0) in the main thread's cleanup function - fixed a bug where qore could crash on exit due to user module destruction not taking into consideration user module dependencies - fixed a bug in schema management in <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> where excessively verbose column aliases were used that caused errors when automatically updating columns with existing rows and new default values and non-null contraints with PostgreSQL databases - fixed a bug where a call reference to an abstract object method returned from an abstract class could be executed even though it must have been instantiated by a concrete subclass - fixed a bug where a valid call reference to a private object method was created within the class, then in some cases an object protection exception was raised when the call reference was called outside the class - fixed a bug in the <a href="../../modules/RestClient/html/index.html">RestClient</a> module when the yaml binary module is not available - fixed programmatic select queries with "limit" but no "offset" in <a href="../../modules/OracleSqlUtil/html/index.html">OracleSqlUtil</a> - fixed a bug in @ref Qore::Program::importFunction() where only the committed function list was checked when importing functions with a specific target namespace path - fixed a bug in @ref Qore::Program::importClass() where only the committed class list was checked when importing functions with a specific target namespace path - fixed a bug when parsing subnamespaces into a parent namespace where the subnamespace already exists (either in the committed list or in the pending list) - fixed a memory and reference leak caused by recursive references when closures encapsulating an object's scope are assigned to or accessible from members of the object by making references to the object from within a closure encapsulating the object's state weak references instead of strong references - fixed schema information classes when the "string-numbers" driver option is enabled - fixed crashing bugs in @ref Qore::get_thread_data() in certain use cases - fixed a bug in <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> where select and row iterator operations could fail with certain select hash arguments without a \c "columns" entry but where column names were otherwise required - fixed a bug in HTTP response parsing where case-signficant comparisons where being made with certain critical header values - fixed a bug handling thread cancellation with the @ref Qore::Thread::ThreadPool "ThreadPool" class - fixed several race conditions and potential deadlocks in @ref Qore::Thread::ThreadPool "ThreadPool" destruction with active threads in the pool @section qore_089 Qore 0.8.9 @par Release Summary Major release with many new features and also many bugfixes. @subsection qore_089_new_features New Features in Qore - <a href="../../modules/CsvUtil/html/index.html">CsvUtil</a> module updates: - new classes: - \c CsvAbstractIterator: base abstract iterator class for iterating line-based CSV data - \c CsvDataIterator: iterator class allowing for CSV string data to be processed line by line on a record basis - \c AbstractCsvWriter: a base class for new CSV writer implementations - \c CsvFileWriter: CSV file writer class - \c CsvStringWriter: CSV in memory writer class - implemented support for allowing subclasses of CsvFileIterator to implement support for other custom types - no need to set \c "headers" in the constructor if \c "fields" are set; headers are assumed to be the field labels in the same order - added the @ref Qore::encode_url() function with <a href="http://tools.ietf.org/html/rfc3986#section-2.1">RFC 3986 section 2.1</a> compliance - @ref Qore::decode_url() function updated to decode UTF-8 encoded characters according to <a href="http://tools.ietf.org/html/rfc3986#section-2.1">RFC 3986 section 2.1</a> - added get_byte_size() and get_marketing_byte_size() to the <a href="../../modules/Util/html/index.html">Util</a> module - the error message now includes the module path used for the search when a module cannot be found in the module path - @ref Qore::SQL::DatasourcePool "DatasourcePool" enhancements: - new method: @ref Qore::SQL::DatasourcePool::clearWarningCallback() "DatasourcePool::clearWarningCallback()" - new method: @ref Qore::SQL::DatasourcePool::setWarningCallback() "DatasourcePool::setWarningCallback()" - new method: @ref Qore::SQL::DatasourcePool::getUsageInfo() "DatasourcePool::getUsageInfo()" - new method: @ref Qore::SQL::DatasourcePool::setErrorTimeout() "DatasourcePool::setErrorTimeout()" - new method: @ref Qore::SQL::DatasourcePool::getErrorTimeout() "DatasourcePool::getErrorTimeout()" - new method: @ref Qore::SQL::DatasourcePool::setEventQueue() "DatasourcePool::setEventQueue()" - new method: @ref Qore::SQL::DatasourcePool::clearEventQueue() "DatasourcePool::clearEventQueue()" - the new methods allow for monitoring @ref Qore::SQL::DatasourcePool "DatasourcePool" objects for pool contention issues (in case the pool needs to be resized), for throwing an exception if a connection is not acquired within the error timeout period (new default: 2 minutes), and for DBI drivers to raise warnings on an event queue that can be monitored in a separate thread - additionally connection acquisition statistics are tracked and returned in @ref Qore::SQL::DatasourcePool::getUsageInfo() "DatasourcePool::getUsageInfo()" (total requests, hits, maximum wait time) - @ref Qore::SQL::Datasource "Datasource" enhancements: - new method: @ref Qore::SQL::Datasource::setEventQueue() "Datasource::setEventQueue()" - new method: @ref Qore::SQL::Datasource::clearEventQueue() "Datasource::clearEventQueue()" - the new methods allow for DBI drivers to raise warnings on an event queue that can be monitored in a separate thread - @ref Qore::Socket "Socket" enhancements: - new method: @ref Qore::Socket::setWarningQueue() "Socket::setWarningQueue()" - new method: @ref Qore::Socket::clearWarningQueue() "Socket::clearWarningQueue()" - new method: @ref Qore::Socket::getUsageInfo() "Socket::getUsageInfo()" - new method: @ref Qore::Socket::clearStats() "Socket::clearStats()" - @ref Qore::FtpClient "FtpClient" enhancements: - new method: @ref Qore::FtpClient::setWarningQueue() "FtpClient::setWarningQueue()" - new method: @ref Qore::FtpClient::clearWarningQueue() "FtpClient::clearWarningQueue()" - new method: @ref Qore::FtpClient::getUsageInfo() "FtpClient::getUsageInfo()" - new method: @ref Qore::FtpClient::clearStats() "FtpClient::clearStats()" - <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a> module updates: - optimized connection and login code; HELO/EHLO and authorization are performed when connecting only, not before each email - added support for socket performance instrumentation and warning events - <a href="../../modules/Pop3Client/html/index.html">Pop3Client</a> module updates: - added support for socket performance instrumentation and warning events - <a href="../../modules/TelnetClient/html/index.html">TelnetClient</a> module updates: - added support for socket performance instrumentation and warning events - <a href="../../modules/WebSocketClient/html/index.html">WebSocketClient</a> module updates: - added support for socket performance instrumentation and warning events - <a href="../../modules/RestClient/html/index.html">RestClient</a> module updates: - use the new @ref Qore::encode_url() function to encode URL paths to ensure that valid requests are sent when spaces, percent characters, and non-ascii characters are used in the URL path - set the character encoding in the \c Content-Type request header when sending strings - set the \c Accept header correctly in requests (previously only indicated yaml (\c "text/x-yaml") as an acceptible response encoding) - <a href="../../modules/RestHandler/html/index.html">RestHandler</a> module updates: - added support for the \c OPTIONS method - return a 400 \c "Bad Request" error if an unsupported HTTP method is used in a REST Call - added new \c UpsertInsertOnly upsert strategy to <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> - new pseudo-methods: - @ref Qore::zzz8valuezzz9::sizep(): returns @ref True "True" if the type can return a non-zero size (@ref True "True" for containers including @ref binary "binary objects" and @ref string "strings", @ref False "False" for everything else) - @ref Qore::zzz8stringzzz9::getLine(): finds lines in a string buffer - <a href="../../modules/Mime/html/index.html">Mime</a> module updates: - added mime type for WSDL files (\c "application/wsdl+xml") - added mappings for \c "xls" and \c "xlst" extensions to MimeTypeXml - added new modules: - <a href="../../modules/Mapper/html/index.html">Mapper</a>: data mapping module - <a href="../../modules/TableMapper/html/index.html">TableMapper</a>: data mapping module using <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> and <a href="../../modules/Mapper/html/index.html">Mapper</a> to map to an SQL table target - <a href="../../modules/FreetdsSqlUtil/html/index.html">FreetdsSqlUtil</a>: provides back-end support for MS SQL Server and Sybase databases with <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> using the <a href="https://github.com/qorelanguage/module-sybase">freetds module</a> - the @ref include "include" parse directive now supports environment variable substitution at the beginning of the file path @subsection qore_089_bug_fixes Bug Fixes in Qore - fixed a crashing bug handling access to members as default values of normal method arguments (<a href="https://github.com/qorelanguage/qore/issues/3240">issue 3240</a>) - fixed a bug in the <a href="../../modules/RestClient/html/index.html">RestClient</a> module where the \c "response-code" key of the info output hash could be missing in some cases (<a href="https://github.com/qorelanguage/qore/issues/3237">issue 3237</a>) - fixed bugs handling object-local access in member initialization (<a href="https://github.com/qorelanguage/qore/issues/3193">issue 3193</a>) - fixed a crashing bug when HTTP messages with duplicate \c Connection, \c Content-Encoding, \c Transfer-Encoding, \c Location, or \c Content-Type headers are received - fixed a bug parsing octal character constants in the lexer when octal digits followed the octal constant (ex: \c "\0441" where the \c "1" would cause an error) - allow escaping "$" character in regular expression substitution target strings, previously it was impossible to output a literal "$" + a digit, since this would be interpreted as a numbered input pattern expression - fixed a bug in the @ref Qore::HTTPClient::getURL() "HTTPClient::getURL()" and @ref Qore::HTTPClient::getProxyURL() "HTTPClient::getProxyURL()" methods where the URL's path was not given with a leading "/" character - <a href="../../modules/CsvUtil/html/index.html">CsvUtil</a> module fixes: - fixed \c "date" field handling with empty input (now maps to 1970-01-01) - fixed CsvDataIterator::next() when header_lines > 0 and working with empty input data - added support for compiling on OSX Mavericks - fixed an infinitely recursive call in Table::del() in <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> - fixed a bug in v*printf() where \c '%%' was not handled correctly in all cases - fixed bugs in @ref Qore::microseconds() "microseconds" and @ref Qore::milliseconds() "milliseconds()" with large arguments - fixed a bug where a call to a call reference to a static method across a program boundary with local variables as arguments would cause a crash due to improper setting of the program context before the arguments are evaluated - fixed a bug in @ref Qore::SQL::Datasource::copy() "Datasource::copy()" method where implicitly-set options were not carried over into the new object - fixed a bug in the @ref Qore::SQL::DatasourcePool "DatasourcePool" class where implicitly-opened connections would not be guaranteed to have the same server time zone setting as the initial connections (for example, could cause problems with server timezone settings if running in a program context with a different local time zone attribute) - fixed bugs in <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> generating "create table" and "align table" SQL with DBs where unique indexes automatically create unique constraints (ex: MySQL) - fixed a bug in lchown() where chown() was used interally instead of lchown() - fixed a bug in <a href="../../modules/PgsqlSqlUtil/html/index.html">PgsqlSqlUtil</a> retrieving sequence values with Database::getNextSequenceValue() - fixed an off-by-one memory bug in @ref Qore::date(string, string) parsing a 4-digit date mask - fixed memory leaks in class member and class static variable management - fixed memory leaks when an entire class has to be rolled back due to parse errors and the class has pending static variables - fixed memory leaks in constant handling with values containing call references - fixed a memory leak in constant destruction with parse rollbacks when the constant value was NULL - fixed an error in the rounding heuristic for arbitrary-precision numeric values that could produce invalid results (ex: 34.9n * 100 = 34902n) - enforce @ref Qore::PO_NO_FILESYSTEM "PO_NO_FILESYSTEM" with the @ref include "include" directive - fixed a bug managing object private data in complex inheritance cases where the same class may be inherited with virtual private data and also real private data - fixed a bug in socket timeout handling with select() errors - fixed a memory leak in handling abstract methods when multiple abstract methods with the same name but different signatures were declared in a class @section qore_088 Qore 0.8.8 @par Release Summary Major new features and bug fixes with a particular focus on enhanced HTTP capabilities and enhanced database processing @subsection qore_088_compatibility Changes That Can Affect Backwards-Compatibility - Fixed method resolution order; it's now possible to call pseudo-methods directly on classes that implement @ref methodGate_methods "methodGate() methods" - Added the following abstract methods to @ref Qore::SQL::AbstractDatasource "AbstractDatasource": - @ref Qore::SQL::AbstractDatasource::getConfigHash() "AbstractDatasource::getConfigHash()" - @ref Qore::SQL::AbstractDatasource::getConfigString() "AbstractDatasource::getConfigString()" - "hard" string comparisons now perform encoding conversions if necessary (however as usual different data types cause the comparison to fail) @subsection qore_088_new_features New Features in Qore - new @ref user_modules "user modules" delivered with %Qore: - <a href="../../modules/RestClient/html/index.html">RestClient</a>: Provides a simple API for communicating with HTTP servers implementing <a href="http://en.wikipedia.org/wiki/Representational_state_transfer">REST</a> services - <a href="../../modules/RestHandler/html/index.html">RestHandler</a>: Provides an easy to use interface to the Qore <a href="../../modules/HttpServer/html/index.html">HttpServer</a> module for implementing server-side <a href="http://en.wikipedia.org/wiki/Representational_state_transfer">REST</a> services - <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a>: Provides a high-level DB-independent API for working with database objects - <a href="../../modules/MysqlSqlUtil/html/index.html">MysqlSqlUtil</a>: Provides a high-level DB-independent API for working with MySQL database objects; loaded automatically by the <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> module when working with MySQL databases - <a href="../../modules/OracleSqlUtil/html/index.html">OracleSqlUtil</a>: Provides a high-level DB-independent API for working with Oracle database objects; loaded automatically by the <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> module when working with Oracle databases - <a href="../../modules/PgsqlSqlUtil/html/index.html">PgsqlSqlUtil</a>: Provides a high-level DB-independent API for working with PostgreSQL database objects; loaded automatically by the <a href="../../modules/SqlUtil/html/index.html">SqlUtil</a> module when working with PostgreSQL databases - <a href="../../modules/Util/html/index.html">Util</a>: Provides a some miscellaneous generally useful routines - <a href="../../modules/WebSocketClient/html/index.html">WebSocketClient</a>: Provides a client API for connecting to WebSocket servers - <a href="../../modules/WebSocketHandler/html/index.html">WebSocketHandler</a>: Provides an interface to the Qore <a href="../../modules/HttpServer/html/index.html">HttpServer</a> module for implementing server-side WebSocket services - <a href="../../modules/WebSocketUtil/html/index.html">WebSocketUtil</a>: Provides common client and server code for implementing WebSocket protocol services in %Qore - <a href="../../modules/WebUtil/html/index.html">WebUtil</a>: Provides server support for implementing complex web services including serving resources with mixed text and %Qore code that are automatically rendered on demand - improvements in existing @ref user_modules "user modules": - much improved <a href="../../modules/HttpServer/html/index.html">HttpServer</a> module, better performance, much better RFC compliance, more flexibility - new CSV generation class in <a href="../../modules/CsvUtil/html/index.html">CsvUtil</a> - much better message serialization and email attachment handling in the <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a> and <a href="../../modules/MailMessage/html/index.html">MailMessage</a> modules - there is a new @ref Qore::Thread::ThreadPool "ThreadPool" class for implementing thread pools that automatically upscale and downscale within user-defined limits depending on the load placed on them - it's possible to inherit concrete versions of abstract method variants from a parent class that does not define the abstract method, meaning that concrete variants of an abstract method do not have to be implemented in a direct subclass of the class declaring the abstract method\n this makes using abstract base classes much easier in complex hierarchies using multiple inheritance; now common code can be separated into a single class and inherited by child classes sharing the common implementation - major @ref Qore::Socket "Socket" read performance increase by implementing internal read buffering (up to 10x faster socket read performance for certain operations, particularly with HTTP methods) - improved Unicode / UTF-8 support - Qore::zzz8stringzzz9::lwr(), Qore::zzz8stringzzz9::upr(), @ref Qore::tolower(string), and @ref Qore::toupper(string) now operate on a very wide range of non-ASCII characters, including Latin, Cyrillic, Greek, Armenian, Georgian, etc characters whereas they were previously limited to working on ASCII characters - Qore::zzz8stringzzz9::unaccent() was added which removes accents from strings using a Unicode lookup map from a very wide range of accented Unicode characters to unaccented characters - new @ref Qore::SQL::Datasource "Datasource" and @ref Qore::SQL::DatasourcePool "DatasourcePool" methods: - Qore::SQL::Datasource::getConfigHash() - Qore::SQL::Datasource::getConfigString() - Qore::SQL::DatasourcePool::getConfigHash() - Qore::SQL::DatasourcePool::getConfigString() - Qore::SQL::DatasourcePool::copy() - @ref Qore::HTTPClient "HTTPClient" changes: - the @ref Qore::HTTPClient "HTTPClient" class is now a subclass of @ref Qore::Socket "Socket", so all @ref Qore::Socket "Socket" methods can be called on @ref Qore::HTTPClient "HTTPClient" objects, making it easier to implement protocols based on HTTP - Qore::HTTPClient::getDefaultPath(): added - Qore::HTTPClient::setDefaultPath(): added - Qore::HTTPClient::getURL(): changed: now returns @ref nothing if no URL is set instead of an invalid URL - new functions: - call_pseudo_args() - @ref Qore::substr(binary, softint) "substr(binary, softint)" - @ref Qore::substr(binary, softint, softint) "substr(binary, softint, softint)" - new pseudo methods: - Qore::zzz8binaryzzz9::substr(softint) - Qore::zzz8binaryzzz9::substr(softint, softint) - Qore::zzz8binaryzzz9::toBase64() - Qore::zzz8binaryzzz9::toHex() - Qore::zzz8binaryzzz9::toString() - Qore::zzz8datezzz9::getEpochSeconds() - Qore::zzz8datezzz9::getEpochSecondsLocalTime() - Qore::zzz8datezzz9::info() - Qore::zzz8floatzzz9::abs() - Qore::zzz8hashzzz9::compareKeys(hash) - Qore::zzz8intzzz9::abs() - Qore::zzz8intzzz9::encodeLsb(int) - Qore::zzz8intzzz9::encodeMsb(int) - Qore::zzz8intzzz9::toUnicode() - Qore::zzz8numberzzz9::abs() - Qore::zzz8objectzzz9::hasCallableMethod() - Qore::zzz8objectzzz9::hasCallableNormalMethod() - Qore::zzz8objectzzz9::hasCallableStaticMethod() - Qore::zzz8listzzz9::rangeIterator() - Qore::zzz8nothingzzz9::rangeIterator() - Qore::zzz8stringzzz9::comparePartial() - Qore::zzz8stringzzz9::getUnicode() - Qore::zzz8stringzzz9::equalPartial() - Qore::zzz8stringzzz9::equalPartialPath() - Qore::zzz8stringzzz9::toBase64() - Qore::zzz8stringzzz9::toHex() - Qore::zzz8stringzzz9::unaccent() - Qore::zzz8valuezzz9::toNumber() - other new methods and method changes: - added new static methods in the @ref Qore::ReadOnlyFile "ReadOnlyFile" class making it easier to read entire files in one call: - @ref Qore::ReadOnlyFile::readTextFile() - @ref Qore::ReadOnlyFile::readBinaryFile() - changes to catch usage errors with the @ref Qore::Thread::Counter "Counter" class: - Qore::Thread::Counter::constructor() will throw an exception if called with an argument < 0 - Qore::Thread::Counter::dec() will now throw an exception if called when the Counter is already at 0 - Qore::Thread::Queue::empty(): new method - Qore::Socket::listen(): now has a new \a backlog parameter; the default backlog queue size was changed from 5 to 20 - Qore::Socket::getPeerInfo() and Qore::Socket::getSocketInfo(): now takes an optional argument to avoid name lookups - Qore::Socket::readHTTPHeaderString(): new method - Qore::Dir: all list*() methods now take an optional parameter to return a list of file status value hashes plus \c "name" and optionally \c "link" keys for symbolic links; additionally symbolic links are now followed and files and directories are differentiated based on their targets when processing symbolic links - function changes - added optional \a start and \a end parameters to the @ref Qore::replace "replace()" function - all @ref data_type_declarations "data type declarations" that optionally accept @ref nothing also now accept @ref null and map @ref null to @ref nothing; this makes direct assignments from values derived from SQL queries much easier - added an optional reference to an integer to the @ref Qore::backquote() function to return the return code of the program executed - @ref implicit_index "implicit index" references now work in the @ref map "map" and @ref select "select" operators with lists and iterators - the @ref regex_extract_operator now accepts an optional \c g specifier to extract all occurrences of the pattern(s) in a string; also @ref Qore::regex_extract "regex_extract()" and Qore::zzz8stringzzz9::regexExtract(string, int) now accept @ref Qore::RE_Global to extract all occurrences of the pattern(s) in a string - the @ref splice "splice" and @ref extract "extract" operators were extended to work on @ref binary "binary objects" as well as lists and strings - printing out binary values with the \c "y" @ref string_formatting "format specifier" now produces YAML-like output for the binary value - added path name to error messages in @ref Qore::Dir "Dir" class exception strings @subsection qore_088_bug_fixes Bug Fixes in Qore - fixed a bug where the ?: operator could thrown spurious exceptions when parsing because it would return the type of the initial boolean expression as the return type of the operator - fixed a bug where classes with unimplemented inherited abstract variants would sometimes cause runtime exceptions to be thrown when instantiated but should have instead been caught at parse time - fixed a parser bug where out-of-line class method definitions could not be defined in a namespace block - fixed a bug parsing arguments in parse_uri_query() in the <a href="../../modules/HttpServer/html/index.html">HttpServer</a> module - fixed several bugs where parse exceptions could show the wrong source location: - with type errors in function calls - when resolving global variables - in base class constructor arguments - for empty blocks with a missing return statement - when validating types used with the return statement (also associated warnings) - in methods calls - in hash value expressions - with redeclaring local variable return types - in local variable object instantiations - really fixed the bug thought to be fixed in 0.8.7 "where SSL errors would cause the affected thread to go into a infinite loop using 100% CPU" - this turned out to be easily reproducible on all platforms; when the SSL connection was shut down cleanly by the remote end before a response message was returned, an infinite loop would result - fixed a bug where it was impossible to output a single '\' character in regex substitution expressions; '\' was taken as an escape character, and '\\\' was output literally, now '\\\' is output as '\' - fixed a bug where a parse-time crash would occur when calling the copy() method for a class that does not implement an explicit copy() method - fixed a bug where arguments passed to a copy method were ignored; now an exception is thrown - fixed a bug where public members and static variables of privately-inherited classes were incorrectly treated as public attributes of the child class - fixed a bug where slices could be made of objects from outside the class including private members - fixed a bug where @ref Qore::SQL::SQLStatement::memberGate() "memberGate() methods" were not being respected when taking a slice of an object - fixed bugs in the integer Socket::recv*() methods where a \c SOCKET-CLOSED exception was not thrown when the remote end closed the connection - fixed a bug related to out-of-order parse initialization for functions and methods which resulted in the wrong return type being returned for a method with more than 1 variant where the variant could not be matched at parse time - fixed a bug where a non-variable-reference member of an "our" variable declaration list would cause a crash due to passing the incorrect argument in sprintf() - fixed sandboxing / protection errors with inherited code; subclasses inheriting code from a parent class with different parse options would cause the child parse options to be used when running the parent class code which caused errors; now parse options are enforced properly on the block level - fixed the @ref Qore::RangeIterator "RangeIterator" class; it was still abstract due to a missing @ref Qore::RangeIterator::valid() method - fixed a bug where the wrong error was being returned after a connection reset (remote connection close) in sockets with integer recv*() methods which could in some cases lead to an infinite loop - fixed a bug where private members of a common base class were not accessible by objects of subclasses sharing the common base class - fixed many bugs in <a href="../../modules/CsvUtil/html/index.html">CsvUtil</a> and updated the module version to 1.1 - initialize static openssl crypto locks for multi-threaded openssl library access; without this crashes can result (for example in error queue management) - fixed a bug where Qore::HTTPClient::getURL() returned an invalid URL when no URL was set; now it returns @ref nothing in this case - fixed a bug managing feature/module lists in inherited @ref Qore::Program "Program" objects; user modules were listed in the child @ref Qore::Program "Program" object even though user module code is not imported in child @ref Qore::Program "Program" objects - fixed a bug where an invalid guard condition in critical lvalue storage code can cause unreferenced data to be returned while in a lock which can cause a crash in a multithreaded program - fixed a bug where references were not being written to the output variable if an exception was active when the code block exited - fixed a bug setting the precision for arbitrary-precision numbers with large exponents (like "1e100n") - implemented more strict adherence to <a href="http://tools.ietf.org/html/rfc2616">RFC 2616</a> (HTTP 1.1) regarding message-body handling in requests and response message generation and parsing - fixed a bug with @ref Qore::Thread::Condition::wait() "Condition::wait()" on Darwin with negative timeout values where a short timeout was used instead of an indefinite wait - fixed bugs in the <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a> and <a href="../../modules/MailMessage/html/index.html">MailMessage</a> modules where mail messages were being serialized incorrectly if there were no attachments (there was no possibility to set the content transfer encoding) and also where it was not possible to set the content-type for the message body when it was sent as a part of a multipart message - fixed bugs handling arguments declared as type @ref reference_or_nothing_type "*reference" (reference or nothing) - fixed bugs in executing code accross @ref Qore::Program "Program" object barriers with reference arguments - fixed a bug with the switch statement where character encoding differences would cause strings to mismatch even if they were otherwise identical; now hard comparisons with strings allow for implicit automatic temporary character encoding conversions for the comparison - fixed a bug where qore failed to set the time zone region correctly when set from /etc/localtime and this file is a relative symlink rather than absolute - fixed a bug where substr() and Qore::zzz8stringzzz9::substr() were returning @ref nothing if the arguments could not be satisifed contrary to the documentation and the declared return type, now an empty string is returned in those cases - fixed bugs rounding number values between 10 and -10 (non-inclusive) for display, fixed bugs rounding number value regarding digits after the decimal point for display with @ref Qore::NF_Scientific - fixed a bug in the @ref Qore::Dir class where it was not possible to chdir to the root directory \c "/" - fixed a bug where recursive references were allowed and memory leaks would occur due to recursive references; these are now caught at runtime and a \c REFERENCE-ERROR exception is thrown - fixed a configure bug with bison >= 3 - fixed a bug in the <a href="../../modules/HttpServer/html/index.html">HttpServer</a> module when automatically uncompressing supported content-encodings to set the resulting string's character encoding correctly - fixed a bug in the @ref instanceof "instanceof" operator when working with objects and classes created from different source @ref Qore::Program "Program" objects - fixed a bug in *printf() formatting with floating-point and number values where no digits were displayed right of the decimal point unless a specific number of digits was specified in the format string - fixed the return type of Qore::zzz8boolzzz9::typeCode(); was returning a boolean instead of @ref Qore::NT_BOOLEAN - fixed a bug there @ref null was evaluated as @ref True "True" in a boolean context rather than @ref False "False" - fixed a bug where @ref Qore::Socket::recvBinary() would ignore the first data read - fixed starting listeners on UNIX domain sockets on Soalris in the <a href="../../modules/HttpServer/html/index.html">HttpServer</a> module - fixed a bug where number("") was being converted to \@NaN\@n - fixed return type of @ref Qore::HTTPClient::getConnectionPath() "HTTPClient::getConnectionPath()" - fixed several bugs with logical comparison operators and arbitrary-precision numeric values where arbitrary-precision numeric values were not being prioritized as numeric values and also in some cases were being first converted to doubles and then operated on - fixed a bug in the socket code where the socket close condition was not flagged with SSL connections when writes failed due to the remote end closing the connection; an error would only be raised on the following socket operation - fixed a mismatched delete/malloc error with time zone initialization and the localtime file @section qore_087 Qore 0.8.7 @par Release Summary Code embedding improvements @subsection qore_087_compatibility Changes That Can Affect Backwards-Compatibility @par Fixes for Code Inheritance in Program Objects The following changes are meant to sanitize code inheritance in child @ref Qore::Program "Program" objects to fix long-standing design bugs in code encapsulation by addressing the lack of fine-grained control over symbol visibility in inherited code. - @ref mod_public "public": The @ref mod_public "public" keyword's usage in modules has now been expanded to provide the same functionality generically in @ref Qore::Program "Program" objects; if @ref qore_classes "classes", @ref constants "constants", @ref qore_namespaces "namespaces", @ref qore_functions "functions", or @ref global_variables "global variables" are defined with the @ref mod_public "public" keyword, then these symbols will be inherited into child @ref Qore::Program "Program" objects as long as no @ref parse_options "parse options" prohibit it.\n\n This change was made to give programmers complete control over which symbols are inherited in child @ref Qore::Program "Program" objects, whereas because prior to this change, the control was very course.\n\n - the default behavior of %Qore regarding inherting global variables and functions with user variants was changed to be consistent with namespaces, classes, and constants; that is; public symbols are inherited by default.\n\n The following constants were renamed: - <tt>PO_INHERIT_USER_FUNC_VARIANTS</tt> is now: @ref Qore::PO_NO_INHERIT_USER_FUNC_VARIANTS "PO_NO_INHERIT_USER_FUNC_VARIANTS" - <tt>PO_INHERIT_GLOBAL_VARS</tt> is now: @ref Qore::PO_NO_INHERIT_GLOBAL_VARS "PO_NO_INHERIT_GLOBAL_VARS"\n\n This change was made to fix a long-standing design problem with symbol inheritance and make the implementation consistent.\n\n - builtin symbols are no longer inherited from user modules; only independent user symbols; the main change is that if a user module adds new user methods to a builtin class or new user variants to a builtin function, these changes are no longer imported into target @ref Qore::Program "Program" objects. @par File Method Changes The following methods were updated to throw exceptions on all errors rather than a return code for I/O errors in order to avoid hard to debug conditions due to ignoring I/O errors by forgetting to check the return value on the following methods: - Qore::File::f_printf() - Qore::File::f_vprintf() - Qore::File::print() - Qore::File::printf() - Qore::File::vprintf() - Qore::File::write() - Qore::File::writei1() - Qore::File::writei2() - Qore::File::writei4() - Qore::File::writei8() - Qore::File::writei2LSB() - Qore::File::writei4LSB() - Qore::File::writei8LSB() . Note that the above changes will hopefully only minimally impact backwards-compatibilty since the change is in error handling, and additionally each of the above methods could also throw an exception if called when the object was not open. @subsection qore_087_new_features New Features in Qore - new methods offering code encapsulation enhancements - @ref Qore::Program::loadModule() "Program::loadModule()": allows modules to be loaded in a @ref Qore::Program "Program" object directly - @ref Qore::Program::importClass() "Program::importClass()": allows classes to be individually imported in @ref Qore::Program "Program" objects - new pseudo-methods in @ref Qore::zzz8nothingzzz9 to allow for @ref Qore::zzz8hashzzz9 pseudo-methods to be safely used with @ref nothing - Qore::zzz8nothingzzz9::firstKey() - Qore::zzz8nothingzzz9::firstValue() - Qore::zzz8nothingzzz9::hasKey() - Qore::zzz8nothingzzz9::hasKeyValue() - Qore::zzz8nothingzzz9::keys() - Qore::zzz8nothingzzz9::lastKey() - Qore::zzz8nothingzzz9::lastValue() - Qore::zzz8nothingzzz9::values() - other new pseudo-methods: - Qore::zzz8datezzz9::durationSeconds() - Qore::zzz8datezzz9::durationMilliseconds() - Qore::zzz8datezzz9::durationMicroseconds() - removed most restrictions on embedded logic in user modules; user module @ref Qore::Program "Program" objects are subject to the same restrictions as the parent @ref Qore::Program "Program" object (if any) - added the get_parse_options() function so that parse options in the current @ref Qore::Program "Program" can be determined at runtime - added the get_ex_pos() function to help with formatting exception locations where the \c source and \c offset information is present - new methods and method variants: - @ref Qore::HTTPClient::getPeerInfo() - @ref Qore::HTTPClient::getSocketInfo() - @ref Qore::File::getTerminalAttributes() - @ref Qore::SQL::Datasource::transactionTid() - @ref Qore::SQL::Datasource::currentThreadInTransaction() - @ref Qore::SQL::DatasourcePool::currentThreadInTransaction() - new location tags \c "source" and \c "offset" added for parse and runtime exceptions to allow for error-reporting to display information about files where sections of a source file are parsed; this allows both the label and line offset in the label and the file name and absolute file line position to be reported in exception information - new parameters added to the following methods and function to accommodate the new location information: - @ref Qore::Program::parse() "Program::parse()" - @ref Qore::Program::parsePending() "Program::parsePending()" - @ref Qore::parse() "parse()" - see @ref Qore::ExceptionInfo "Exception Hash" and @ref Qore::CallStackInfo "Call Stacks" for new keys in exception and call stack information hashes - Qore::zzz8datezzz9::format() now accepts \c "us" for microseconds (see @ref date_formatting) - <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a> module improvements: - added automatic recognition and support of the \c "STARTTLS" command when connecting to an ESMTP server; this way the class will automatically upgrade the connection to a secure TLS/SSL connection if the server supports it - added support for SMTP server schemes in the URL in the constructor (ex: \c "esmtptls://user@password:smtp.example.com") - added support for the deprecated (but still in use) \c "smtps" scheme with a default port of 465 - when throwing an exception when a Message cannot be sent because it is incomplete, the reason for the error is also included in the exception (previously the exception message was generic making problems with the Message object harder to debug) - C++ API Enhancements - added C++ APIs to allow for %Qore @ref Qore::File "File" and @ref Qore::Thread::Queue "Queue" object arguments to be used by modules - added C++ APIs for controlling openssl initialization and cleanup by the qore library - extended qpp to allow for parsing relative dates in qpp code for assignments/default argument values - made it possible to call the C++ function QoreFunction::findVariant() from threads where there is no current QoreProgram object (such as from a thread created by foreign code) - added APIs to allow foreign threads to be registered/deregistered as %Qore threads (for example, to allow %Qore code to be called in a callback in a foreign thread created by a library linked with a %Qore binary module) - added APIs to allow for TID reservations to allow (for example) for a callback that is executed in the same foreign thread to always have the same TID - the old Datasource::execRaw() function with the \a args parameter was deprecated since args was ignored anyway, a new Datasource::execRaw() function was added that has no args parammeter @subsection qore_087_bug_fixes Bug Fixes in Qore - fixed a runtime class matching bug when identical user classes were created in different @ref Qore::Program "Program" objects, the match could fail at runtime because the wrong APIs were being used - fixed a crashing bug in the @ref map "map" operator with a select expression when used with an @ref Qore::AbstractIterator "AbstractIterator" object for the list operand - fixed a bug where the generation of internal strings for abstract method signatures tries to resolve class names that are declared out of order, which incorrectly resulted in a parse exception; the fix is to use the class name in the signature before class resolution; the class is resolved in the second stage of parsing (symbol resolution) anyway, if it can't be resolved then the changes to the @ref Qore::Program "Program" are rolled back anyway - a potential deadlock was fixed when calling @ref Qore::exit() "exit()" while background threads were running; it was possible for a thread to be canceled while holding a @ref Qore::Thread::Mutex "Mutex" (for example) and then for another thread to deadlock trying to acquire the @ref Qore::Thread::Mutex "Mutex" and therefore for the process to deadlock because pthread_mutex_lock() is not a cancellation point. The solution was to cancel all threads first, then wait half a second, then call exit() - fixed a bug where global variables were being evaluated with strict mathematical boolean evaluation even when @ref perl-bool-eval "perl-bool-eval" was enabled (which is the default) - fixed bug in @ref Qore::parseBase64String() and @ref Qore::parseBase64StringToString() when called with an empty string argument; in this case uninitialized memory was returned - fixed runtime dynamic memory leaks in the @ref select and @ref map operators when used with iterators - do thread-specific cleanup in the main thread when cleaning up/shutting down the qore library - added additional openssl cleanup code for thread-local data and when cleaning up the qore library - fixed a bug matching function/method variants at runtime - fixed a race condition deleting global dynamic handlers in the <a href="../../modules/HttpServer/html/index.html">HttpServer</a> module - fixed a bug where declaring an abstract method with parameters and then declaring a concrete reimplementation of the method in a child class with no parameters caused a parse-time crash - fixed a bug where trying to dynamically call a function that does not exist results in a deadlock due to an error where a mutex is not unlocked - fixed a bug in the @ref Qore::Socket::sendHTTPMessage() and @ref Qore::Socket::sendHTTPResponse() methods regarding the timeout parameter - fixed a bug in an socket SSL error message where the method name was printed from non-string memory (used wrong ptr for the <tt>%%s</tt> format argument) - fixed some major crashing bugs related to reference handling; a global variable assigned a reference to a reference to a local variable would cause a crash - @ref reference_type and @ref reference_or_nothing_type type fixes: an error in @ref reference_type type handling allowed non-reference values to be passed to builtin code expecing references which caused a crash; the @ref reference_type and @ref reference_or_nothing_type types would accept any value type - attempted to fix a non-reproducible bug seen on rhel5 in the @ref Qore::Socket "Socket class" where SSL errors would cause the affected thread to go into a infinite loop using 100% CPU @section qore_0862 Qore 0.8.6.2 @par Release Summary Iterator improvements and design fixes @subsection qore_0862_compatibility Changes That Can Affect Backwards-Compatibility @par Fixes for Iterator Class Design Bugs Iterators, particular regarding the @ref map "map" and @ref select "select" operators, were implemented in a confusing and inconsistent way; even the %qore documentation was incorrect, and examples were given incorrectly. The following changes will break functionality using the badly-implemented behavior of iterators before, but since the fix comes fairly soon after the introduction, hopefully this change will not cause too many problems with existing code. All users polled about the iterator changes in this release saw them as positive and desired changes to the language. - the @ref map "map" and @ref select "select" operators' behavior was changed when used with an @ref Qore::AbstractIterator "AbstractIterator" object for the list operand; now the implied argument is the result of @ref Qore::AbstractIterator::getValue() "AbstractIterator::getValue()" instead of the iterator object itself. This addresses a confusing design choice in the original iterator integration with the @ref map "map" and @ref select "select" operators - the second boolean argument was removed from the @ref Qore::HashIterator::constructor(hash&lt;auto&gt;) "HashIterator::constructor(hash<auto>)" and @ref Qore::HashReverseIterator::constructor(hash&lt;auto&gt;) "HashReverseIterator::constructor(hash)" methods; use the new @ref Qore::HashPairIterator "HashPairIterator" and @ref Qore::ObjectPairIterator "ObjectPairIterator" classes instead (Qore::zzz8hashzzz9::pairIterator() and Qore::zzz8objectzzz9::pairIterator()) - the single boolean argument was removed from Qore::zzz8hashzzz9::iterator() and Qore::zzz8objectzzz9::iterator(); use Qore::zzz8hashzzz9::pairIterator() and Qore::zzz8objectzzz9::pairIterator() instead to get the old behavior @subsection qore_0862_changes Changes in Qore - new iterator classes: - @ref Qore::HashKeyIterator "HashKeyIterator" - @ref Qore::HashKeyReverseIterator "HashKeyReverseIterator" - @ref Qore::HashPairIterator "HashPairIterator" - @ref Qore::HashPairReverseIterator "HashPairReverseIterator" - @ref Qore::ObjectKeyIterator "ObjectKeyIterator" - @ref Qore::ObjectKeyReverseIterator "ObjectKeyReverseIterator" - @ref Qore::ObjectPairIterator "ObjectPairIterator" - @ref Qore::ObjectPairReverseIterator "ObjectPairReverseIterator" - new pseudo-methods: - Qore::zzz8hashzzz9::keyIterator() - Qore::zzz8hashzzz9::pairIterator() - Qore::zzz8hashzzz9::contextIterator() - Qore::zzz8objectzzz9::keyIterator() - Qore::zzz8objectzzz9::pairIterator() - Qore::zzz8nothingzzz9::keyIterator() - Qore::zzz8nothingzzz9::pairIterator() - Qore::zzz8nothingzzz9::contextIterator() - the internal C++ QoreProgramHelper object has been updated to wait until all background threads in the %Qore library have executed before taking the @ref Qore::Program "Program" object out of scope; this allows for callbacks and other code that might be needed by background threads started in user modules (for example) to stay valid until the threads in the user modules also have terminated. Note that this does not affect the case when using @ref exec-class "exec-class" and an application program object goes out of scope with background threads in user modules having non-static method call references as callbacks to the application program; see @ref user_module_program_scope for more information on this topic. @section qore_0861 Qore 0.8.6.1 @par Release Summary Major bug fixes and minor new features @subsection qore_0861_changes Changes in Qore - updated the @ref try-module "try-module" parse directive to support a variant without an exception variable for usage in @ref Qore::Program "Program" objects where @ref Qore::PO_NO_TOP_LEVEL_STATEMENTS is set - added code to raise an @ref invalid-operation warning with the @ref elements "elements operator" when called with a type that can never return a value with this operator - updated the @ref Qore::File "File" class's internal buffer size from 4KB to 16KB which greatly improves read performance - added new public APIs for the QoreNumberNode class to allow for proper de/serialization in external modules - <a href="../../modules/Pop3Client/html/index.html">Pop3Client</a> module: - added the Pop3Client::logPassword() methods and masked password by default in the debug log - updated module to v1.1 - <a href="../../modules/Mime/html/index.html">Mime</a> module: - declared the MultiPartMessage::getMsgAndHeaders() method abstract as originally intended - added MultiPartMessage::parseBody() static method - updated module to v1.3 @subsection qore_0861_bug_fixes Bug Fixes in Qore - fixed crashing bugs due to the lack of proper lvalue checks with the expression for the background operator with operators using lvalues with local variables - fixed rounding of arbitrary-precision numeric values for display purposes when the last significant digit is just to the right of the decimal point (ex: was displaying 10.2 as "11." for example) - fixed a race condition in static destruction of the library when a background thread calls exit() that could cause a segfault on exit - fixed a static memory leak in Program objects when constants contain code references to functions or static methods - fixed a bug parsing user modules; the Program context was not set properly which could lead to a crash when parsing user modules loaded from the command-line or to incorrect parse options when loaded from user Program code - fixed a bug where the @ref invalid-operation warning with the @ref keys "keys operator" was not being triggered in common cases that should have triggered the warning - <a href="../../modules/MailMessage/html/index.html">MailMessage</a> module: - fixed recognizing mime messages with additional text after the version number (ex: \c "Mime-Version: 1.0 (Mac OS X Mail 6.2 \(1499\))") - fixed a bug setting the content-type of message parts (this fix is now in the <a href="../../modules/Mime/html/index.html">Mime</a> in the MultiPartMessage::getMsgAndHeaders() method - fixed multipart message parsing by using MultiPartMessage::parseBody() in the <a href="../../modules/Mime/html/index.html">Mime</a> module; now also parts with subparts are parsed correctly as well - fixed a bug where the sender and from values were not being set properly when parsing email messages - updated module to v1.0.3 @section qore_086 Qore 0.8.6 @par Release Summary Major new features and a few bug fixes @subsection qore_086_compatibility Changes That Can Affect Backwards-Compatibility @par Perl-Style Boolean Evaluation %Qore's default boolean evaluation mode was changed from strict mathematical to a more intuitive perl- (and Python-) like style. This change was implemented to address one of the oldest design bugs in %Qore: strict mathematical boolean evaluation. See @ref perl-bool-eval "perl-bool-eval" for a description of the new default boolean evaluation mode.\n\n To get the old strict mathematical boolean evaluation, use the @ref strict-bool-eval "strict-bool-eval" parse option.\n\n An example of the change; now the following @ref if "if statement" block will be executed as the <tt><b>if</b></tt> expression is now evaluated as @ref True "True": @code{.py} string str = "hello"; if (str) printf("Qore says hello
    "); @endcode Previously (i.e. with @ref strict-bool-eval "strict-bool-eval") the <tt><b>if</b></tt> expression above would be evaluated as @ref False "False" because the string value was converted to an integer 0, however as of %Qore 0.8.6 (with the default @ref perl-bool-eval "perl-bool-eval") it is @ref True "True" since the string is not empty; empty strings and string value \c "0" are evaluated as @ref False "False".\n\n Perhaps counterintuitively (and the reason this was changed to be the default in qore), the chance for regression errors in qore code is very small, because for all cases where the old logic could be applied (meaning excluding cases where the result was always @ref False "False" due to the data types or values being evaluated), the results are the same with the new logic, except for one case; the case where a string has more than one character and begins with a zero (ex: \c "00"). In this case, the old logic would always return @ref False "False", because the value was first converted to an integer \c 0, whereas the new logic will return @ref True "True". Note that in the case of a string with a single \c "0", both the old and new boolean logic returns @ref False "False".\n\n Basically with this option set, qore's boolean evaluation becomes like perl's and Python's, whereas any expression that has the following values is @ref False "False": @ref nothing, @ref string "string" \c "0" and @ref string "empty strings", @ref integer "integer", @ref float "float", and @ref number "number" \c 0 (zero), @ref absolute_dates "absolute date" \c 1970-01-01Z (ie the start of the epoch with an offset of 0), @ref relative_dates "relative date" \c 0s (or any @ref relative_dates "relative date" with a 0 duration), @ref null, @ref binary "empty binary objects", @ref hash "empty hashes", and @ref list "empty lists". All other values are @ref True "True". @note also affects the @ref Qore::boolean(any) "boolean(any)" function @par Changes in the Socket Class The @ref Qore::Socket "Socket" class was enhanced to support timeouts with non-blocking I/O on all send operations; many Socket methods that send data were originally implemented to return an error code on error, however they would also throw exceptions if the socket were not open, so the error handling was inconsistent (exceptions versus return codes).\n\n Additionally it was not possible to get error information at all for SSL errors if the socket was connected with SSL, which, according to %Qore's socket design, should be transparent for the programmer.\n\n For these reasons the implementation was deemed inconsistent and unintuitive; the change was to add optional timeout parameters to all send methods and to allow the methods to throw exceptions (instead of simply returning -1 and not being able to determine the cause of the error in many cases).\n\n The following methods were updated to accept optional timeout parameters and throw exceptions on all errors rather than a return code for I/O errors: - Qore::Socket::send() - Qore::Socket::sendBinary() - Qore::Socket::sendi1() - Qore::Socket::sendi2() - Qore::Socket::sendi4() - Qore::Socket::sendi8() - Qore::Socket::sendi2LSB() - Qore::Socket::sendi4LSB() - Qore::Socket::sendi8LSB() @par New Abstract Method in AbstractIterator The following abstract method was added: - Qore::AbstractIterator::valid() was added (with concrete implementations in all iterator classes derived from this base class delivered with %Qore); this method tells if the object is currently pointing to a valid iterator.\n\n For any user classes inherting @ref Qore::AbstractIterator "AbstractIterator" directly (as opposed to another concrete iterator class in %Qore, where the method has already been added), a concrete implementation of this method will have to be added as well or that class will become @ref abstract with this release of %Qore. @subsection qore_086_new_features New Features in Qore @par Arbitrary-Precision Numeric Support %Qore now uses the <a href="http://www.mpfr.org/">MPFR</a> and <a href="http://gmplib.org">GMP</a> libraries to provide arbitrary-precision numeric support. This type can be used for high-precision mathematics or for storing \c NUMERIC (ie \c DECIMAL or \c NUMBER) column values when retrieved from databases by %Qore DBI drivers that support the new capability @ref Qore::SQL::DBI_CAP_HAS_NUMBER_SUPPORT "DBI_CAP_HAS_NUMBER_SUPPORT" (previously these values would be retrieved as %Qore strings in order to avoid information loss).\n\n For more information, see the new @ref number "number" type, @ref number_type, and @ref Qore::zzz8numberzzz9 @par New CsvUtil Module The <a href="../../modules/CsvUtil/html/index.html">CsvUtil</a> module implements the CsvFileIterator class that allows for easy parsing of csv-like text files @par %%try-module Parse Directive to Handle Module Load Errors at Parse Time The new @ref try-module "try-module" parse directive allows for module load errors to be handled at parse time; ex: @code{.py} %try-module($ex) some-module > 1.0 printf("error loading module y: s: s
    ", ex.arg, ex.err, ex.desc); exit(1); %endtry @endcode @par Abstract Class Hierarchy Improvement As of this version of qore, concrete implementations of @ref abstract "abstract methods" no longer have to have exactly the same return type as the abstract method; it is now sufficient that the return type in the concrete method meets a compatibility test with the return type of the abstract method in the parent class.\n\n For example the following is now valid (and <tt>MyConcreteClass</tt> is not abstract, whereas previously because the return types in the child class were not exact, <tt>MyConcreteClass</tt> would be considered abstract by qore): @code{.py} class MyAbstractClass { abstract any doSomething(); abstract *string getString(); } class MyConcreteClass inherits MyAbstractClass { int doSomething() { return 1; } string getString() { return "hello"; } } @endcode @par DBI Improvements Three new DBI capabilities were implemented, including a new option API as follows: - @ref Qore::SQL::DBI_CAP_HAS_NUMBER_SUPPORT "DBI_CAP_HAS_NUMBER_SUPPORT": DBI drivers declaring this capability can accept @ref number "number" values and can also return @ref number "number" values, if a DBI driver does not declare this capability, then @ref number "number" values sent for binding by value are automatically converted to @ref float "float" values before being sent to the driver - @ref Qore::SQL::DBI_CAP_HAS_OPTION_SUPPORT "DBI_CAP_HAS_OPTION_SUPPORT": this indicates that the driver supports the new option API, allowing options to be set on each connection. See the following for more information: - @ref Qore::SQL::Datasource::constructor() "Datasource::constructor(hash)": now passes options to the DBI driver if the driver supports the option API - @ref Qore::SQL::Datasource::constructor() "Datasource::constructor(string)": (new in 0.8.6) passes options to the DBI driver if the driver supports the option API - @ref Qore::SQL::Datasource::getOption(string) "Datasource::getOption(string)": (new in 0.8.6) returns the value of the given option if the driver supports the option API - @ref Qore::SQL::Datasource::getOptionHash() "Datasource::getOptionHash()": (new in 0.8.6) returns a hash of the current option values for the current connection if the driver supports the option API - @ref Qore::SQL::Datasource::setOption() "Datasource::setOption()": (new in 0.8.6) allows options to be changed after the object is created - @ref Qore::SQL::DatasourcePool::constructor() "DatasourcePool::constructor(hash)": now passes options to the DBI driver if the driver supports the option API - @ref Qore::SQL::DatasourcePool::constructor() "DatasourcePool::constructor(string)": (new in 0.8.6) passes options to the DBI driver if the driver supports the option API - @ref Qore::SQL::DatasourcePool::getOption(string) "DatasourcePool::getOption(string)": (new in 0.8.6) returns the value of the given option if the driver supports the option API - @ref Qore::SQL::DatasourcePool::getOptionHash() "DatasourcePool::getOptionHash()": (new in 0.8.6) returns a hash of the current option values for the current connection if the driver supports the option API - @ref Qore::SQL::dbi_get_driver_options(string) "dbi_get_driver_options(string)": (new in 0.8.6) returns a hash of driver option information without values - @ref Qore::SQL::DBI_CAP_SERVER_TIME_ZONE "DBI_CAP_SERVER_TIME_ZONE": indicates that the DBI driver will convert any bound date/time values to the server's time zone before binding and also will tag date/time values retrieved from the server with the server's time zone. This capability also implies that the driver supports the new \c "timezone" option. @par Socket Improvements The @ref Qore::Socket "Socket" class was updated to support non-blocking I/O on all send methods; the following methods were updated to accept optional timeout parameters: - Qore::Socket::send2() - Qore::Socket::sendBinary2() - Qore::Socket::sendHTTPMessage() - Qore::Socket::sendHTTPResponse() . The following methods were enhanced to provide better error information when throwing exceptions: - Qore::Socket::recvi1() - Qore::Socket::recvi2() - Qore::Socket::recvi4() - Qore::Socket::recvi8() - Qore::Socket::recvi2LSB() - Qore::Socket::recvi4LSB() - Qore::Socket::recvi8LSB() - Qore::Socket::recvu1() - Qore::Socket::recvu2() - Qore::Socket::recvu4() - Qore::Socket::recvu2LSB() - Qore::Socket::recvu4LSB() @par Iterator Improvements The following improvements were made in qore to support more flexible and ubiquitous iterators: - new iterator classes: - @ref Qore::SingleValueIterator "SingleValueIterator": allows single values (or any value without an iterator class) to be iterated; this provides the basis for the return type for the new base Qore::zzz8valuezzz9::iterator() method for non-container types - @ref Qore::FileLineIterator "FileLineIterator": allows files to be iterated line by line - @ref Qore::ObjectIterator "ObjectIterator": a generic iterator for objects - @ref Qore::ObjectReverseIterator "ObjectReverseIterator": a generic reverse iterator for objects - @ref Qore::RangeIterator "RangeIterator": a numerical sequence generator (the basis for the return type for the new @ref Qore::xrange() "xrange()" function - new pseudo-methods were added to return iterator objects based on the value type: - Qore::zzz8valuezzz9::iterator() - Qore::zzz8hashzzz9::iterator() - Qore::zzz8listzzz9::iterator() - Qore::zzz8objectzzz9::iterator() . The base pseudo-method (Qore::zzz8valuezzz9::iterator()) ensures that any value can be iterated, and the type-specific methods ensure that the most suitable iterator for container types is returned for container values; values without an iterator class are iterated with the @ref Qore::SingleValueIterator "SingleValueIterator" - the @ref Qore::HashIterator "HashIterator" and @ref Qore::HashReverseIterator "HashReverseIterator" classes had an additional optional boolean argument added to their constructors; if @ref True "True", then the @ref Qore::HashIterator::getValue() "HashIterator::getValue()" and @ref Qore::HashReverseIterator::getValue() "HashReverseIterator::getValue()" methods return a hash with the following keys: \c "key" and \c "value", allowing for more convenient iteration with constructions that only use \c getValue() methods (such as the @ref foreach "foreach statement"); to accommodate this, two new methods were added to the @ref Qore::HashIterator "HashIterator" base class: - @ref Qore::HashIterator::getKeyValue() - @ref Qore::HashIterator::getValuePair() - all iterator classes had copy methods added to them (ex: @ref Qore::HashIterator::copy()) - new Python-inspired @ref Qore::range() "range()" and @ref Qore::xrange() "xrange()" functions (the latter returning a @ref Qore::RangeIterator "RangeIterator" object to efficiently iterate large integral sequences or ranges @par Text File Parsing Enhancements The following improvements were made in qore to support more flexible file parsing: - the @ref Qore::ReadOnlyFile class was added as a parent class of @ref Qore::File to allow for a more convenient API for reading files (the @ref Qore::File class's API remains the same as it publically inherits @ref Qore::ReadOnlyFile) - the @ref Qore::ReadOnlyFile::readLine() "ReadOnlyFile::readLine()" method (formerlly a method of the @ref Qore::File class) was enhanced to accept 2 optional arguments, allowing the end of line character(s) to be stripped from the line returned, and also to allow the end of line characters to be specified. If no end of line characters are specified, then the method automatically determines the end of line characters (can be \c "
    ", \c "\r", or \c "\r
    "; the last one only if the underlying file is not a TTY in order to avoid stalling I/O on an interactive TTY) - the @ref file_stat_constants were moved from the @ref Qore::File class to the @ref Qore::ReadOnlyFile class - added a new @ref Qore::FileLineIterator "FileLineIterator" iterator class - added a new optional parameter to Qore::zzz8stringzzz9::split(string, string, bool) and Qore::split(string, string, string, bool) to allow for automatic stripping unquoted fields of leading and trailing whitespace (the default is the old behavior; i.e. leave the whitespace as it is read) - added a new @ref Qore::TimeZone "TimeZone" method for parsing string dates in a specific @ref Qore::TimeZone "TimeZone": @ref Qore::TimeZone::date(string, string) - added a new function for parsing text as a boolean value: @ref Qore::parse_boolean() "parse_boolean()" - as mentioned above, the new <a href="../../modules/CsvUtil/html/index.html">CsvUtil</a> module was added, implementing the CsvFileIterator class that allows for easy parsing of csv-like text files @par Other Improvements and Changes - the @ref foreach "foreach statement" now iterates objects derived from @ref Qore::AbstractIterator "AbstractIterator" automatically - added a @ref Qore::Option::HAVE_SYMLINK "HAVE_SYMLINK" constant for the symlink() function added in qore 0.8.5 - added the @ref Qore::SQL::SQLStatement::memberGate() "SQLStatement::memberGate()" method so @ref Qore::SQL::SQLStatement "SQLStatement" objects can be dereferenced directly to a column value when iterated with @ref Qore::SQL::SQLStatement::next() "SQLStatement::next()"; also this method will throw exceptions when an unknown column name is used so that typos in column names can be caught (instead of being silently ignored producing hard to find bugs) - implemented @ref Qore::SQL::Datasource::constructor() "Datasource::constructor(string)" and @ref Qore::SQL::DatasourcePool::constructor() "DatasourcePool::constructor(string)" variants to allow for creating datasources from a string that can be parsed by Qore::SQL::parse_datasource(string) "parse_datasource(string)" - added the following new DBI-related functions: - @ref Qore::SQL::dbi_get_driver_list() "dbi_get_driver_list()" - @ref Qore::SQL::dbi_get_driver_capability_list(string) "dbi_get_driver_capability_list(string)" - @ref Qore::SQL::dbi_get_driver_capabilities(string) "dbi_get_driver_capabilities(string)" - @ref Qore::SQL::dbi_get_driver_options(string) "dbi_get_driver_options(string)" - @ref Qore::SQL::parse_datasource(string) "parse_datasource(string)" - implemented support for \c "A" and \c "a", (hexadecimal floating-point output) \c "G", \c "g", (compact floating-point output) \c "F", (non-scientific floating-point output) and \c "E" and \c "e" (scientific/exponential floating-point output) format arguments for @ref float "floats" and @ref number "numbers" (new arbitrary-precision @ref number "number type values"); see @ref string_formatting - new pseudo-methods: - Qore::zzz8valuezzz9::toString() - Qore::zzz8valuezzz9::toInt() - Qore::zzz8valuezzz9::toFloat() - Qore::zzz8valuezzz9::toBool() - Qore::zzz8floatzzz9::format(string fmt) - Qore::zzz8intzzz9::format(string fmt) - Qore::zzz8stringzzz9::isDataAscii() - Qore::zzz8stringzzz9::isDataPrintableAscii() - Qore::zzz8valuezzz9::callp() - Qore::zzz8callrefzzz9::callp() - Qore::zzz8intzzz9::sign() - Qore::zzz8floatzzz9::sign() - the value of the @ref Qore::SQL::NUMBER "NUMBER", @ref Qore::SQL::NUMERIC "NUMERIC", and @ref Qore::SQL::DECIMAL "DECIMAL" @ref sql_constants is now \c "number" instead of \c "string" (see also @ref sql_binding) - new constants: - @ref Qore::M_PIn "M_PIn" - @ref Qore::MAXINT "MAXINT" - @ref Qore::MININT "MININT" - new functions: - @ref Qore::range() "range()" - @ref Qore::xrange() "xrange()" - new methods: - @ref Qore::ReadOnlyFile::isTty() and @ref Qore::ReadOnlyFile::getFileName() (the @ref Qore::ReadOnlyFile class was added in qore 0.8.6 otherwise made up of methods formerly belonging to the @ref Qore::File class) - added the @ref append-module-path "append-module-path" parse directive - @ref user_modules "user modules" may now use @ref Qore::Program "Program" objects for embedded logic; any @ref Qore::Program "Program" objects created in a @ref user_modules "user module" will have its parse options masked to be not less restrictive than the parse options in the current @ref Qore::Program "Program", and additionally parse options will be locked so that user module are not able to circumvent function restrictions imposed by parse options. - updated docs to show functional restrictions tagged at the class level @subsection qore_086_bug_fixes Bug Fixes in Qore - fixed a bug in the @ref map "map operator" with a select expression when the list operand is @ref nothing; it was returning a list with one @ref nothing element instead of @ref nothing - applied a patch by Reini Urban to allow for multi-arch builds on Debian - fixed bugs calculating the byte offset for string searches in the c++ %QoreString::index() and %QoreString::rindex() functions when the offset is negative and the strings have a multi-byte character encoding (such as UTF-8) - fixed a bug where calling an abstract method from a class where the abstract method is implemented was causing a parse error to be thrown - fixed a bug where the wrong source code location was displayed when raising a parse exception in operator expression parse initialization for some operators - fixed bugs in regexes in the HttpServer::addListeners() and HttpServer::addListenersWithHandler() methods (<a href="../../modules/HttpServer/html/index.html">HttpServer</a> module version updated to 0.3.5) - fixed bugs handling non-blocking reads in the @ref Qore::Socket "Socket" class; the timeout setting was only enforced for the first read; subsequent reads were made as blocking reads - fixed a bug in the @ref Qore::Socket "Socket" class when the SSL session requires renegotiation during non-blocking I/O - @ref Qore::File::constructor() "File::constructor()" now throws an exception if called with a tty target and @ref no-terminal-io "no-terminal-io" is set - fixed a bug in split with quote (Qore::zzz8stringzzz9::split(string, string, bool) and Qore::split(string, string, string, bool)) if the separator pattern was not found and the single field was not quoted either - fixed a bug handling nested @ref ifdef "ifdef" and @ref ifndef "ifndef" blocks with @ref else "else" in the inside block - fixed a crashing due to the failure to clear the "PF_TOP_LEVEL" flag when initializing statements, this could cause temporary variables in a statement to be marked as the start of the global thread-local variable list, and then after such variables are deleted, then a crash happens when trying to access the global thread-local variable list - fixed a crashing bug at parse time merging function lists in namespaces declared multiple times - fixed a bug in executing user module init() closures - fixed a bug where the qore library could crash when destroying a Program object due to a race condition in removing signal handlers managed by the Program object; the Program calls the signal handler manager to remove the signals, but the signals can be removed concurrently to the request while the Program object is iterating the signal set (ie it is modified while being iterated), which causes a crash - added code to detect when the same namespace is declared both with and without the @ref mod_public "public keyword" when defining user modules which can result in entire namespaces being silently not exported (and can be difficult to debug); now a parse exception is thrown if this happens while parsing a user module - added code tags to @ref Qore::File "File" methods without side effects - made many minor documentation fixes @section qore_0851 Qore 0.8.5.1 @par Release Summary Bugfix release @subsection qore_0851_bug_fixes Bug Fixes in Qore - fixed a race condition accessing global and closure-bound thread-local variables in multithreaded contexts - fixed a bug in transaction management with the @ref Qore::SQL::DatasourcePool "DatasourcePool" class when used with the @ref Qore::SQL::SQLStatement "SQLStatement" class - fixed an error in the <a href="../../modules/MailMessage/html/index.html">MailMessage</a> user module where mail headers requiring encoding were not encoded and those not requiring encoding were encoded with Q encoding - fixed an error in the <a href="../../modules/Mime/html/index.html">Mime</a> user module where \c "_" characters in q-encoded headers were not encoded correctly <hr> @section qore_085 Qore 0.8.5 @par Release Summary Major new features and a few bug fixes @subsection qore_085_new_features New Features in Qore @par Abstract Methods and Interfaces %Qore now supports the <b>abstract</b> keyword when declaring methods; an <b>abstract</b> method has no implementation and must be implemented in child classes with the same signature for the child class to be instantiated.\n\n Classes with <b>abstract</b> methods define interfaces; a concrete implementation of the interface is a class that inherits the class with <b>abstract</b> methods and implements all the <b>abstract</b> methods.\n\n Abstract methods are defined with the following syntax: @code{.py} class MyAbstractInterface { abstract string doSomething(int param); abstract bool checkSomething(string arg); } @endcode The following abstract classes now exist in %Qore: - @ref Qore::SQL::AbstractDatasource "AbstractDatasource" - @ref Qore::AbstractIterator "AbstractIterator" - @ref Qore::AbstractQuantifiedIterator "AbstractQuantifiedIterator" - @ref Qore::AbstractBidirectionalIterator "AbstractBidirectionalIterator" - @ref Qore::AbstractQuantifiedBidirectionalIterator "AbstractQuantifiedBidirectionalIterator" - @ref Qore::Thread::AbstractSmartLock "AbstractSmartLock" (which was already present in %Qore but now implements abstract methods) . The following new iterator classes have been added to %Qore: - @ref Qore::HashIterator "HashIterator" - @ref Qore::HashReverseIterator "HashReverseIterator" - @ref Qore::HashListIterator "HashListIterator" - @ref Qore::HashListReverseIterator "HashListReverseIterator" - @ref Qore::ListHashIterator "ListHashIterator" - @ref Qore::ListHashReverseIterator "ListHashReverseIterator" - @ref Qore::ListIterator "ListIterator" - @ref Qore::ListReverseIterator "ListReverseIterator" - @ref Qore::SQL::SQLStatement "SQLStatement" (which was already present in %Qore but now implements the @ref Qore::AbstractIterator "AbstractIterator" interface to allow query results to be iterated) . Classes inheriting @ref Qore::AbstractIterator "AbstractIterator" have special support so that objects can be easily iterated in the following list operators: - @ref map - @ref foldr and @ref foldl - @ref select . @par Universal References All restrictions on references have been removed from %Qore; references to local variables may now be passed to the @ref background "background operator" and passed as arguments to @ref closure "closures".\n\n Basically when a reference is taken of a local variable that could result in the local variable being accessed in a multi-threaded context, the variable is treated as a closure-bound local variable in the sense that it's lifetime is reference-counted, and all accesses are wrapped in a dedicated mutual-exclusion lock to ensure thread safety. @par Pop3Client Module A <a href="../../modules/Pop3Client/html/index.html">Pop3Client</a> module has been added providing an API for communicating with <a href="http://en.wikipedia.org/wiki/Post_Office_Protocol">POP3</a> servers and retrieving email messages.\n\n The module uses functionality provided by the new <a href="../../modules/MailMessage/html/index.html">MailMessage</a> module to represent email messages (and attachment data) downloaded from the server. @par MailMessage Module The <a href="../../modules/MailMessage/html/index.html">MailMessage</a> module provides common functionality to the <a href="../../modules/Pop3Client/html/index.html">Pop3Client</a> and <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a> modules to represent email messages for receiving and sending, respectively. This module was created mostly from functionality removed from the <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a> and enhanced to provide support for reading email messages in the new <a href="../../modules/Pop3Client/html/index.html">Pop3Client</a> module. @par SmtpClient Module Changes The Message and Attachment classes were removed from the <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a> module to the <a href="../../modules/MailMessage/html/index.html">MailMessage</a> module. Backwards-compatible definitions for the Message and Attachment classes are provided in the <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a> module to rexport the removed functionality for backwards compatibility. @par Other Minor Improvements and Changes - qpp updated to support abstract methods and multiple inheritance (+ other minor qpp enhancements) - improved the \c QOREADDRINFO-GETINFO-ERROR exception description by adding information about the arguments passed - added a string argument to @ref Qore::chr(softint, *string) "char(softint, *string)" to accept an output encoding - added a @ref Qore::int(string, int) "int(string, int)" variant to parse a string as a number and give the base - added a new parameter to parse_url() and parseURL() to allow for any [] in the hostname to be included in the \c "host" output key for indicating that the <a href="http://wikipedia.org/wiki/IPv6">ipv6</a> protocol be used - added the following pseudo-methods: - Qore::zzz8valuezzz9::lsize() - Qore::zzz8binaryzzz9::split() - Qore::zzz8binaryzzz9::toMD5() - Qore::zzz8binaryzzz9::toSHA1() - Qore::zzz8binaryzzz9::toSHA224() - Qore::zzz8binaryzzz9::toSHA256() - Qore::zzz8binaryzzz9::toSHA384() - Qore::zzz8binaryzzz9::toSHA512() - Qore::zzz8datezzz9::midnight() - Qore::zzz8listzzz9::first() - Qore::zzz8listzzz9::join() - Qore::zzz8listzzz9::last() - Qore::zzz8listzzz9::lsize() - Qore::zzz8nothingzzz9::lsize() - Qore::zzz8stringzzz9::regex() - Qore::zzz8stringzzz9::regexExtract() - Qore::zzz8stringzzz9::split() - Qore::zzz8stringzzz9::substr() - Qore::zzz8stringzzz9::toMD5() - Qore::zzz8stringzzz9::toSHA1() - Qore::zzz8stringzzz9::toSHA224() - Qore::zzz8stringzzz9::toSHA256() - Qore::zzz8stringzzz9::toSHA384() - Qore::zzz8stringzzz9::toSHA512() - added the <a href="http://code.google.com/p/xxhash/">xxhash FAST algorithm</a> with unordered_map to %Qore on supported platforms resuling in nearly 2x haster hash lookups - added the Qore::File::isOpen() method - added the Qore::call_pseudo() function to explicitly call a pseudo method on a value - added the Qore::symlink() function to create symbolic links - added Qore::TypeCodeMap and Qore::TypeNameMap to lookup type codes from type names and vice versa - added the following functions to allow the time zone to be set per thread: - Qore::set_thread_tz() - Qore::get_thread_tz() @subsection qore_085_bug_fixes Bug Fixes in Qore - fixed format_date() output for \c "MON" and \c "DAY", etc - fixed a memory leak in the parser related to parse exception handling with namespace members - fixed an invalid assert() in module handling when an error occurs loading the module (only affected debug builds) - tagged digest and crypto functions internally as @ref RET_VALUE_ONLY - do not kill TID 1 (the initial / main thread) when calling exit() in background threads as a crash can result with some 3rd party libraries that spawn their own threads on some platforms (observed on Darwin & Solaris 10 at least) - fixed a memory bug in the new builtin function API used by modules built with qpp - fixed memory bugs in the type system where uninitialized type pointers could be used causing a crash - fixed a memory bug in handling "or nothing" types where a non-null pointer would be assumed to be a pointer to the type, however it could actually be a pointer to the NOTHING object, the fix was to ensure that any NOTHING objects in argument lists would be substituted with a null pointer - fixed a bug in parse-time variant matching where an argument with parse-time type "object" would be matched as a perfect match to any parameter with any class restriction; this would cause run-time type errors if another valid class was passed that matched another variant of the method or function - fixed a build bug that caused qore to be built twice <hr> @section qore_084 Qore 0.8.4 @par Release Summary Major new features and changes that can affect backwards-compatibility, plus 40 bug fixes @subsection qore_084_compatibility Changes That Can Affect Backwards-Compatibility @par Namespace Changes %Qore's internal namespace handling was nearly completely rewritten for %Qore 0.8.4. This is because the old code was inefficient and applied namespaces inconsistently to @ref Qore::Program "Program" objects.\n\n The main change that can cause backwards-compatibility issues is that now functions are full namespace members. If no namespace is explicitly given in a function definition, the function is a member of the unnamed root namespace.\n\n Also the distinction between builtin and user functions was removed. Internally, there is only one kind of function object, which can contain both builtin and user function variants (overloaded variants of the same function with the same name but different arguments).\n\n All %Qore builtin functions were moved to the Qore namespace.\n\n Other namespace changes: - loading namespaces provided by builtin modules into a @ref Qore::Program "Program" object is now an atomic operation that may fail, if, for example, objects have already been defined in the target @ref Qore::Program "Program" with the same name as objects provided by the builtin module. Previously this could cause undefined behavior. - namespace lookups are now truly breadth-first as documented; previously the algorithm was depth-first (contrary to the documentation) - namespace lookups are now done (both at parse time and runtime) with the help of symbol lookup tables for fast lookups; tables are maintained for both committed and temporary uncomitted parse symbols; this leads to up to 3x faster parsing for %Qore code - global variables are also now full namespace members, however this does not cause problems with backwards-compatibility @subsection qore_084_new_features New Features in Qore @par User Modules It is now possible to develop user modules in %Qore; several user modules are now included in the %Qore distribution, forming %Qore-language components of %Qore's runtime library.\n\n User modules delivered with %Qore 0.8.4: - <a href="../../modules/HttpServer/html/index.html">HttpServer</a>: a multi-threaded HTTP server implementation - <a href="../../modules/SmtpClient/html/index.html">SmtpClient</a>: an SMTP client library - <a href="../../modules/TelnetClient/html/index.html">TelnetClient</a>: a TELNET client implementation - <a href="../../modules/Mime/html/index.html">Mime</a>: a set of MIME definitions and functions for manipulating MIME data . There are also new example programs for the above modules in the examples/ directory.\n\n User modules are subject to %Qore's functional restriction framework. @par Namespace Changes As listed above:\n - global variables and functions are now full namespace members - all builtin functions are now in the Qore namespace - real depth-first searches are used for namespace symbols - symbols are resolved first in the current namespace when parsing declarations/code in a namespace @par The <b><tt>final</tt></b> Keyword Classes and methods can now be declared "final" to prevent subclassing or overriding in a subclass @par Pseudo Methods Pseudo-methods are class methods that can be implemented on any value; they are also part of class hierarchy. The methods that can be executed on the value depend on the value's type, and all "pseudo-classes" inherit methods from a common base class.\n\n For example: @code{.py} "string".strlen() <abf05da3>.size() 500.typeCode() @endcode Are examples of pseudo-methods on literal values.\n\n Some expensive operations such as getting the first or last key (or value) of a hash are now cheap using pseudo-methods, for example: @code{.py} hash.firstKey() hash.lastValue() @endcode @par New Doxygen-Based Documentation The %Qore reference documentation is now generated by Doxygen, and is generated directly from the %Qore sources. In fact, a new preprocessor known as "qpp" was developed for %Qore 0.8.4 to facilitate and enforce doxygen documentation on %Qore's runtime library (as well as abstract the relatively complex APIs used to bind C++ code to the %Qore runtime library from the C++ programmer).\n\n The documentation is more comprehensive, and corresponds much closer to the actual internal implementation since the documentation is now also contained in and directly generated from the internal C++ implementation of %Qore.\n\n For example, there is the Qore::zzz8valuezzz9::val() method. This method is implemented in the base pseudo class and is reimplemented in other pseudo-classes for other runtime data types as necessary. This method returns @ref True "True" if the value has a value in the same sense as Perl's boolean context evaluation. For example, if the value is a hash with no keys, it returns @ref False "False"; if it is a hash with keys, it returns @ref True "True"; if it is an empty string, it returns @ref False "False"; if it is a non-empty string, it returns @ref True "True", etc. @par LValue Handling Changes lvalue handling was rewritten as the old implementation was ugly and subject to deadlocks (in rare corner cases).\n\n Furthermore, medium-term, an architectural goal of %Qore is to store all ints, floats, and bools internally as the basic C++ type instead of using a class wrapper for each value, which needs dynamic allocation and destruction, which takes up more memory and negatively affects execution speed.\n\n With %Qore 0.8.4, all local and global variables are stored using optimized C++ types when declared with the appropriate type restrictions; for example: @code{.py} int i0; our int i1; @endcode These declares local and global variables that can only be assigned integer values; in %Qore 0.8.4 the value internally will be stored as an "int64" value (and not a dynamically-allocated QoreBigIntNode object).\n\n The same holds for: - @ref int_type "int" - @ref softint_type "softint" - @ref float_type "float" - @ref softfloat_type "softfloat" - @ref bool_type "bool" - @ref softbool_type "softbool" . Note that the optimized lvalue handling has not yet been applied to all lvalues, in particular non-static object members with declared types are not yet implemented with optimized storage; to do this requires a rewrite of %Qore's API and ABI (will happen in the next major release of %Qore).\n\n This change leads to improved integer and floating-point performance and a smaller runtime memory footprint. @par Runtime Optimizations In addition to the up to 3x faster parsing (as decribed in the namespace changes above), %Qore 0.8.4 contains many runtime optimizations designed to reduce the number of dynamic memory allocations performed at runtime.\n\n The optimizations included in this version of %Qore are only a half-measure compared to future changes that will necessitate a new binary %Qore API. @par Per-Thread Initialization the new set_thread_init() function allows a call reference or closure to be set which will be automatically executed when new threads are started (or a new thread accesses a @ref Qore::Program "Program" object) which can be used to transparently initialize thread-local data. @par More Control Over Thread Resource Exceptions new functions: - throw_thread_resource_exceptions_to_mark() - mark_thread_resources() . Allow for only thread resouces created after a certain point to be processed (for example only thread resources left after some embedded code was called) @par New Socket Methods new methods: - Qore::Socket::upgradeClientToSSL() - Qore::Socket::upgradeServerToSSL() . Allow upgrading an already-existing socket connection to SSL @par Better Socket Error Messages More information has been added to socket exceptions to provide better feedback when errors occur. @par New Socket Event Fields - added \c "type" and \c "typename" keys to the @ref EVENT_HOSTNAME_RESOLVED event - added \c "type", \c "typename", and \c "address" keys to the @ref EVENT_CONNECTING event @par Support For Blocking Writes in the Queue Class @ref Qore::Thread::Queue "Queue" objects can now be used as a blocking message channel (similar to a Go channel); if a maximum size is given to the @ref Qore::Thread::Queue "Queue" constructor, then trying to write data to the @ref Qore::Thread::Queue "Queue" when it is full will block until the @ref Qore::Thread::Queue "Queue"'s size goes below the maximum size; optional timeout parameters have been added to @ref Qore::Thread::Queue "Queue" methods that write to the @ref Qore::Thread::Queue "Queue". @par New Queue::clear() Method Does just what you think it does :) @par date(string, string) Improvement added the possibility to specify microseconds when parsing dates against a mask with the date() function @par New Support For ++ And &ndash; Operators With Floating-Point Lvalues previously this would either convert the lvalue to an int or throw an exception if the lvalue could not be converted to an int due to type restrictions @par Class Recognition/Compatibility Between Program Objects The problem is that a user class created from the same source code in two different @ref Qore::Program "Program" objects would be recognized as a different class with parameter and variable type restrictions - ie you could not declare a variable or parameter with a class type restrictions and assign it an object created from the same class source code but created in another @ref Qore::Program "Program" object.\n\n This problem is analogous to a similar problem with java in that classes built from the same source but from different classloaders are also recognized as different classes.\n\n In %Qore 0.8.4 a class signature is created of all public and private objects, and an SHA1 hash is maintained of the class signature, and if the class names and signatures match, then the classes are assumed to be identical, even if they have different internal class IDs (because they were created in different @ref Qore::Program "Program" objects, for example). @par New TimeZone::date(string) Method to support creating arbitrary dates in a given @ref Qore::TimeZone "TimeZone" @par New GetOpt::parse3() method This method will display any errors on @ref Qore::stderr "stderr" and exit the program (which is the most typical way of handling command line errors anyway) @par += Operator Optimization For object += hash this operation is faster in this release @par New Parse Option PO_NO_MODULES Using this option disables module loading @par New Parse Option PO_NO_EMBEDDED_LOGIC Using this option disables all dynamic parsing @par New Parse Directives - @ref assume-global "assume-global": the opposite of @ref assume-local "assume-local" - @ref old-style "old-style": the opposite of @ref new-style "new-style" - @ref require-dollar "require-dollar": the opposite of @ref allow-bare-refs "allow-bare-refs" - @ref push-parse-options "push-parse-options": allows parse options to be saved and restored when the current file is done parsing; very useful for %include files @par New Context Functions - cx_value(): returns the value of the given key - cx_first(): returns @ref True "True" if iterating the first row - cx_last(): returns @ref True "True" if iterating the last row - cx_pos(): returns the current row number (starting from 0) - cx_total(): returns the total number of rows in the set @par SOCKET-HTTP-ERROR Exception Enhancement The invalid header info received is reported in the exception's \c "arg" key @par Improved Parse Error Messages Improved some parse error messages dealing with namespace and class declaration errors @par Added NT_CLOSURE Constant type code for runtime closure values @subsection qore_084_bug_fixes Bug Fixes in Qore - fixed a race condition with @ref Qore::Program "Program" objects when a signal handler is left active and the @ref Qore::Program "Program" terminates - fixed a bug in the @ref Qore::File "File" class where the encoding given in the constructor was ignored; if no encoding was given in the File::open*() method then the @ref Qore::File "File"'s encoding would always be set to the default encoding, now it's set to the encoding given in the constructor (as documented) - runtime checks have been implemented so that references to local variables cannot be passed to a closure; this would cause a runtime crash - a fix has been made to the @ref delete "delete" and @ref remove "remove" operators; lists will not be extended when trying to remove/delete list elements that do not exist - fixed some bugs showing the error location with bugs in the second stage of parsing (symbol resolution) - apply type filters to blocks with a designated return type but no @ref return "return statement" - fixed crashing bugs on some 32bit platforms where size_t was assumed to be 64 bits - fixed a crashing bug parsing invalid @ref requires "requires" directives in the scanner - fixed a bug in usleep() with relative date/time values (added a new usleep() variant to support this) - fixed a typo in the command-line help for the qore binary with unknown parse options - fixed @ref Qore::Option::HAVE_SIGNAL_HANDLING "HAVE_SIGNAL_HANDLING" to be @ref False "False" if signal handling is disabled on platforms where signal handling is otherwise available - fixed a scanner bug parsing out of line class definitions with a root-justified namespace path (ex: \c "class ::X::ClassName ...") - merging code from binary modules at parse time and at runtime is now transaction-safe (before it would cause memory errors and/or a crash), now if errors are detected then an exception is raised and changes are not applied. - fixed a crashing bug in the C++ API function QoreHashNode::setKeyValue() when the value is 0 and an exception occurs or is already active before the call is made - fixed a bug in date parsing with a format string - off by one with integer months - added a regression test for this case - fixed a memory error with the @ref rethrow "rethrow statement" in enclosing but nested try-catch blocks - fixed a crashing bug where qore would try to instantiate a class for a type that did not represent a class (ex: \c "int i();") - fixed a memory leak in the @ref softlist_type "softlist" and @ref softlist_or_nothing_type "*softlist" type implementation - make sure and raise a \c SOCKET-CLOSED error when reading a HTTP header if no data is received - make sure and convert encodings with @ref Qore::index() "index()" and @ref Qore::rindex() "rindex()" functions if the encodings don't match - build fix: only use a lib64 directory if the directory exists already - raise a parse exception in the scanner if a numeric overflow occurs in literal integer values - fixed a bug in @ref Qore::Thread::AbstractSmartLock::lockTID() "AbstractSmartLock::lockTID()" - fixed a major crashing error in the C++ API function QoreStringNode::createAndConvertEncoding(); this function is used by the xml module when parsing XML-RPC sent in a non-UTF-8 character encoding - fixed Qore::File::getchar() to always retrieve 1 character (even for multi-byte character encodings) - fixed string evaluation in a boolean context to return @ref True "True" with floating-point numbers between -1.0 and 1.0 exclusive - printf formatting fix: output YAML-style \c "null" for @ref nothing with %%y - scanner fix: accept \c "\r" as whitespace to allow better parsing of sources with Windows EOL markers
  • fixed parse-time type processing/checks for the keys, + and * operators
  • foreach statement fix: unconditionally evaluate the hash when iterating as otherwise it could change during iteration which could cause a crash
  • fixed another parse-time variant matching bug where the variant-matching algorithm was too aggressive and excluded possible matches at parse time which could result in a false parse-time definitive match even though a better match could be available at runtime
  • fixed a static memory leak when signal handlers are left registered when the qore library terminates
  • fixed static memory leaks and 1 dynamic memory leak in strmul()
  • fixed a crashing bug in handling recursive constant references
  • fixed a bug in the C++ API function HashIterator::deleteKey() when the node's value is NULL
  • fixed time zone/DST calculations for time zone regions with DST with dates before the epoch but after the last DST transition before the epoch
  • fixed a memory error where invalid source expressions referenced in a regular expression substitution expression would cause a crash (ex: 
    str =~ s/public (name)/$2/g
  • fixed a memory error in regular expression substitution where the unconverted string (if not given in UTF-8 encoding) was used when copying source expressions to the target string
  • fixed a bug where a recursive class inheritance tree would cause a crash
  • fixed a bug where a static class method could not access private members of the class