bcpp - En ligne dans le Cloud

PROGRAMME:

Nom

bcpp - faire un embellisseur C++

SYNOPSIS

bcpp [-bcl] [-bnl] [-cc ] [-f ]
[-Fi ] [-fnc ] [-fo ] [-h] [-i
] [-lg] [-NC] [-qb] [-s] [-t] [-tbcl] [-tbnl] [ ] [ ]
[ ]

GÉNÉRAL OPTIONS

-bcl Ouvrir les accolades sur la ligne de code

-bnl Ouvrir les accolades sur la nouvelle ligne

-cc
Colonne pour aligner les commentaires avec le code

-f
Espacement des lignes de fonction

-Fi
Nom du fichier d'entrée

-fnc
Charger le fichier de configuration personnalisé

-fo
Nom du fichier de sortie

-h, -? Afficher le message d'aide

-i
Longueur de l'espace de retrait

-lg Laisser les caractères graphiques

-NC
Colonne pour aligner les commentaires sans code

-qb
Définir la taille du tampon de file d'attente interne

-s Utiliser des espaces dans l'indentation

-t Utiliser des tabulations dans l'indentation

-tbcl Accolades ouvertes de niveau supérieur sur la ligne de code

-tbnl Bretelles ouvertes de haut niveau sur la nouvelle ligne

ACTIVER DÉSACTIVER OPTIONS

Les options commençant par -y ou -n activent/désactivent respectivement les fonctions.

-oui or établi
Ouvrir les accolades sur la ligne de code

-yb or -nb
Fichier d'entrée de sauvegarde avec extension .bac

-ybbi or -nbbi
Indenter les deux accolades d'un bloc

-ybi or -nbi
Retrait de l'accolade de fin de bloc

-ykcwc or -nkcwc
Conserver les commentaires avec le code

-ylcnc or -nlcnc
Laisser des commentaires avec NoCode

-yo or -non
Sortie du programme

-yq or -nq
Changer les caractères non-ASCII entre guillemets en octal

APERÇU

Ce programme permet à un utilisateur de reformater certains éléments d'un code source C ou C++. Cette
aide si le code d'une personne est un peu illisible ou a été indenté dans un style qui
tu n'aimes pas. L'utilisation de ce programme aidera, espérons-le, à remodeler le code afin qu'il
correspond étroitement à votre style. Cependant, en raison des nombreux styles de C(++) qui peuvent être codés,
il y a des limites à la façon dont ce programme va gérer le code source, et le re-
source formatée.

Voici une liste des fonctionnalités mises en œuvre :

- Repositionner les commentaires à certains endroits.

- Supprimer les caractères non imprimables non contenus dans les guillemets.

- Convertissez les caractères non imprimables entre guillemets en notation octale/caractère.

- Ré-espacement des lignes entre les fonctions.

- Coupez les espaces de fin de toutes les lignes, ainsi que les lignes vierges de début et de fin
du fichier.

- Repositionner les accolades ouvrantes au style Kernighan/Ritchie, ou au style Pascal.

- Utilisation de tabulations, ou d'espaces en retrait.

- Indentation du code monoligne, selon certaines instructions de condition C,
y compris les instructions Embedded SQL.

Exigences

Ce programme fonctionnera sous les plates-formes Microsoft DOS V3.3 et Unix.

