findstr(CP)                    6 January 1993                    findstr(CP)


 Name

    findstr - find strings in C source code

 Syntax

    findstr [-b] file ...

    findstr [-b] -p [cppoption] file ...

 Description

    findstr examines files of C source code for string constants, which are
    written on standard output (one per line in the form of a string list):

       filename pos len "...message text..."

    where filename is the name of the C source file, pos is the character
    position of the message within the source file and len is the message
    length in bytes.

    findstr(CP) assumes a syntactically correct C preprocessed source input
    file.

    In the case of C preprocess request (that is, with the -p option), a
    preprocessed, .i-suffixed file is first created in the C source file
    directory before the the string list is generated.

    findstr recognizes the following options:

    -b  Source file directory name truncation within the string file.

    -p cppoption
        Preprocess source file before performing find. Arguments following -p
        are interpreted as cpp(CP) options.

 Return values


    0  on success

    1  on failure

 Notes

    The output from findstr(CP) is normally used by insertmsg(CP) to create a
    new source file with message catalogue information.

 See also

    gencat(CP), insertmsg(CP)