Return to pcresample.3 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / pcre / doc

Annotation of embedaddon/pcre/doc/pcresample.3, revision 1.1

1.1     ! misho       1: .TH PCRESAMPLE 3
        !             2: .SH NAME
        !             3: PCRE - Perl-compatible regular expressions
        !             4: .SH "PCRE SAMPLE PROGRAM"
        !             5: .rs
        !             6: .sp
        !             7: A simple, complete demonstration program, to get you started with using PCRE,
        !             8: is supplied in the file \fIpcredemo.c\fP in the PCRE distribution. A listing of
        !             9: this program is given in the
        !            10: .\" HREF
        !            11: \fBpcredemo\fP
        !            12: .\"
        !            13: documentation. If you do not have a copy of the PCRE distribution, you can save
        !            14: this listing to re-create \fIpcredemo.c\fP.
        !            15: .P
        !            16: The program compiles the regular expression that is its first argument, and
        !            17: matches it against the subject string in its second argument. No PCRE options
        !            18: are set, and default character tables are used. If matching succeeds, the
        !            19: program outputs the portion of the subject that matched, together with the
        !            20: contents of any captured substrings.
        !            21: .P
        !            22: If the -g option is given on the command line, the program then goes on to
        !            23: check for further matches of the same regular expression in the same subject
        !            24: string. The logic is a little bit tricky because of the possibility of matching
        !            25: an empty string. Comments in the code explain what is going on.
        !            26: .P
        !            27: If PCRE is installed in the standard include and library directories for your
        !            28: operating system, you should be able to compile the demonstration program using
        !            29: this command:
        !            30: .sp
        !            31:   gcc -o pcredemo pcredemo.c -lpcre
        !            32: .sp
        !            33: If PCRE is installed elsewhere, you may need to add additional options to the
        !            34: command line. For example, on a Unix-like system that has PCRE installed in
        !            35: \fI/usr/local\fP, you can compile the demonstration program using a command
        !            36: like this:
        !            37: .sp
        !            38: .\" JOINSH
        !            39:   gcc -o pcredemo -I/usr/local/include pcredemo.c \e
        !            40:       -L/usr/local/lib -lpcre
        !            41: .sp
        !            42: In a Windows environment, if you want to statically link the program against a
        !            43: non-dll \fBpcre.a\fP file, you must uncomment the line that defines PCRE_STATIC
        !            44: before including \fBpcre.h\fP, because otherwise the \fBpcre_malloc()\fP and
        !            45: \fBpcre_free()\fP exported functions will be declared
        !            46: \fB__declspec(dllimport)\fP, with unwanted results.
        !            47: .P
        !            48: Once you have compiled and linked the demonstration program, you can run simple
        !            49: tests like this:
        !            50: .sp
        !            51:   ./pcredemo 'cat|dog' 'the cat sat on the mat'
        !            52:   ./pcredemo -g 'cat|dog' 'the dog sat on the cat'
        !            53: .sp
        !            54: Note that there is a much more comprehensive test program, called
        !            55: .\" HREF
        !            56: \fBpcretest\fP,
        !            57: .\"
        !            58: which supports many more facilities for testing regular expressions and the
        !            59: PCRE library. The
        !            60: .\" HREF
        !            61: \fBpcredemo\fP
        !            62: .\"
        !            63: program is provided as a simple coding example.
        !            64: .P
        !            65: If you try to run
        !            66: .\" HREF
        !            67: \fBpcredemo\fP
        !            68: .\"
        !            69: when PCRE is not installed in the standard library directory, you may get an
        !            70: error like this on some operating systems (e.g. Solaris):
        !            71: .sp
        !            72:   ld.so.1: a.out: fatal: libpcre.so.0: open failed: No such file or directory
        !            73: .sp
        !            74: This is caused by the way shared library support works on those systems. You
        !            75: need to add
        !            76: .sp
        !            77:   -R/usr/local/lib
        !            78: .sp
        !            79: (for example) to the compile command to get round this problem.
        !            80: .
        !            81: .
        !            82: .SH AUTHOR
        !            83: .rs
        !            84: .sp
        !            85: .nf
        !            86: Philip Hazel
        !            87: University Computing Service
        !            88: Cambridge CB2 3QH, England.
        !            89: .fi
        !            90: .
        !            91: .
        !            92: .SH REVISION
        !            93: .rs
        !            94: .sp
        !            95: .nf
        !            96: Last updated: 17 November 2010
        !            97: Copyright (c) 1997-2010 University of Cambridge.
        !            98: .fi