<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tokenize</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 25. A collection of standard string functions"><link rel="prev" href="API-isdigit.html" title="function::isdigit"><link rel="next" href="ansi.stp.html" title="Chapter 26. Utility functions for using ansi control chars in logs"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>function::tokenize</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-isdigit.html">Prev</a> </td><th width="60%" align="center">Chapter 25. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="ansi.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tokenize"><a name="API-tokenize"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tokenize — Return the next non-empty token in a string </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting"> tokenize:string(input:string,delim:string) </pre></div><div class="refsect1" title="Arguments"><a name="id594172"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>input</code></em></span></dt><dd><p> string to tokenize. If NULL, returns the next non-empty token in the string passed in the previous call to <code class="function">tokenize</code>. </p></dd><dt><span class="term"><em class="parameter"><code>delim</code></em></span></dt><dd><p> set of characters that delimit the tokens </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="id594223"></a><h2>Description</h2><p> This function returns the next non-empty token in the given input string, where the tokens are delimited by characters in the delim string. If the input string is non-NULL, it returns the first token. If the input string is NULL, it returns the next token in the string passed in the previous call to tokenize. If no delimiter is found, the entire remaining input string is returned. It returns NULL when no more tokens are available. </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-isdigit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ansi.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::isdigit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 26. Utility functions for using ansi control chars in logs</td></tr></table></div></body></html>