Il utilise environ 50 à 70 Ko (ou plus, selon la taille de la file d'attente interne) de mémoire
pendant l'exécution.

Le code du programme a été écrit de manière à être compatible avec le C++ existant
compilateurs, cependant le code n'est pas standard ANSI et peut nécessiter une modification pour votre
environnement. Le code source a été écrit avec les fonctions standards ANSI et Posix donc
ce minimum de réécriture devrait être nécessaire en cas de recompilation sur un autre ordinateur
plate-forme.

Les sources actuelles ont été compilées en utilisant Turbo C++ V3.0, pour MS-DOS, GNU G++ 2.7.2
sous Sun SPARCstation exécutant SunOS, Solaris ainsi que les stations de travail SGI exécutant IRIX.

FONCTIONNEMENT

Le fonctionnement du programme se fait via la ligne de commande (CLI), et avec l'aide d'une configuration
fichier, vous pouvez définir vos exigences de format. Fondamentalement, chaque directive de commande commence par
un tiret "-" suivait le nom de la commande. Si un autre paramètre est nécessaire pour la commande, le
le paramètre est ajouté après la commande et séparé par un espace (c'est-à-dire bcpp -fi
entrée.cpp).

NB : N'entrez pas bcpp.exe seul pour trouver son aide sur les commandes, utilisez bcpp -?, ou bcpp -h.
Cela est dû à la redirection d'entrée depuis le système d'exploitation. Conformément à la convention Unix CLI, un
une chaîne qui est lue à partir de la CLI et qui n'a pas de directive de commande est considérée comme une
fichier d'entrée. S'il y a deux occurrences de ce type sur la ligne de commande, la priorité sera
le fichier d'entrée en premier et le fichier de sortie en second (c'est-à-dire bcpp infile.cpp outfile.cpp -lg), un troisième
une telle occurrence générera un message d'erreur.

Si aucun fichier de sortie n'est présenté, sa sortie supposée se fait via la sortie standard. Cette
désactive automatiquement la sortie du programme. Les paramètres entrés sur la ligne de commande seront
remplacer les paramètres qui ont été lus à partir du fichier de configuration.

Mise en situation :
bcpp -fi input.cpp -f 2 -qb 5 -na -no -cc 60 > output.cpp

Synopsis

-fi input.cpp Fichier d'entrée = input.cpp
-f 2 Espacement des fonctions = 2
-qb 2 Tampon de file d'attente interne = 5
-na Supprimer les caractères non ASCII
-no Supprimer la sortie du programme
-cc 60 Commentaires apparaissant sur la même ligne que
le code sera placé dans la colonne 60.
> output.cpp La sortie du programme est redirigée vers
"sortie.cpp"

Un fichier de configuration peut être utilisé pour spécifier la plupart des éléments non modifiables dans
reformatage du code. Le fichier de configuration se compose de quelques mots assez longs qui
sont utilisés pour expliquer le style de sortie du code. Cependant, le réglage de ces paramètres est très
facile, ils se composent essentiellement de deux types, booléens ou entiers. Utilisation de votre favori
éditeur de texte, vous pouvez modifier les éléments suivants dans le fichier de configuration ...

