Difference between revisions of "System unit/fr"

From Free Pascal wiki
(Creating and titles translation)
 
(Compilation des unités système)
Line 6: Line 6:
  
 
== Compilation des unités système ==
 
== Compilation des unités système ==
To compile a system unit one calls FPC with the <syntaxhighlight lang="bash" enclose="none">-Us</syntaxhighlight> flag.
+
Pour compiler une unité system, on doit appeler FPC avec le commutateur <syntaxhighlight lang="bash" enclose="none">-Us</syntaxhighlight>.
This will tell the compiler that only basic type definitions are being made, and including a system unit is skipped.
+
Cela indiquera au compilateur que seules les définitions de type de base sont faites et que l'inclusion d'une unité systèm est ignorée
Types such as [[Integer|<syntaxhighlight lang="pascal" enclose="none">integer</syntaxhighlight>]] won't be available.
+
Des types tels que [[Integer/fr|<syntaxhighlight lang="pascal" enclose="none">integer</syntaxhighlight>]] ne seront pas disponibles.
  
 
=== Tâches obligatoire pour l'unité system ===
 
=== Tâches obligatoire pour l'unité system ===
If you attempt to create your own system unit, you'll incrementally notice what the compiler needs or what the generated code expects.
+
Si vous tentez de créer votre propre unité system, vous noterez de manière incrémentale ce dont le compilateur a besoin ou ce qu'attend le code généré.
On a Linux target, the minimal system unit has to contain:
+
Sur une cible Linux, l'unité minimal System doit contenir :  
 
<syntaxhighlight lang="pascal" line start="1">
 
<syntaxhighlight lang="pascal" line start="1">
 
unit system;
 
unit system;
Line 18: Line 18:
 
interface
 
interface
 
</syntaxhighlight>
 
</syntaxhighlight>
The type definition of <syntaxhighlight lang="pascal" enclose="none">hresult</syntaxhighlight>.
+
La définition de type de <syntaxhighlight lang="pascal" enclose="none">hresult</syntaxhighlight>.
 
<syntaxhighlight lang="pascal" line start="5">
 
<syntaxhighlight lang="pascal" line start="5">
 
type
 
type
 
hresult = longint;
 
hresult = longint;
 
</syntaxhighlight>
 
</syntaxhighlight>
The identifier <syntaxhighlight lang="pascal" enclose="none">operatingsystem_result</syntaxhighlight> has to be declared.
+
L'identificateur <syntaxhighlight lang="pascal" enclose="none">operatingsystem_result</syntaxhighlight> doit être déclaré.
The data stored at that position are communicated to the operating system as return value.
+
Les données stockées à cette position sont communiquées au système d'exploitation comme valeur de retour.
Whether <syntaxhighlight lang="pascal" enclose="none">hresult</syntaxhighlight> and <syntaxhighlight lang="pascal" enclose="none">operatingsystem_result</syntaxhighlight> are defined in the <syntaxhighlight lang="pascal" enclose="none">interface</syntaxhighlight> section is irrelevant.
+
 
However, it is very plausible to put those into the <syntaxhighlight lang="pascal" enclose="none">interface</syntaxhighlight> section, so programs using this <syntaxhighlight lang="pascal" enclose="none">system</syntaxhighlight> unit can manipulate those.
+
Que <syntaxhighlight lang="pascal" enclose="none">hresult</syntaxhighlight> et <syntaxhighlight lang="pascal" enclose="none">operatingsystem_result</syntaxhighlight> soient définis dans la section <syntaxhighlight lang="pascal" enclose="none">interface</syntaxhighlight> n'est pas pertinent.  
 +
 
 +
Pourtant, il est très plausible de les mettre dans la section <syntaxhighlight lang="pascal" enclose="none">interface</syntaxhighlight>, ainsi les programmes utilisant cette unité <syntaxhighlight lang="pascal" enclose="none">system</syntaxhighlight> peuvent les manipuler.
 +
 
 
<syntaxhighlight lang="pascal" line start="8">
 
<syntaxhighlight lang="pascal" line start="8">
 
var
 
var
Line 33: Line 36:
 
implementation
 
implementation
 
</syntaxhighlight>
 
