Difference between revisions of "sysutils"

From Free Pascal wiki
Jump to navigationJump to search
(Add page template and remove categories (defined in the template))
(expand)
Line 1: Line 1:
 
{{sysutils}}
 
{{sysutils}}
  
'''SysUtils''' is a basic library containing various system utilities
+
The [[Unit|unit]] '''<syntaxhighlight lang="pascal" inline>sysUtils</syntaxhighlight>''' shipped with the [[FPC|FPC’s]] default [[RTL|run-time library]] provides a plethora of system utilities.
 +
It attempts to be as compatible to [[Delphi|Delphi’s]] <syntaxhighlight lang="pascal" inline>sysUtils</syntaxhighlight> unit as possible.
 +
However, the FPC version is available on [[Platform list|all platforms the FPC supports]].
 +
You will not find any Windows-related routines or other highly platform-specific functionality.
  
 +
== notable functionality ==
 +
* [[Format function|<syntaxhighlight lang="pascal" inline>format</syntaxhighlight>]]
 +
* {{Doc|package=RTL|unit=sysutils|identifier=typehelpers|text=type helpers for all basic data types}}
  
For details see: [http://www.freepascal.org/docs-html/rtl/sysutils/index.html freepascal.org sysutils]
+
== caveats ==
 +
{{Doc|package=RTL|unit=system|identifier=runtimeerrors|text=If the <syntaxhighlight lang="pascal" inline>sysUtils</syntaxhighlight> unit is included}}, all [[runtime error|run-time errors]] become [[Exceptions|exceptions]], thus virtually forcing you to use a [[Compiler Mode|compiler mode]] (or [[modeswitch|mode switch]]) that allows exception treatment.
 +
You will need to include <syntaxhighlight lang="pascal" inline>sysUtils</syntaxhighlight> in every unit that may throw an exception just to familiarize with the exception classes, even though the unit itself does not use any actual code of it.
 +
 
 +
== see also ==
 +
* {{Doc|package=RTL|unit=sysutils|text=<syntaxhighlight lang="pascal" inline>sysUtils</syntaxhighlight> reference}}
 +
* [http://docwiki.embarcadero.com/Libraries/Sydney/en/System.SysUtils Delphi’s <syntaxhighlight lang="pascal" inline>sysUtils</syntaxhighlight> unit]
 +
* [[libc|<syntaxhighlight lang="pascal" inline>libc</syntaxhighlight>]] <!-- similar in design -->
 +
* [[System unit|<syntaxhighlight lang="pascal" inline>system</syntaxhighlight> unit]]

Revision as of 17:33, 22 January 2021

English (en) Esperanto (eo) français (fr)

The unit sysUtils shipped with the FPC’s default run-time library provides a plethora of system utilities. It attempts to be as compatible to Delphi’s sysUtils unit as possible. However, the FPC version is available on all platforms the FPC supports. You will not find any Windows-related routines or other highly platform-specific functionality.

notable functionality

caveats

If the sysUtils unit is included, all run-time errors become exceptions, thus virtually forcing you to use a compiler mode (or mode switch) that allows exception treatment. You will need to include sysUtils in every unit that may throw an exception just to familiarize with the exception classes, even though the unit itself does not use any actual code of it.

see also