exstr

exstr

 [

options

] 

file

Extract strings from C source files, so that they can be stored in a database and retrieved at application run-time using the gettxt system call. With no options, exstr produces a grep -type list showing only filename and strings. exstr is one of several commands to use when customizing applications for international use.

Typical use involves three steps:

1. Specify -e and the C source file, and redirect the output to a file. This creates a database of text strings and identifying information.

2. Edit this database by adding information that was previously returned by the mkmsgs command.

3. Specify -r and the C source file, using the edited database as input. This replaces hardcoded text strings with calls to gettxt . gettxt lets you access translated versions of text strings. (The strings reside in a directory specified by environment variable LC_MESSAGES.)

Options

-e

Extract text strings from file . ( -e is not used with other options.) The information appears in this format:

file : line : field : msg_file : msg_num : string

file	C source file from the command-line.
line	Line number on which the string is found in file
field	In-line numerical position of the string's beginning.
msg_file	Initially null, but later filled in when you edit the database. msg_file is the name of the list of message strings that you create by running the mkmsgs command.
msg_num	Initially null but filled in later. It corresponds to the order of the strings in msg_file .

-r

Replace strings in the source file with calls to gettxt .

-d

Use with -r to give the gettxt call a second argument, the original text string. This string will be printed as the fallback in case the gettxt call fails.

Example

Assume a C source file named proverbs.c :

main() {
     printf("Haste makes waste\n"); 
     printf("A stitch in time\n"); 
}

1. First issue the command:

   % 
   
   exstr -e proverbs.c > proverb.list
   
   

   proverb.list might look something like this:

   proverbs.c:3:8:::Haste makes waste\n 
   proverbs.c:4:8:::A stitch in time\n

2. Run mkmsgs to create a message file (e.g., prov.US ) that can be read by the gettxt call. If the two proverbs strings above are listed ninth and tenth in prov.US , then you would edit proverb.list as follows:

   proverbs.c:3:8:prov.US:9:Haste makes waste\n 
   proverbs.c:4:8:prov.US:10:A stitch in time\n

3. Finally, specify -r to insert gettxt calls:

   % 
   
   exstr -rd proverbs.c < proverb.list > Prov.c
   
   

   The international version of your program, Prov.c , now looks like this:

   extern char *gettxt();
   main() {
     printf(gettxt("prov.US:9", "Haste makes\
         waste\n")); 
     printf(gettxt("prov.US:10", "A\
         stitch in time\n")); 
   }