--- str.pod 2002/04/01 09:15:37 1.34
+++ str.pod 2003/01/06 19:13:47 1.35
@@ -1,9 +1,9 @@
##
## OSSP str - String Handling
-## Copyright (c) 1999-2002 Ralf S. Engelschall <rse@engelschall.com>
-## Copyright (c) 1999-2002 The OSSP Project <http://www.ossp.org/>
+## Copyright (c) 1999-2003 Ralf S. Engelschall <rse@engelschall.com>
+## Copyright (c) 1999-2003 The OSSP Project <http://www.ossp.org/>
##
-## This file is part of OSSP str, a string handling and manipulation
+## This file is part of OSSP str, a string handling and manipulation
## library which can be found at http://www.ossp.org/pkg/lib/str/.
##
## Permission to use, copy, modify, and distribute this software for
@@ -177,7 +177,7 @@
This functions searches for the (smaller) string I<t> inside (larger) string
I<s>. If I<n> is not C<0>, the search is performed only inside the first I<n>
-characters of I<s>.
+characters of I<s>.
=item char *B<str_token>(char **I<s>, const char *I<delim>, const char *I<quote>, const char *I<comment>, int I<mode>);
@@ -209,7 +209,7 @@
used to quote another kind. If an unbalanced quote is found, the function
silently act as if one had been placed at the end of the input string. The
I<delim> and I<quote> strings must be disjoint, i.e., they have to share
-no characters.
+no characters.
The I<mode> argument can be used to modify the processing of the string
(default for I<mode> is C<0>): C<STR_STRIPQUOTES> forces I<quote>
@@ -396,12 +396,12 @@
=over 4
-=item B<Matching:> `B<m> I<delim> I<regex> I<delim> I<flags>*':
+=item B<Matching:> `B<m> I<delim> I<regex> I<delim> I<flags>*':
This matches I<s> against the Perl-style regular expression I<regex>
under the control of zero or more I<flags> which control the parsing
semantics. The stripped down I<pop> syntax `I<regex>' is equivalent to
-`B<m/>I<regex>B</>'.
+`B<m/>I<regex>B</>'.
For each grouping pair of parenthesis in I<regex>, the text in I<s>
which was grouped by the parenthesis is extracted into new strings.
@@ -409,7 +409,7 @@
caller through following `B<char **>' arguments. The caller is required
to free(3) them later.
-=item B<Substitution:> `B<s> I<delim> I<regex> I<delim> I<subst> I<delim> I<flags>*':
+=item B<Substitution:> `B<s> I<delim> I<regex> I<delim> I<subst> I<delim> I<flags>*':
This matches I<s> against the Perl-style regular expression I<regex>
under the control of zero or more I<flags> which control the parsing
@@ -688,12 +688,12 @@
char *var = " foo \t " bar 'baz'" q'uu'x #comment";
char *tok, *p;
- p = var;
+ p = var;
while ((tok = str_token(p, ":", "\"'", "#", 0)) != NULL) {
- /* here we enter three times:
+ /* here we enter three times:
1. tok = "foo"
- 2. tok = " bar 'baz'"
- 3. tok = "quux" */
+ 2. tok = " bar 'baz'"
+ 3. tok = "quux" */
...
}
@@ -711,7 +711,7 @@
char *cp, *v1, *v2;
if (str_parse(var, "m/^(.+?):(.+)$/b", &cp, &v1, &v2) > 0) {
...
- /* now we have:
+ /* now we have:
cp = "foo\0bar\0" and v1 and v2 pointing
into it, i.e., v1 = "foo", v2 = "bar" */
...
@@ -738,9 +738,9 @@
char *cp;
int n;
- n = str_format(NULL, 0, "%s|%5s-%x-%04d", v0, v1, v2, v3);
+ n = str_format(NULL, 0, "%s|%5s-%x-%04d", v0, v1, v2, v3);
cp = malloc(n);
- str_format(cp, n, "%s-%x-%04d", v1, v2, v3);
+ str_format(cp, n, "%s-%x-%04d", v1, v2, v3);
/* now we have cp = "abc...| foo-DEAD-0042" */
...
free(cp);
|