</syntaxhighlight>
Here comes to light what the system responsibilities are:
+
Ici la lumière est faite sur ce que sont les responsabilités du système : il doit initialiser (ou devrait initialiser) les unités, ce qui veut dire qu'il appelle chaque [[Initialization/fr|routines d'<syntaxhighlight lang="pascal" enclose="none">initialization</syntaxhighlight>]].
It has to initialize (or should) initialize units, that means call every unit's [[Initialization|<syntaxhighlight lang="pascal" enclose="none">initialization</syntaxhighlight> routines]].
+
Pour cela, l'étiquette <syntaxhighlight lang="pascal" enclose="none">FPC_INITIALIZEUNITS</syntaxhighlight> doit être définie.
For that the label <syntaxhighlight lang="pascal" enclose="none">FPC_INITIALIZEUNITS</syntaxhighlight> has to be defined.
 
 
<syntaxhighlight lang="pascal" line start="13">
 
<syntaxhighlight lang="pascal" line start="13">
 
procedure initializeUnits; alias: 'FPC_INITIALIZEUNITS';  
 
procedure initializeUnits; alias: 'FPC_INITIALIZEUNITS';  
Line 41: Line 43:
 
end;
 
end;
 
</syntaxhighlight>
 
</syntaxhighlight>
Also the label <syntaxhighlight lang="pascal" enclose="none">FPC_DO_EXIT</syntaxhighlight> has to be defined.
+
L'étiquette <syntaxhighlight lang="pascal" enclose="none">FPC_DO_EXIT</syntaxhighlight> doit également être définie. Ici, les programmeurs d'unités system ont la possibilité de finaliser les unités.
Here, system unit programmers have the chance to finalize units.
 
 
<syntaxhighlight lang="pascal" line start="17">
 
<syntaxhighlight lang="pascal" line start="17">
 
procedure doExit; alias: 'FPC_DO_EXIT';
 
procedure doExit; alias: 'FPC_DO_EXIT';
Line 50: Line 51:
 
end.
 
end.
 
</syntaxhighlight>
 
</syntaxhighlight>
 
+
De plus, FPC se plaindra peut-être que l'unité <syntaxhighlight lang="bash" enclose="none">fpintres.pp</syntaxhighlight> était manquante.
Furthermore FPC will possibly complain the unit <syntaxhighlight lang="bash" enclose="none">fpintres.pp</syntaxhighlight> were missing.
+
Créez donc un fichier <syntaxhighlight lang="pascal" enclose="none">fpintres.pas</syntaxhighlight>:
So create a file <syntaxhighlight lang="pascal" enclose="none">fpintres.pas</syntaxhighlight>:
 
 
<syntaxhighlight lang="pascal" line start="1">
 
<syntaxhighlight lang="pascal" line start="1">
 
unit FPIntRes;
 
unit FPIntRes;
Line 60: Line 60:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
After doing so, you can compile your system unit with <syntaxhighlight lang="bash" enclose="none">fpc -Us system.pas</syntaxhighlight>, or directly create an empty program and compile it to examine the impact on the binary's size.
+
Après avoir fait cela, vous pouvez compiler votre unité System avec <syntaxhighlight lang="bash" enclose="none">fpc -Us system.pas</syntaxhighlight>, ou directement  créer un programme vide et le compiler pour examiner l'impact sur la taille du binaire.
On a x86-64 Linux target the executable had a size of 2744 bytes.
+
Sur une cible Linux x86-64, l'exécutable a une taille de 2744 octets.
The big trade-off is no convenience.
+
 
All functionality that can't be “implemented” by the compiler is gone.
+
Le grand compromis n'est pas pratique. Toute la fonctionnalité qui peut être "implémentée" par le compilateur est partie.
 +
 
 
For example {{Doc|package=RTL|unit=system|identifier=addr|text=<syntaxhighlight lang="pascal" enclose="none">addr</syntaxhighlight>}} or {{Doc|package=RTL|unit=system|identifier=ord|text=<syntaxhighlight lang="pascal" enclose="none">ord</syntaxhighlight>}} still work, while {{Doc|package=RTL|unit=system|identifier=sin|text=<syntaxhighlight lang="pascal" enclose="none">sin</syntaxhighlight>}} or {{Doc|package=RTL|unit=system|identifier=random|text=<syntaxhighlight lang="pascal" enclose="none">random</syntaxhighlight>}} are not available.
 