Les paramètres suivants seront contenus dans le fichier de configuration (la valeur par défaut est
bcpp.cfg). Le programme tentera de lire le fichier de configuration par défaut dans le programme
source (c'est-à-dire quel chemin bcpp a été exécuté). En utilisant l'option -fnc, vous pouvez définir un
nom du fichier de configuration et chemin de la CLI.

Plages de type entier : 0 - 5000 Plages de type booléen : Activé, Oui, ou Désactivé, Non

Function_Spacing : Entier
Ce paramètre spécifie combien de lignes séparent deux fonctions.

par exemple :
fonction_espacement = 2

CLI
-f 2

Use_Tabs : booléen
Spécifie s'il faut utiliser des tabulations dans l'indentation du code.

par exemple :
use_tabs = non

CLI
-t (activer les onglets, la valeur par défaut utilise des espaces)
-s (Utiliser les tabulations pour l'indentation)

Indent_Spacing : Entier
Spécifie le nombre d'espaces à mettre en retrait. Ce paramètre définit également la largeur des onglets.
Bcpp considère que la largeur d'une tabulation est la même que la largeur d'un retrait.

EG
retrait_espacement = 4

CLI
-i 4

Comments_With_Code : Entier
Définit la colonne dans laquelle les commentaires qui apparaissent après le code sur une ligne seront
mis.

par exemple :
commentaires_avec_code = 50

CLI
-cc 50

Comments_With_Nocode : Entier
Définit la colonne dans laquelle les commentaires qui apparaissent dans une ligne seront placés.

par exemple :
commentaires_avec_nocode = 0

CLI
-nc 0

Indent_Preprocessor : booléen
Si vrai, bcpp indentera les lignes du préprocesseur à l'indentation du code C(++).
Si faux, les lignes du préprocesseur seront dans la première colonne. Non reconnu (c'est-à-dire,
non standard) les lignes du préprocesseur sont toujours placées dans la première colonne.

Indent_Exec_Sql : booléen
Si vrai, bcpp recherche les instructions Embedded SQL (par exemple, EXEC SQL) et formate
eux spécialement.

Keep_Comments_With_Code : booléen
Cette option remplace l'option "Comments_With_Code". Activer cette option
fera des commentaires qui ne correspondent pas car les commentaires en ligne s'ajouteront au code
de toute façon.

Leave_Comments_NoCode : Booléen
Cette option remplace l'option "Comments_With_Nocode". Activer cette option
mettra en retrait les commentaires qui n'apparaissent pas sur la même ligne que le code au même
indentation en tant que code.

par exemple :
laisser_comments_nocode = sur

CLI
-nlcnc (Désactiver Leave_Comments_NoCode)
-ylcnc (Activer Leave_Comments_NoCode)

NonAscii_Quotes_To_Octal : booléen
Utilisez cette option pour changer les caractères non ASCII (non imprimables) en notation octale si
ils se trouvent entre guillemets. Ce paramètre ne prend effet que si le
Les paramètres Ascii_Chars_Only ou Leave_Graphic_Chars ont été définis.

par exemple :
NonAscii_Quotes_to_Octal = non

CLI
-nq (Désactiver les caractères non ASCII entre guillemets en octal)
-yq (Activer les caractères non ASCII entre guillemets en octal)

Leave_Graphic_Chars : booléen
La définition de ce paramètre sur yes supprimera les caractères non imprimables du
source, mais laissez tous les caractères qui sont des graphiques IBM seuls. Tout non-
les caractères imprimables entre guillemets seront transformés en
notation octale/caractère, si le paramètre NonAscii_Quotes_To_Octal est défini sur True.

EG
laisser_graphic_chars = oui

CLI
-lg

Ascii_Chars_Only : booléen
La définition de ce paramètre sur yes supprimera tous les caractères non imprimables et non ASCII
à partir du fichier d'entrée. Tous les caractères non imprimables entre guillemets seront
transformé en notation octale/caractère si NonAscii_Quotes_To_Octal est défini sur
Vrai. Commentez ce paramètre si vous utilisez le paramètre Leave_Graphic_Chars,
car ce paramètre le remplacera.

par exemple :
ascii_chars_only = oui

CLI
-na (ne pas supprimer les caractères non-ASCII)
-ya (Oui, supprime les caractères non ASCII)

Place_Brace_On_New_Line : Booléen
Lorsqu'il est défini sur 'on', bcpp placera des accolades ouvrantes sur les nouvelles lignes (style "Pascal" C
codage), lorsqu'il est réglé sur « off », bcpp utilisera le codage C de style « K&R ».

Codage C de style Pascal :
si (condition)
{
Déclarations;
}

Codage K&R style C :
si (condition) {
Déclarations;
}

par exemple :
place_brace_on_new_line = sur

CLI
-bnl (sur )
-bcl (désactivé)

Program_Output : Booléen
Ce paramètre arrêtera la sortie du programme en corrompant la sortie qui peut sortir
du programme via la sortie standard. Si ce paramètre est réglé sur off/no
alors aucune sortie n'est générée à partir du programme, sauf si une erreur est rencontrée.
L'erreur standard est utilisée pour afficher les erreurs rencontrées lors du traitement.

PAR EXEMPLE
sortie_programme = désactivé

CLI
-no (la valeur par défaut est de générer une sortie si possible, cela
forcer la sortie)
-yo (activer la sortie du programme si possible)

Queue_Buffer : Entier
Spécifie ce dont la mémoire interne a besoin sera la taille de la ligne
tampon de traitement. Ceci est utilisé pour la relocalisation d'un appareil ouvert à Kernighan/Ritchie
style. L'extension de ce tampon à de grandes quantités de mémoire ralentira le traitement sur
petites machines.

par exemple :
Queue_Buffer = 2

CLI
-qb2

; : N'est pas applicable
Placer un point-virgule devant le texte fait de tout ce qui se trouve après le point-virgule un
commentaire.

Backup_File : Booléen
Cette option sauvegardera le fichier d'entrée dans un fichier avec l'extension ".bac" et
écraser le fichier d'entrée avec la version reformatée.

par exemple :
fichier_de_sauvegarde = oui

CLI
-yb (oui, sauvegarder le fichier d'entrée si possible)
-nb (non, ne sauvegarde pas le fichier d'entrée)

chargement configuration Déposez votre dernière attestation : CLI uniquement

Bcpp implémente un paramètre de configuration pour permettre la sélection de fichiers personnalisés à partir d'un
chemin/fichier défini par un utilisateur.

par exemple :
bcpp input.cpp -yb (lire le fichier de configuration bcpp.cfg
avant de traiter les options CLI)

bcpp -fnc /bin/bcpp.cfg (charger le fichier de configuration à
ledit emplacement)

CLI
-fnc (utiliser défini par l'utilisateur)

Nom du fichier d'entrée : CLI uniquement
Cette option indique à bcpp de lire les données sur un chemin et un nom de fichier donnés.

PAR EXEMPLE
bcpp -fi entrée.cpp > ​​sortie.cpp

CLI
-Fi

Nom du fichier de sortie : CLI uniquement
Cela définit le nom du fichier de sortie dans lequel les données doivent être écrites.

par exemple :
Doit être comme ça (au moins sous DOS) :

bcpp -fo sortie.cpp < entrée.cpp

ClI
-fo

Aide en ligne : CLI uniquement
Une aide en ligne brève mais précise existe dans le programme. Les
help répertorie toutes les commandes CLI disponibles dans le programme.

EG bcpp -h

CLI bcpp-?
bcpp-h

configuration Déposez votre dernière attestation Erreur Mes Messages

Si vous entrez une commande/un paramètre de manière incorrecte dans le fichier de configuration, lors de la
programme exécutable le lisant, le programme générera un message d'erreur avec son
numéro de ligne. Ce qui suit est une explication des messages d'erreur qui peuvent se produire pendant
lecture des paramètres dans le fichier de configuration.

Erreur de syntaxe après le mot clé :
L'erreur se produit parce que le caractère/mot après un paramètre était incorrect, ou
attendu un autre mot clé (par exemple =, Oui, Non, Activé, Désactivé)

Erreur de plage :
L'erreur se produit lorsque les paramètres entiers ont un paramètre numérique non valide (c'est-à-dire, A
nombre n'est pas compris entre 0 et 5000).

Données numériques attendues :
Cette erreur se produit lorsque des données alphanumériques remplacent des données numériques pour un entier
paramètres de type.

Impossible de déchiffrer :
Le paramètre sur ladite ligne n'est pas valide (c'est-à-dire non reconnaissable).

Si des erreurs se sont produites après la lecture du fichier de configuration ; l'utilisateur est invité
avec une invite de continuation [y/n] pour corriger les erreurs de configuration avant
traitement ou continuer avec les paramètres définis en cours.

Courir Temps Erreurs Au cours de Entrée Déposez votre dernière attestation En cours

Échec de l'allocation de mémoire :
Le programme n'a pas pu allouer de mémoire pour traiter les données. Cette erreur s'arrêtera
traitement des données.

Erreur dans la construction de la ligne

Attendu une sorte de code ! Type de données = ? :
Cette erreur est générée dans le processus de construction de la ligne. La ligne décodée
du fichier d'entrée peut être trop indéchiffrable pour ce programme. Trouvez la ligne dans
le fichier d'entrée et voyez s'il peut être modifié afin que le traitement puisse continuer.

C(++) Embellisseur Limites

Cette section met en évidence certaines zones du code où bcpp ne parviendra pas à reconstruire le
le code de sortie dans le style souhaité (bien qu'il puisse toujours être compilé).

- Tout le code qui est alimenté par ce programme doit être dans un état compilable. Cette
signifie qu'il devrait y avoir des accolades fermantes qui annulent les accolades ouvrantes. Bcpp
ne vérifie pas du tout la syntaxe du code, mais le reformate selon open,
accolades fermantes et une poignée de mots clés pour l'indentation d'une seule ligne.

- Il existe également une limitation sur la distance à laquelle le mouvement des accolades ouvertes peut être
traité. Cela est dû à la conception actuelle du programme (cela peut être corrigé facilement
en étendant la taille de la mémoire tampon de la file d'attente interne), les besoins en mémoire, le traitement
la vitesse. L'allocation dynamique de mémoire est largement utilisée dans tout le programme, et
peut dépasser les limites actuelles si certaines conditions se présentent.

L'exemple montre que les mouvements de l'accolade de la nouvelle ligne à la ci-dessus
la ligne de code n'aura pas lieu car cela serait hors de portée du programme si le
Le tampon de file d'attente interne est limité à 2 lignes.

Exemple de portée de mouvement de corset :

si (a == b)
// L'attelle ne sera pas repositionnée
{
b = c ;
}

if (a == b) // L'attelle sera repositionnée
{
b = c ;
}

Résultat final

si (a == b)
// L'attelle ne sera pas repositionnée
{
b = c ;
}

if (a == b){ // L'attelle sera repositionnée
b = c ;
}

- Il existe une contrainte selon laquelle une seule ligne de code ne doit avoir qu'un seul type de
commenter. S'il existe à la fois du C et du C++ sur la même ligne, alors la ligne
phase de construction du programme va devenir confuse et générer une erreur
un message. La ligne suivante produira un message d'erreur de construction de ligne.

Exemple de commentaires multiples.

/* C Commentaire */ a = b; // Commentaire C++

La ligne ci-dessus générera une erreur. Remédiez à cela en supprimant un type de
commentez, combinez-les ou placez-en un sur une nouvelle ligne.

AUTEURS

Écrit par Steven De Toni Décembre 1995
Mis à jour par Thomas Dickey Janvier 1997-2002

Vous pouvez contacter Steven De Toni via différents réseaux en ligne :

Adresse Internet
[email protected]
[email protected]

Net Mail via Fido-Net (Dog Net)
Steven De Toni,
"La grande évasion",
Hamilton,
New Zealand

Réseau postal national de Demi-Monde Nouvelle-Zélande
(voir Filet pour chien)

Si tout le reste échoue, envoyez un courrier postal à :

17 avenue Garden Heights,
Melville,
Hamilton,
New Zealand

Thomas Dickey est joignable au

[email protected]

Un merci spécial à Glyn Webster pour la relecture de mon manuel et le test de mon
.

Merci à Justin Slootsky pour sa contribution et les modifications apportées à cette version.

Tous grammatical les erreurs dans ce document sont là pour votre plaisir. ;-)

AVIS DE NON-RESPONSABILITE

Les auteurs ne donnent aucune garantie que ce programme fonctionnera selon les spécifications données
via la configuration, ou la sortie reconstruite du programme du code source qui a été
traité. Tout dommage pouvant résulter de l'utilisation de ce programme (qu'il s'agisse d'un logiciel ou
hardware) est le problème de l'utilisateur, et non des auteurs. L'utilisation de ce logiciel vous oblige à
cette clause de non-responsabilité.=

Embellisseur C++()

Utilisez bcpp en ligne en utilisant les services onworks.net