Formatter.EXE, le formateur en ligne de commande

De RAD Studio
Aller à : navigation, rechercher

Remonter à Utilitaires de ligne de commande - Index


Formatter.exe est le formateur en ligne de commande pour les fichiers de code source de Delphi et C/C++.

Formatter.exe est une application autonome qui ne nécessite pas de DLL de support ou d'autres modules exécutables pour son exécution.

Si un fichier de code source ne peut pas être compilé, les résultats du formatage peuvent alors être incorrects.

Syntaxe de la ligne de commande

Pour afficher l'aide brève, entrez :

Formatter [-h]

Pour exécuter le formateur de code source depuis l'interpréteur de commandes, utilisez la syntaxe de ligne de commande suivante :

Formatter  [<options>] [<nomfichier>...] 

Options de la ligne de commande

Vous pouvez utiliser les options suivantes :

Option Description

-h

Utilisez cette option (ou ne spécifiez pas d'options) pour afficher l'aide brève du formateur en ligne de commande.

-cpp

Formate seulement les fichiers ayant des extensions de noms de fichiers prédéfinis C/C++ (si d'autres extensions ne sont pas spécifiées par les options nomfichier).

Voici les extensions de noms de fichiers prédéfinies C/C++ :
*.cpp, *.cxx, *.cc, *.c, *.hpp, *.hxx, *.hh, *.h.

-delphi

Formate seulement les fichiers ayant des extensions prédéfinies Delphi (si d'autres extensions ne sont pas spécifiées par les options nomfichier).

Voici les extensions de noms de fichiers prédéfinies Delphi :
*.pas, *.dpr, *.dpk, *.dpkw, *.inc.

-config fichierconfig
-config:fichierconfig

fichierconfig -- le nom du fichier de configuration. Les fichiers source seront formatés selon les options de formatage stockées dans fichierconfig.

Les fichiers de configuration peuvent être créés depuis la page Profils et statut de la boîte de dialogue Options (Outils > Options > Formateur > Profils et statut).

Valeurs par défaut utilisées dans fichierconfig :

  • Si fichierconfig ne spécifie pas un nom de fichier, le formateur recherche alors le fichier Formatter.config.
  • Si vous omettez seulement l'extension, l'extension .config est alors acceptée (si nécessaire).
  • Si fichierconfig n'est pas un nom de fichier entièrement qualifié, le formateur recherche alors fichierconfig dans l'ordre suivant :
    1. Dans le répertoire en cours.
    2. Dans le répertoire de travail de RAD Studio, par défaut dans C:\Users\<nom d'utilisateur>\AppData\Roaming\Embarcadero\BDS\21.0.
    3. Dans le répertoire d'installation de RAD Studio, par défaut dans C:\Program Files (x86)\Embarcadero\Studio\21.0.

-e encodage
-e:encodage

encodage définit l'encodage pour la lecture/l'écriture. S'il est omis, le formateur lit alors les sources et essaie de définir automatiquement l'encodage approprié.

-d répertoire
-d:répertoire

répertoire définit le dossier contenant les fichiers à formater. Si nomfichier n'est pas défini, tous les fichiers avec les extensions prédéfinies de Delphi et C/C++ (ou avec les extensions définies par l'option -cpp ou -delphi si spécifiée) du dossier répertoire seront alors formatés.

-r

Formate de façon récursive les fichiers du dossier répertoire et de tous ses sous-répertoires.

-b

Crée des copies des fichiers, avec l'extension .bak ajoutée, avant le formatage.

-log fichierjournal
-log:fichierjournal

fichierjournal définit le nom du fichier journal dans lequel le formateur écrit ses messages. Par défaut, le formateur écrit les messages sur la console.

-silent

N'affiche pas les messages d'erreur.

nomfichier

nomfichier spécifie le nom du fichier source à formater. Le formateur écrit le texte source formaté dans le même fichier.

Vous pouvez spécifier plusieurs nomfichiers séparés par des espaces. Vous pouvez utiliser les caractères génériques '*' et '?'

Si nomfichier utilise des caractères génériques dans l'extension, tous les fichiers avec les extensions prédéfinies de Delphi et C/C++ correspondantes (ou avec les extensions correspondantes à l'option -cpp ou -delphi, si spécifiée) seront alors formatés.

Pour formater un fichier avec une extension qui n'est pas prédéfinie, vous devez spécifier le langage en utilisant l'option -cpp ou -delphi.

Voir aussi