summaryrefslogtreecommitdiff
path: root/static/unix-v10/man3/regex.3
blob: d063bca2f41d4e54f1dfe3836267de917a2dbadb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
.TH REGEX 3 deprecated
.SH NAME
re_comp, re_exec \(mi regular expression handler
.SH SYNOPSIS
.nf
.B char *re_comp(s)
.B char *s;
.PP
.B re_exec(s)
.B char *s;
.fi
.SH DESCRIPTION
.I Re_comp
compiles a regular expression into an internal form suitable for
pattern matching.
.I Re_exec
checks the argument string against the last string passed to
.I re_comp.
.PP
.I Re_comp
returns
.L 0
if the string
.I s
was compiled successfully; otherwise a string containing an
error message is returned. If
.I re_comp
is passed
.L 0
or a null string, it returns without changing the currently
compiled regular expression.
.PP
.I Re_exec
returns 1 if the string
.I s
matches the last compiled regular expression,
.L 0
if the string
.I s
failed to match the last compiled regular expression, and
.L -1
if the compiled regular expression was invalid (indicating an
internal error).
.PP
The strings passed to both
.I re_comp
and
.I re_exec
may have trailing or embedded newline characters;
they are terminated by nulls.
The regular expressions are otherwise as described for
.IR ed (1).
.SH "SEE ALSO"
.IR ed (1), 
.IR expr (1), 
.IR regexp (3)
.SH DIAGNOSTICS
.I Re_exec
returns
.L -1
for an internal error.
.SH BUGS
These routines have been superseded by
the more general routines of
.IR regexp (3).
They have been retained only for compatibility.