<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>sc68fordevelopers: /home/mandrake/rpm/BUILD/sc68-2.2.1/file68/string68.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css">
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.9 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>/home/mandrake/rpm/BUILD/sc68-2.2.1/file68/string68.h File Reference</h1>String functions.
<a href="#_details">More...</a>
<p>
<p>
<a href="string68_8h_source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="string68_8h.html#6a385cfea4f52adac7fc2cd26a46390c">SC68strcmp</a> (const char *a, const char *b)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Compare two string (case insensitive). <a href="#6a385cfea4f52adac7fc2cd26a46390c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="string68_8h.html#b2cc96121ba5e17b5a375a803ddb4980">SC68strcat</a> (char *a, const char *b, int l)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Concatenate two strings. <a href="#b2cc96121ba5e17b5a375a803ddb4980"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="string68_8h.html#93d5e608b38ec4aad725d9ea5eab92ef">SC68strdup</a> (const char *s)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Duplicate a string. <a href="#93d5e608b38ec4aad725d9ea5eab92ef"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="string68_8h.html#063b89ae3f073f476beaa983d31eb4c8">SC68strcatdup</a> (const char *a, const char *b)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Concat two strings in a duplicate buffer. <a href="#063b89ae3f073f476beaa983d31eb4c8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="string68_8h.html#9f1c0ee4ad461581fa51bbaa88c8e337">SC68time_str</a> (char *buffer, int track_num, int seconds)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Make a track and time infornmation string. <a href="#9f1c0ee4ad461581fa51bbaa88c8e337"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="string68_8h.html#64f9d28e74e5ad3bdb151cdcbde0967d">SC68long_time_str</a> (char *buffer, int time)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convert time (in second) to string. <a href="#64f9d28e74e5ad3bdb151cdcbde0967d"></a><br></td></tr>
</table>
<hr><h2>Detailed Description</h2>
String functions.
<p>
<dl class="author" compact><dt><b>Author:</b></dt><dd>Benjamin Gerard <<a href="mailto:ben@sashipa.com">ben@sashipa.com</a>> </dd></dl>
<dl class="date" compact><dt><b>Date:</b></dt><dd>2003/08/11 </dd></dl>
<dl class="rcs" compact><dt><b>Id</b></dt><dd><a class="el" href="string68_8h.html" title="String functions.">string68.h</a>,v 2.0 2003/08/21 04:58:35 benjihan Exp </dd></dl>
<p>
Common string operations. <hr><h2>Function Documentation</h2>
<a class="anchor" name="6a385cfea4f52adac7fc2cd26a46390c"></a><!-- doxytag: member="string68.h::SC68strcmp" ref="6a385cfea4f52adac7fc2cd26a46390c" args="(const char *a, const char *b)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int SC68strcmp </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>a</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>b</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Compare two string (case insensitive).
<p>
The <a class="el" href="string68_8h.html#6a385cfea4f52adac7fc2cd26a46390c" title="Compare two string (case insensitive).">SC68strcmp()</a> function compares the two strings a and b, ignoring the case of the characters. It returns an integer less than, equal to, or greater than zero if a is found, respectively, to be less than, to match, or be greater than b.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>a</em> </td><td>First string to compare </td></tr>
<tr><td valign="top"></td><td valign="top"><em>b</em> </td><td>String to compare with</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Integer result of the two string compare. The difference between last tested characters of a and b. </dd></dl>
<dl compact><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>0</em> </td><td>a and b are equal </td></tr>
<tr><td valign="top"></td><td valign="top"><em><0</em> </td><td>a is less than b </td></tr>
<tr><td valign="top"></td><td valign="top"><em>>0</em> </td><td>a is greater than b </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="b2cc96121ba5e17b5a375a803ddb4980"></a><!-- doxytag: member="string68.h::SC68strcat" ref="b2cc96121ba5e17b5a375a803ddb4980" args="(char *a, const char *b, int l)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* SC68strcat </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>a</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>b</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>l</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Concatenate two strings.
<p>
The <a class="el" href="string68_8h.html#b2cc96121ba5e17b5a375a803ddb4980" title="Concatenate two strings.">SC68strcat()</a> function appends the b string to the a string overwriting the 0 character at the end of dest, and then adds a terminating 0 character. The strings may not overlap. Destination string has a maximum size of l characters. On overflow, the trailing 0 is omitted.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>a</em> </td><td>Destination string </td></tr>
<tr><td valign="top"></td><td valign="top"><em>b</em> </td><td>String to append. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>l</em> </td><td>Destination maximum size (including trailing 0)</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Destination string </dd></dl>
<dl compact><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>a</em> </td><td></td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="93d5e608b38ec4aad725d9ea5eab92ef"></a><!-- doxytag: member="string68.h::SC68strdup" ref="93d5e608b38ec4aad725d9ea5eab92ef" args="(const char *s)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* SC68strdup </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>s</em> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Duplicate a string.
<p>
The <a class="el" href="string68_8h.html#93d5e608b38ec4aad725d9ea5eab92ef" title="Duplicate a string.">SC68strdup()</a> function returns a pointer to a new string which is a duplicate of the string s. Memory for the new string is obtained with <a class="el" href="alloc68_8h.html#891e6330d6b7f65215baa38eaaff7fd0" title="Allocate dynamic memory.">SC68alloc()</a>, and can be freed with <a class="el" href="alloc68_8h.html#891a07736bb8b2dced70ad3614d62a5c" title="Free dynamic memory.">SC68free()</a>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>s</em> </td><td>String to duplicate.</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Duplicated string <p>
0 error </dd></dl>
</div>
</div><p>
<a class="anchor" name="063b89ae3f073f476beaa983d31eb4c8"></a><!-- doxytag: member="string68.h::SC68strcatdup" ref="063b89ae3f073f476beaa983d31eb4c8" args="(const char *a, const char *b)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* SC68strcatdup </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>a</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>b</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Concat two strings in a duplicate buffer.
<p>
The <a class="el" href="string68_8h.html#063b89ae3f073f476beaa983d31eb4c8" title="Concat two strings in a duplicate buffer.">SC68strcatdup()</a> function returns a pointer to a new string which is a duplicate of the string a+b. Memory for the new string is obtained with <a class="el" href="alloc68_8h.html#891e6330d6b7f65215baa38eaaff7fd0" title="Allocate dynamic memory.">SC68alloc()</a>, and can be freed with <a class="el" href="alloc68_8h.html#891a07736bb8b2dced70ad3614d62a5c" title="Free dynamic memory.">SC68free()</a>. If either a or b is null the function does not failed but replace it by an empty string. If both a and b are null the function returns 0.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>a</em> </td><td>Left string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>b</em> </td><td>right string.</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Duplicated string a+b <p>
0 error </dd></dl>
</div>
</div><p>
<a class="anchor" name="9f1c0ee4ad461581fa51bbaa88c8e337"></a><!-- doxytag: member="string68.h::SC68time_str" ref="9f1c0ee4ad461581fa51bbaa88c8e337" args="(char *buffer, int track_num, int seconds)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* SC68time_str </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>track_num</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>seconds</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Make a track and time infornmation string.
<p>
The <a class="el" href="string68_8h.html#9f1c0ee4ad461581fa51bbaa88c8e337" title="Make a track and time infornmation string.">SC68time_str()</a> function formats a string with track time info. The general format is "TK MN:SS" where:<ul>
<li>TK is track_num or "--" if track_num < 0 or track_num > 99</li><li>MN:SS is time minutes and seconds or "--:--" if seconds < 0</li></ul>
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>Destination buffer (0 use default static buffer). </td></tr>
<tr><td valign="top"></td><td valign="top"><em>track_num</em> </td><td>Track number from 00 to 99, minus values disable. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>seconds</em> </td><td>Time to display in seconds [00..5999], other values disable.</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Pointer to result formatted string in a static buffer.</dd></dl>
<dl class="warning" compact><dt><b>Warning:</b></dt><dd>The function returns a static buffer. Do try to modify it. <p>
Not thread safe.</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd>SC68utils_make_big_playing_time() </dd></dl>
</div>
</div><p>
<a class="anchor" name="64f9d28e74e5ad3bdb151cdcbde0967d"></a><!-- doxytag: member="string68.h::SC68long_time_str" ref="64f9d28e74e5ad3bdb151cdcbde0967d" args="(char *buffer, int time)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* SC68long_time_str </td>
<td>(</td>
<td class="paramtype">char * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>time</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Convert time (in second) to string.
<p>
The <a class="el" href="string68_8h.html#64f9d28e74e5ad3bdb151cdcbde0967d" title="Convert time (in second) to string.">SC68long_time_str()</a> function converts a time in seconds to days, hours, minutes and second string. Day and hour unit are removed if they are null (not signifiant). The output string looks like : [D days, ][H h, ] MN' SS"<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>Destination buffer (0 use default static buffer). </td></tr>
<tr><td valign="top"></td><td valign="top"><em>time</em> </td><td>Time in second to convert to string.</td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>pointer to result time string (given buffer or static buffer).</dd></dl>
<dl class="warning" compact><dt><b>Warning:</b></dt><dd>Not thread safe when using static buffer.</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd>SC68utils_make_track_time_info() </dd></dl>
</div>
</div><p>
</div>
<hr size="1"><address style="text-align: right;"><small>Generated on Tue Sep 15 03:58:05 2009 for sc68fordevelopers by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.9 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
2ff8806b45ba9c96e77e01e6d40e440b
>
files
>
204
