--- str.3 2001/04/27 12:22:21 1.33
+++ str.3 2001/08/16 13:17:00 1.34
@@ -1,5 +1,5 @@
-.\" Automatically generated by Pod::Man version 1.02
-.\" Sun Dec 31 12:23:40 2000
+.\" Automatically generated by Pod::Man version 1.15
+.\" Thu Aug 16 15:15:59 2001
.\"
.\" Standard preamble:
.\" ======================================================================
@@ -46,8 +46,8 @@
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
-. ds C` `
-. ds C' '
+. ds C` ""
+. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
@@ -63,7 +63,7 @@
.if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
-. .
+..
. nr % 0
. rr F
.\}
@@ -283,8 +283,10 @@
.Ip "int \fBstr_parse\fR(const char *\fIs\fR, const char *\fIpop\fR, ...);" 4
.IX Item "int str_parse(const char *s, const char *pop, ...);"
This parses the string \fIs\fR according to the parsing operation specified
-by \fIpop\fR. If the parsing operation succeeds, \f(CW\*(C`TRUE\*(C'\fR is returned. Else
-\&\f(CW\*(C`FALSE\*(C'\fR is returned.
+by \fIpop\fR. If the parsing operation succeeds, \f(CW\*(C`1\*(C'\fR is returned. If the
+parsing operation failed because the pattern \fIpop\fR did not match, \f(CW\*(C`0\*(C'\fR
+is returned. If the parsing operation failed because the underlying
+regular expression library failed, \f(CW\*(C`\-1\*(C'\fR is returned.
.Sp
The \fIpop\fR string usually has one of the following two syntax variants:
`\fBm\fR \fIdelim\fR \fIregex\fR \fIdelim\fR \fIflags\fR*' (for matching operations)
@@ -699,7 +701,7 @@
.IX Item "Match a String"
.Vb 5
\& char *var = "foo:bar";
-\& if (str_parse(var, "^.+?:.+$/)) {
+\& if (str_parse(var, "^.+?:.+$/) > 0) {
\& /* var matched */
\& ...
\& }
@@ -709,7 +711,7 @@
.Vb 10
\& char *var = "foo:bar";
\& char *cp, *v1, *v2;
-\& if (str_parse(var, "m/^(.+?):(.+)$/b", &cp, &v1, &v2)) {
+\& if (str_parse(var, "m/^(.+?):(.+)$/b", &cp, &v1, &v2) > 0) {
\& ...
\& /* now we have:
\& cp = "foo\e0bar\e0" and v1 and v2 pointing
@@ -758,11 +760,12 @@
recycled: for the \fIstr_token\fR\|(3) implementation an anchient \fIstrtok\fR\|(3)
flavor from William Deich 1991 was cleaned up and adjusted. As the
background parsing engine for \fIstr_parse\fR\|(3) a heavily stripped down
-version of Philip Hazel's \s-1PCRE\s0 2.08 library was used. The \fIstr_format\fR\|(3)
+version of Philip Hazel's Perl Compatible Regular Expression (\s-1PCRE\s0)
+library (initially version 2.08 and now 3.5) was used. The \fIstr_format\fR\|(3)
implementation was based on Panos Tsirigotis' \fIsprintf\fR\|(3) code as
-adjusted by the Apache Software Foundation 1998. The formatting engine
-was stripped down and enhanced to support internal extensions which were
-required by \fIstr_format\fR\|(3) and \fIstr_parse\fR\|(3).
+adjusted by the Apache Software Foundation (\s-1ASF\s0) 1998. The formatting
+engine was stripped down and enhanced to support internal extensions
+which were required by \fIstr_format\fR\|(3) and \fIstr_parse\fR\|(3).
.SH "AUTHOR"
.IX Header "AUTHOR"
.Vb 3
|
