Return to regex.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / gen

Annotation of 43BSDReno/lib/libc/gen/regex.3, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)regex.3     6.2 (Berkeley) 5/19/88
                      6: .\"
                      7: .TH REGEX 3 "May 19, 1988"
                      8: .UC
                      9: .SH NAME
                     10: re_comp, re_exec \- regular expression handler
                     11: .SH SYNOPSIS
                     12: .B char *re_comp(s)
                     13: .br
                     14: .B char *s;
                     15: .PP
                     16: .B re_exec(s)
                     17: .br
                     18: .B char *s;
                     19: .SH DESCRIPTION
                     20: .I Re_comp
                     21: compiles a string into an internal form suitable for pattern matching. 
                     22: .I Re_exec 
                     23: checks the argument string against the last string passed to
                     24: .I re_comp.
                     25: .PP
                     26: .I Re_comp
                     27: returns 0 if the string
                     28: .I s
                     29: was compiled successfully; otherwise a string containing an
                     30: error message is returned. If 
                     31: .I re_comp
                     32: is passed 0 or a null string, it returns without changing the currently
                     33: compiled regular expression.
                     34: .PP
                     35: .I Re_exec
                     36: returns 1 if the string
                     37: .I s
                     38: matches the last compiled regular expression, 0 if the string
                     39: .I s
                     40: failed to match the last compiled regular expression, and \-1 if the compiled
                     41: regular expression was invalid (indicating an internal error).
                     42: .PP
                     43: The strings passed to both
                     44: .I re_comp
                     45: and
                     46: .I re_exec
                     47: may have trailing or embedded newline characters; 
                     48: they are terminated by nulls.
                     49: The regular expressions recognized are described in the manual entry for 
                     50: .IR ed (1),
                     51: given the above difference.
                     52: .SH "SEE ALSO"
                     53: ed(1), ex(1), egrep(1), fgrep(1), grep(1), regexp(3)
                     54: .SH DIAGNOSTICS
                     55: .I Re_exec
                     56: returns \-1 for an internal error.
                     57: .PP
                     58: .I Re_comp
                     59: returns one of the following strings if an error occurs:
                     60: .PP
                     61: .nf
                     62: .in +0.5i
                     63: \fINo previous regular expression,
                     64: Regular expression too long,
                     65: unmatched \e(,
                     66: missing ],
                     67: too many \e(\e) pairs,
                     68: unmatched \e).\fP
                     69: .in -0.5i
                     70: .fi

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.