xstr(1)                 (BSD Compatibility Package)                 xstr(1)

NAME
     xstr - Zeichenketten aus C-Programmen zur Implementierung gemeinsam
     verwendeter Zeichenketten extrahieren

SYNTAX
     /usr/ucb/xstr [-v] [-c] [-l name] [file]

BESCHREIBUNG
     xstr verwaltet eine Datei strings, in die Zeichenketten aus einzelnen
     Komponenten eines umfangreichen Programms gestellt werden. Die Zei-
     chenketten werden durch Verweise auf diesen allgemeinen Bereich
     ersetzt. Dies dient der Implementierung gemeinsam verwendeter, Zei-
     chenketten-Konstanten.

     Das Kommando

          xstr -c file

     extrahiert die Zeichenketten aus dem C-Quellprogramm in file und
     ersetzt dabei Verweise auf Zeichenketten durch Ausdrücke des Formats
     (&xstr[number]). Eine Deklaration von xstr wird der Datei vorange-
     stellt. Der C-Quellcode wird in die Datei x.c gestellt, die dann kom-
     piliert werden muß. Die Zeichenketten aus der Datei file werden in die
     strings-Datei aufgenommen, wenn sie dort noch nicht vorliegen. Wiede-
     rholt auftretende Zeichenketten und solche, bei denen es sich um Suf-
     fixe bereits vorhandener Zeichenketten handelt, haben keine Änderungen
     der Datei zur Folge.

     Nachdem alle Komponenten eines umfangreichen Programms kompiliert wor-
     den sind, kann mit dem Kommando

          xstr

     eine Datei xs.c erstellt werden, die den allgemeinen xstr-Array defi-
     niert. Diese Datei xs.c sollte anschließend kompiliert und mit dem
     Rest des Programms gebunden werden.

     xstr ändert die Datei strings nicht, außer wenn neue Einträge hinzuge-
     fügt werden. Auf diese Weise kann bei make verhindert werden, daß xs.o
     neu erstellt wird, sofern dies nicht wirklich erforderlich ist.

     xstr kann auch für eine einzelne Datei verwendet werden. Mit dem Kom-
     mando

          xstr file

     werden die Dateien x.c und xs.c wie zuvor erstellt, ohne daß dabei
     eine strings-Datei im selben Verzeichnis verwendet bzw. geändert wird.







Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

xstr(1)                 (BSD Compatibility Package)                 xstr(1)

     xstr sollte nach dem C-Präprozessor ausgeführt werden, wenn Makrodefi-
     nitionen Zeichenketten zulassen oder wenn in bedingtem Code Zeichen-
     ketten enthalten sind. xstr liest von der Standard-Eingabe, wenn das
     Argument "-" statt file angegeben wird. Eine entsprechende Kommando-
     folge für die Ausführung von xstr nach dem Präprozessor lautet:

          cc -E name.c | xstr -c -
          cc -c x.c
          mv x.o name.o

OPTIONEN
     -v        (verbose) Die Veränderungen der strings-Datei werden nach
               Standard-Fehlerausgabe protokolliert.

     -c        Behandlung einzelner Quelldateien eines umfangreichen Pro-
               gramms (ähnlich: cc -c file).

     -l name   Statt xstr trägt der Array den Namen name in x.c und xs.c.

HINWEISE
     Handelt es sich bei einer Zeichenkette um ein Suffix einer anderen
     Zeichenkette in der Zeichenketten-Datei und wird die kürzere Zeichen-
     kette von xstr zuerst gefunden, werden beide Zeichenketten in die
     Zeichenketten-Datei gestellt, obwohl die längere ausreichen würde.

DATEIEN
     strings   Zeichenketten-Datei

     x.c       Manipulierte C-Quelle

     xs.c      C-Quellprogramm für die Definition des Arrays xstr

SIEHE AUCH
     cc(1-ucb).




















Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98