doc/pstrresplit.3.html

   1 <html>
   2 <head>
   3 <meta name="generator" content="groff -Thtml, see www.gnu.org">
   4 <meta name="Content-Style" content="text/css">
   5 <title>pstrsplit</title>
   6 </head>
   7 <body>
   8
   9 <h1 align=center>pstrsplit</h1>
  10 <a href="#NAME">NAME</a><br>
  11 <a href="#SYNOPSIS">SYNOPSIS</a><br>
  12 <a href="#DESCRIPTION">DESCRIPTION</a><br>
  13 <a href="#AUTHOR">AUTHOR</a><br>
  14 <a href="#LICENSE">LICENSE</a><br>
  15 <a href="#VERSION">VERSION</a><br>
  16
  17 <hr>
  18 <!-- Creator     : groff version 1.17.2 -->
  19 <!-- CreationDate: Fri May  3 14:57:56 2002 -->
  20 <a name="NAME"></a>
  21 <h2>NAME</h2>
  22 <table width="100%" border=0 rules="none" frame="void"
  23        cols="2" cellspacing="0" cellpadding="0">
  24 <tr valign="top" align="left">
  25 <td width="10%"></td><td width="90%">
  26 pstrsplit, pstrcsplit, pstrresplit - split a string on a character, string or regexp.</td></table>
  27 <a name="SYNOPSIS"></a>
  28 <h2>SYNOPSIS</h2>
  29
  30 <table width="100%" border=0 rules="none" frame="void"
  31        cols="2" cellspacing="0" cellpadding="0">
  32 <tr valign="top" align="left">
  33 <td width="10%"></td><td width="90%">
  34 <pre><b>#include &lt;pstring.h&gt;
  35
  36 vector pstrsplit (pool, const char *str, const char *sep);
  37 vector pstrcsplit (pool, const char *str, char c);
  38 vector pstrresplit (pool, const char *str, const regex_t *re);
  39 </b></pre></td></table>
  40 <a name="DESCRIPTION"></a>
  41 <h2>DESCRIPTION</h2>
  42
  43 <table width="100%" border=0 rules="none" frame="void"
  44        cols="2" cellspacing="0" cellpadding="0">
  45 <tr valign="top" align="left">
  46 <td width="10%"></td><td width="90%">
  47 These functions split string <b>str</b> on either a string
  48 <b>sep</b>, a character <b>c</b> or a regular expression
  49 <b>re</b>.</td></table>
  50
  51 <table width="100%" border=0 rules="none" frame="void"
  52        cols="2" cellspacing="0" cellpadding="0">
  53 <tr valign="top" align="left">
  54 <td width="10%"></td><td width="90%">
  55 The result is a vector of newly created
  56 substrings.</td></table>
  57
  58 <table width="100%" border=0 rules="none" frame="void"
  59        cols="2" cellspacing="0" cellpadding="0">
  60 <tr valign="top" align="left">
  61 <td width="10%"></td><td width="90%">
  62 Perl's <b>split</b> function treats zero-length strings
  63 differently from other strings -- returning an empty vector
  64 (rather than returning a vector containing a single
  65 zero-length string which is what you might expect, and is
  66 slightly more orthogonal). The author has not decided what
  67 the correct behaviour should be, so treat this case as
  68 undefined in the current release.</td></table>
  69 <a name="AUTHOR"></a>
  70 <h2>AUTHOR</h2>
  71
  72 <table width="100%" border=0 rules="none" frame="void"
  73        cols="2" cellspacing="0" cellpadding="0">
  74 <tr valign="top" align="left">
  75 <td width="10%"></td><td width="90%">
  76 Richard Jones &lt;rich@annexia.org&gt;</td></table>
  77 <a name="LICENSE"></a>
  78 <h2>LICENSE</h2>
  79
  80 <table width="100%" border=0 rules="none" frame="void"
  81        cols="2" cellspacing="0" cellpadding="0">
  82 <tr valign="top" align="left">
  83 <td width="10%"></td><td width="90%">
  84 GNU LGPL (see http://www.gnu.org/)</td></table>
  85 <a name="VERSION"></a>
  86 <h2>VERSION</h2>
  87
  88 <table width="100%" border=0 rules="none" frame="void"
  89        cols="2" cellspacing="0" cellpadding="0">
  90 <tr valign="top" align="left">
  91 <td width="10%"></td><td width="90%">
  92 c2lib-1.2.13</td></table>
  93 <hr>
  94 </body>
  95 </html>