Delphi RTL

Delphi RTL is a Delphi-compatible RTL and non-visual VCL implementation for the Elements compiler (and more specifically, the Oxygene language).

Goal

The goal of this project is to reproduce a reasonable subset of standard Delphi APIs used by a large percentage of Delphi code bases, in order to facilitate and ease the porting of such code bases to Oxygene to re-use business logic in .NET, Cocoa, Java/Android or Island applications.

The goal is most decidedly not to get existing Delphi projects or applications to just recompile out of the box. The differences between the platforms are too significant, and there is only so much abstraction a library such as this can provide; some changes to exiting code will continue to be required for it to build in Oxygene, and some paradigms need to be rethought to fit in well with the platforms.

Scope

The scope of this project is purposely limited to simple APIs, commonly used low-level helper functions (such as SysUtils.pas) and simple classes (such as TStringList), as well as to make core types such as Object and String more compatible with Delphi code. For some platforms, rudimentary support for VCL forms and .DFMs is provided, as well.

Decidedly out of scope are advanced UI level libraries such as the complete VCL or FMX, Delphi's TDataSet-based database layer, or anything on that level.

Implementation

This library is implemented fully from scratch, without referencing or reusing any of Delphi's or FPCs implementation of the same functionality. Merely the outward-facing API is kept identical and compatible with Delphi's version of the RTL/VCL.

Where possible, the library is targeted to work well for code coming from both older (ca. Delphi 6/7) and more recent Delphi versions; while it does/will support AnsiStrings, it does strongly favor UTF-16 unicode strings (aka WideStrings), as used both by newer Delphi versions and all of Elements' target platforms.

Classes and Types

This library is a work in progress; all functionality presented is useable now, and it will be expanded and grown over time. Contributions on GitHub are more than welcome.

Currently, the following major types are supported/implemented. Unless otherwise noted, all parts of Elements RTL are available across all platforms, including Island.

Classes

Interfaces

Enums

Records

Aliases

  • arrayofT<T> = array of T  Island
  • HResult
    • Int64  .NET, Iodine, Toffee
    • Int64  Island
  • IEnumerable<T>
  • PInterfaceEntry = Pointer
  • PInterfaceTable = Pointer
  • PlatformString
    • String  .NET, Iodine
    • String  Island
    • NSString  Toffee
  • Pointer
    • ^Void  .NET
    • Integer  Iodine
    • ^void  Island, Toffee
  • TArray<T> = array of T  Island
  • TBytes
    • array of Byte  .NET, Iodine, Toffee
    • array of Byte  Island
  • TCharArray
    • array of Char  .NET
    • array of Character  Iodine
    • array of Char  Island
    • array of __ElementsBoxedChar  Toffee
  • TClass = Pointer
  • TCollectionItemClass
    • Type  .NET
    • Type  Iodine, Toffee
    • Type  Island
  • TColor
    • Int32  Island-WebAssembly-wasm32, Island-Windows
    • Int32  Toffee-macOS
  • TCompareOptions = set of TCompareOption
  • TComponentClass
    • Type  Island-WebAssembly-wasm32, Island-Windows
    • id  Toffee-macOS
  • TDate = TDateTime
  • TDateTime
    • Double  .NET, Iodine, Toffee
    • Double  Island
  • TEncoding = Encoding
  • TFontStyles = set of TFontStyle  Island-WebAssembly-wasm32, Island-Windows, Toffee-macOS
  • TGUID = Guid
  • THandle
    • Int64  .NET, Iodine, Toffee
    • Int64  Island
  • TListColumnClass
    • Type  Island-Windows
    • Type  Toffee-macOS
  • TLocaleID = Locale
  • TMarginSize
    • UInt32  Island-WebAssembly-wasm32, Island-Windows
    • UInt32  Toffee-macOS
  • TMessageTable = List<KeyValuePair<UInt32, MethodInfo>>  Island-Windows
  • TObject
    • Object  .NET, Iodine, Toffee
    • Object  Island
  • TPair<T,U> = KeyValuePair<T,U>
  • TReplaceFlags = set of TReplaceFlag
  • TResourceId
    • Object  Island-WebAssembly-wasm32
    • ^void  Island-Windows
    • Object  Toffee-macOS
  • TShiftState = set of TShiftStateValues  Island-WebAssembly-wasm32, Island-Windows, Toffee-macOS
  • TStringsOptions = set of TStringsOption
  • TTime = TDateTime
  • TValueRelationship
    • Int32  .NET, Toffee
    • Integer  Iodine
    • Int32  Island
  • TWidth
    • Int32  Island-Windows
    • Int32  Toffee-macOS
  • TWinControl = TNativeControl  Island-Windows
  • WideString = DelphiString

Extensions

See Also

Version Notes

The Delphi RTL is new as preview in Elements 9.0