findstr(1)

NAME

findstr − find strings for inclusion in message catalogs

SYNOPSIS

findstr file ...

DESCRIPTION

findstr examines files of C source code for uncommented string constants which it places, along with the surrounding quotes, on the standard output, preceding each by the file name, start position, and length. This information is used by insertmsg (see insertmsg(1)). findstr does not output strings that are parameters of the catgets() routine (see catgets(3C)).

EXTERNAL INFLUENCES

Environment Variables

LC_CTYPE determines the interpretation of comments and string literals as single- and/or multi-byte characters.

LANG determines the language in which messages are displayed.

If LC_CTYPE is not specified in the environment or is set to the empty string, the value of LANG is used as a default for each unspecified or empty variable. If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG. If any internationalization variable contains an invalid setting, findstr behaves as if all internationalization variables are set to "C". See environ(5).

International Code Set Support

Single- and multi-byte character code sets are supported.

WARNINGS

findstr outputs initialization strings of static string variables. Calling insertmsg with these strings causes their replacement with a call to catgets() (see catgets(3C)). Since the initializer must be a string, this assignment results in an invalid C declaration. For example, the following line:

static char *x[] = "message"

is modified by insertmsg (see insertmsg(1)) to:

static char *x[] = (catgets(catd,NL_SETN,1,"""message"""))

These strings should be manually removed from findstr output before being input to insertmsg.

Museum

Related Articles