For example {{Doc|package=RTL|unit=system|identifier=addr|text=<syntaxhighlight lang="pascal" enclose="none">addr</syntaxhighlight>}} or {{Doc|package=RTL|unit=system|identifier=ord|text=<syntaxhighlight lang="pascal" enclose="none">ord</syntaxhighlight>}} still work, while {{Doc|package=RTL|unit=system|identifier=sin|text=<syntaxhighlight lang="pascal" enclose="none">sin</syntaxhighlight>}} or {{Doc|package=RTL|unit=system|identifier=random|text=<syntaxhighlight lang="pascal" enclose="none">random</syntaxhighlight>}} are not available.
  

Revision as of 22:20, 2 May 2020

English (en) français (fr)

Dans FPC l'unité system est celle qui est inclue par tout programme.

La bibliothèque d'exécution (RTL) est livrée avec l'unité system où la plupart de ses fonctionnalités, si ce n'est pas toutes, tournent sur chaque plateforme disponible.

Compilation des unités système

Pour compiler une unité system, on doit appeler FPC avec le commutateur -Us. Cela indiquera au compilateur que seules les définitions de type de base sont faites et que l'inclusion d'une unité systèm est ignorée Des types tels que integer ne seront pas disponibles.

Tâches obligatoire pour l'unité system

Si vous tentez de créer votre propre unité system, vous noterez de manière incrémentale ce dont le compilateur a besoin ou ce qu'attend le code généré. Sur une cible Linux, l'unité minimal System doit contenir :

1 unit system;
2 
3 interface

La définition de type de hresult.

5 type
6 	hresult = longint;

L'identificateur operatingsystem_result doit être déclaré. Les données stockées à cette position sont communiquées au système d'exploitation comme valeur de retour.

Que hresult et operatingsystem_result soient définis dans la section interface n'est pas pertinent.

Pourtant, il est très plausible de les mettre dans la section interface, ainsi les programmes utilisant cette unité system peuvent les manipuler.

 8 var
 9 	exitCode: hresult = 0; export name 'operatingsystem_result';
10 
11 implementation

Ici la lumière est faite sur ce que sont les responsabilités du système : il doit initialiser (ou devrait initialiser) les unités, ce qui veut dire qu'il appelle chaque routines d'initialization. Pour cela, l'étiquette FPC_INITIALIZEUNITS doit être définie.

13 procedure initializeUnits; alias: 'FPC_INITIALIZEUNITS'; 
14 begin
15 end;

L'étiquette FPC_DO_EXIT doit également être définie. Ici, les programmeurs d'unités system ont la possibilité de finaliser les unités.

17 procedure doExit; alias: 'FPC_DO_EXIT';
18 begin
19 end;
20 
21 end.

De plus, FPC se plaindra peut-être que l'unité fpintres.pp était manquante. Créez donc un fichier fpintres.pas:

1 unit FPIntRes;
2 interface
3 implementation
4 end.

Après avoir fait cela, vous pouvez compiler votre unité System avec fpc -Us system.pas, ou directement créer un programme vide et le compiler pour examiner l'impact sur la taille du binaire. Sur une cible Linux x86-64, l'exécutable a une taille de 2744 octets.

Le grand compromis n'est pas pratique. Toute la fonctionnalité qui peut être "implémentée" par le compilateur est partie.

For example addr or ord still work, while sin or random are not available.

Note-icon.png

Remarque: Depending on what your program uses, there might other mandatory tasks, too. Especially OOP won't work without a functional objpas unit.

Initialisation et finalisation des unités

For those who are curious, how to implement FPC_INITIALIZEUNITS: FPC puts into every program's data section a INITFINAL table. Compiling a program with the -al flag will retain the assembler file. Examining it you will encounter something like:

33 .section .data.n_INITFINAL
34         .balign 8
35 .globl  INITFINAL
36         .type   INITFINAL,@object
37 INITFINAL:
38         .quad   1,0
39         .quad   INIT$_$SOMEUNIT
40         .quad   FINALIZE$_$SOMEUNIT

For further investigations have a glimpse at an actual implementation helps: rtl/inc/system.inc.

Note-icon.png

Remarque: In general, implementing an “own” system unit is a stupid idea. There is “smartlinking” if size matters.

Remarques comparatives

D'autres compilateurs tels que GNU Pascal (GPC) ou Delphi utilise des constructions similaires, mais à des degrés divers, et l'unité système n'est pas nécessairement nommée system.pp.

Voir aussi