u4.91.11 Procédure IMPR_CO#

Syntaxe#

Détail de la syntaxe
IMPR_CO(
    ◇ UNITE = unit (défaut: 8),
    ◇ NIVEAU = / -1,
               / 0,
               / 1,
               / 2 (par défaut),
    ◇ ATTRIBUT = / "NON" (par défaut),
                 / "OUI",
    ◇ CONTENU = / "NON",
                / "OUI" (par défaut),
    ◇ BASE = / " ",
             / "G" (par défaut),
             / "V",
             / "L",
    ◆ / CONCEPT = _F(
           ◆ NOM = datastructure,
        ),
      / CHAINE = text,
      / TOUT = "OUI" (ou non renseigné),
    ◇ POSITION = int (défaut: 1),
    # Si: equal_to("NIVEAU", -1)
        ◇ PERMUTATION = / "NON",
                        / "OUI" (par défaut),
)


◆ : obligatoire
◇ : optionnel
⟐ : présent par défaut
& : ensemble
/ : un seul parmi
| : plusieurs choix possibles

Opérandes#

Mot clé facteur CONCEPT#

L'utilisateur indique derrière le mot clé NOM, la liste des concepts qu'il veut imprimer.

Opérande TOUT = “OUI”#

Permet d'imprimer tous les objets présents sur une base (ou sur toutes les bases). Attention, ces impressions peuvent être très volumineuses.

Opérandes CHAINE / POSITION#

/    ♦    CHAINE

L’utilisateur peut donner un texte (entre « quotes ») de longueur inférieure à 24 caractères: la commande imprimera alors tous les objets ayant dans leur nom la chaîne de caractères: chain en position ipos (voir mot clé POSITION).

Exemples:

  1. CHAINE= “TOTO1234” , POSITION= 1

est équivalent à CO= TOTO1234

  1. CHAINE= “.DESC” , POSITION= 20 ,

permet d’imprimer tous les objets dont le nom se termine par “.DESC”.

◊ POSITION= ipos ,

Cet entier précise la position du début de la chaîne à chercher dans le nom des objets existants.

Opérande ATTRIBUT#

◊    ATTRIBUT=

On peut choisir d’imprimer (ou non) les attributs des objets JEVEUX sélectionnés.

Opérande CONTENU#

◊    CONTENU=

On peut choisir d’imprimer (ou non) le contenu des objets sélectionnés.

Opérande BASE#

◊    BASE= base

On n’imprimera que les objets JEVEUX trouvés sur la base base. Si on veut obtenir les objets se trouvant sur l’ensemble des bases (“G” et “V”), on utilisera BASE= “ “ (caractère « blanc »).

Opérande NIVEAU#

◊    NIVEAU=

0: seuls les noms des objets sont imprimés,

1: on n’imprime que les 5 premiers objets de chaque collection d’objets JEVEUX,

2: on imprime tout.

-1: On imprime pour chaque objet une ligne unique contenant :

        • le nom de l’objet

        • quelques caractéristiques : LONMAX, LONUTI, TYPE

        • un nombre (SOMMI ou SOMMR) qui « résume » l’ensemble de l’objet.

Ces impressions permettent par exemple d’aider à comparer 2 versions différentes du code. Pour cela :

          • Ajouter à la fin du fichier de commandes : IMPR_CO(TOUT=”OUI”,NIVEAU=-1)

          • faire « tourner » les 2 versions du code avec ce jeu de commandes

          • faire un « diff » des 2 fichiers résultats produits.

Opérande PERMUTATION#

◊    PERMUTATION=    /    'OUI',        [DEFAUT]

/ “NON”

Ce mot clé ne peut être présent que lorsque NIVEAU = -1. Il permet de faire dépendre les nombres SOMMI ou SOMMR (mentionnés au paragraphe de l’opérande NIVEAU) de l’ordre dans lequel sont rangés les éléments de l’objet.

  • “OUI” : SOMMI ou SOMMR dépendra de cet ordre

  • “NON”: SOMMIou SOMMRne dépendra pas de cet ordre

Opérande UNITE#

◊    UNITE=

Numéro d’unité logique associé au fichier sur lequel doivent être imprimés les objets sélectionnés

Par défaut, l’impression est effectuée sur l’unité qui est associée au fichier fort.8.

Exemples#

Exemple 1

IMPR_CO (CONCEPT= _F(NOM=(ma, mo, ch1 )))

Impression des concepts: ma, mo, ch1. Les attributs des objets ne seront pas écrits.

Exemple 2

IMPR_CO(CHAINE= “&”, POSITION= 1, NIVEAU= 0, BASE= ‘V’, )

Impression des noms des objets de la base volatile commençant par “&”.