portugalfuturista/universalisos
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
universalisos/docs/html/libstand-reference-manual/group__string.html
Fábio Coutada 7855eab092 feat(import): Complete PikeOS 5.0 ecosystem import from devvm-arch 
MAJOR MILESTONE: Successfully imported complete PikeOS 5.0 ecosystem
from Virtual Machine 100 (devvm-arch) on gigabyte Proxmox server.

Import Summary:
- Source Code: 4.3GB, 63,441 files, 14,829 C/C++/H files
- Documentation: 78MB, 37+ PDF manuals covering all PikeOS aspects
- XSD Schemas: 1.8MB, 158 schema files for configuration/code generation
- Test Framework: Complete TFW infrastructure in src/tfw/

Key Components:
✅ Multi-architecture kernels (ARM v7/v8, PowerPC e500/e500mc/e5500, x86_64)
✅ Core source libraries (libstand, ssw, p4ext)
✅ Complete test framework with executables, includes, libraries
✅ 37+ comprehensive PDF documentation (installation, development, platform manuals)
✅ 158 XSD schemas for Eclipse-based code generation and configuration
✅ AUTOSAR/MISRA safety-critical compliance foundation
✅ Hardware virtualization support
✅ Eclipse IDE project configuration (.project, .cproject)

Documentation Categories:
- Installation & User Guides (pikeos-installation-guide.pdf, user manuals)
- Development References (kernel, driver, test framework manuals)
- API & Programming (C/C++ environments, native API extensions)
- Platform Manuals (ARM, PowerPC, x86 specific guides)
- CDK Documentation (gcc, binutils, ld, cpp internals)
- Release Notes (all components for 5.0.3)
- Specialized Topics (hardware virtualization, POSIX compliance)

Technical Achievements:
✅ Complete PikeOS 5.0 codebase across multiple processor architectures
✅ Safety-critical foundation with AUTOSAR/MISRA compliance
✅ Eclipse IDE integration with XSD-driven code generation pipeline
✅ Comprehensive test framework for validation and verification
✅ Complete documentation covering development, deployment, and optimization

Extraction Method:
- Source: VM 100 (devvm-arch) on gigabyte server (192.168.0.104)
- Method: Direct LVM disk mount via losetup, rsync transfer
- Size: Total 4.4GB extracted and organized

Next Phases:
- Phase 3: XSD Workflow Analysis (Day 8-10)
- Phase 4: Safety Standards Compliance Documentation (Day 11-12)
- Phase 5: Component Categorization (Day 13-14)
- Phase 6: Aurelio Brain Test (Day 15)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-06 21:01:41 +01:00

780 lines
39 KiB
HTML
Raw Permalink Blame History

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>ANSI C string manipulation functions</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('group__string.html','');});
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">ANSI C string manipulation functions</div> </div>
</div><!--header-->
<div class="contents">
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>This section describes the subset of the ANSI C string manipulation functions included in libstand. </p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ga3bc2c779d25f90da5243dc55d76b2259"><td class="memItemLeft" align="right" valign="top">char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga3bc2c779d25f90da5243dc55d76b2259">strncat</a> (char *dst, const char *src, size_t n0)</td></tr>
<tr class="memdesc:ga3bc2c779d25f90da5243dc55d76b2259"><td class="mdescLeft">&#160;</td><td class="mdescRight">Concatenate two strings by appending not more than <em>n0</em> characters (including the terminating NUL character) from the string pointed to by <em>src</em> to the string pointed to by <em>s1</em>. The first character of <em>src</em> overwrites the terminating NUL character of <em>s1</em>. A terminating NUL character is always appended to the result. This means that the number of characters appended to <em>s1</em> may exceed <em>n0</em> by one. <a href="#ga3bc2c779d25f90da5243dc55d76b2259">More...</a><br /></td></tr>
<tr class="separator:ga3bc2c779d25f90da5243dc55d76b2259"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga3cbea25d508f28f392ee202e96c039ea"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga3cbea25d508f28f392ee202e96c039ea">strncmp</a> (const char *a, const char *i, size_t n)</td></tr>
<tr class="memdesc:ga3cbea25d508f28f392ee202e96c039ea"><td class="mdescLeft">&#160;</td><td class="mdescRight">Compare not more than the first <em>n</em> characters of the string pointed to by <em>s1</em> and <em>i</em>. <a href="#ga3cbea25d508f28f392ee202e96c039ea">More...</a><br /></td></tr>
<tr class="separator:ga3cbea25d508f28f392ee202e96c039ea"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga11bd144d7d44914099a3aeddf1c8567d"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga11bd144d7d44914099a3aeddf1c8567d">strcmp</a> (const char *s1, const char *s2)</td></tr>
<tr class="memdesc:ga11bd144d7d44914099a3aeddf1c8567d"><td class="mdescLeft">&#160;</td><td class="mdescRight">Compare the string pointed to by <em>s1</em> and <em>s2</em>. <a href="#ga11bd144d7d44914099a3aeddf1c8567d">More...</a><br /></td></tr>
<tr class="separator:ga11bd144d7d44914099a3aeddf1c8567d"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gad7ddf24a988deea9545e2aa3eb6c69f9"><td class="memItemLeft" align="right" valign="top">char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#gad7ddf24a988deea9545e2aa3eb6c69f9">strncpy</a> (char *dst, const char *src, size_t n0)</td></tr>
<tr class="memdesc:gad7ddf24a988deea9545e2aa3eb6c69f9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Copy not more than <em>n0</em> characters (including the terminating NUL character) from the string pointed to by <em>src</em> to the string pointed to by <em>dst0</em>. If <em>n0</em> is greater than the number of characters in <em>src</em>, NUL characters are appended to <em>src</em>. <a href="#gad7ddf24a988deea9545e2aa3eb6c69f9">More...</a><br /></td></tr>
<tr class="separator:gad7ddf24a988deea9545e2aa3eb6c69f9"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga008e171a518fe0e0352f31b245e03875"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga008e171a518fe0e0352f31b245e03875">strlen</a> (const char *str)</td></tr>
<tr class="memdesc:ga008e171a518fe0e0352f31b245e03875"><td class="mdescLeft">&#160;</td><td class="mdescRight">Determine the string length of the string pointed to by a <em>str</em>. The string length is the number of characters in the string disreagrding the terminating NUL character. <a href="#ga008e171a518fe0e0352f31b245e03875">More...</a><br /></td></tr>
<tr class="separator:ga008e171a518fe0e0352f31b245e03875"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gac99b922a369d7ff6a58d9b5118c61441"><td class="memItemLeft" align="right" valign="top">char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#gac99b922a369d7ff6a58d9b5118c61441">strnchr</a> (const char *src_void, size_t length, int c_int)</td></tr>
<tr class="memdesc:gac99b922a369d7ff6a58d9b5118c61441"><td class="mdescLeft">&#160;</td><td class="mdescRight">Find the first occurrence of the character <em>c_int</em> (casted to unsigned char) in the first <em>length</em> characters of the string pointed to by <em>s</em>. <a href="#gac99b922a369d7ff6a58d9b5118c61441">More...</a><br /></td></tr>
<tr class="separator:gac99b922a369d7ff6a58d9b5118c61441"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga4004b2e67a611b69077c9f7ac81e88ad"><td class="memItemLeft" align="right" valign="top">char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga4004b2e67a611b69077c9f7ac81e88ad">strnrchr</a> (const char *s, size_t n, int c)</td></tr>
<tr class="memdesc:ga4004b2e67a611b69077c9f7ac81e88ad"><td class="mdescLeft">&#160;</td><td class="mdescRight">Find the last occurrence of the character <em>c</em> (casted to unsigned char) in the first <em>n</em> characters of the string pointed to by <em>s</em>. <a href="#ga4004b2e67a611b69077c9f7ac81e88ad">More...</a><br /></td></tr>
<tr class="separator:ga4004b2e67a611b69077c9f7ac81e88ad"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gaabb02a8d289c95414ec5c17eb8ffef64"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#gaabb02a8d289c95414ec5c17eb8ffef64">strnlen</a> (const char *str, size_t n)</td></tr>
<tr class="memdesc:gaabb02a8d289c95414ec5c17eb8ffef64"><td class="mdescLeft">&#160;</td><td class="mdescRight">Determine the number of characters in the string pointed to by <em>str</em> not taking the terminating NUL character into account. Up to <em>n</em> characters are scanned. <a href="#gaabb02a8d289c95414ec5c17eb8ffef64">More...</a><br /></td></tr>
<tr class="separator:gaabb02a8d289c95414ec5c17eb8ffef64"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga50bd3317d65f3da7d180b8981e58c5a4"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga50bd3317d65f3da7d180b8981e58c5a4">strlcpy</a> (char *d, const char *s, size_t n)</td></tr>
<tr class="memdesc:ga50bd3317d65f3da7d180b8981e58c5a4"><td class="mdescLeft">&#160;</td><td class="mdescRight">Copy not more than <em>n-1</em> characters (excluding the terminating NUL character) from the string pointed to by <em>s</em> to the string pointed to by <em>d</em>. If count is &gt; 0, dst0 is terminated with NUL. <a href="#ga50bd3317d65f3da7d180b8981e58c5a4">More...</a><br /></td></tr>
<tr class="separator:ga50bd3317d65f3da7d180b8981e58c5a4"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga0266462615f2f112003cdb591710d299"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga0266462615f2f112003cdb591710d299">strlcat</a> (char *d, const char *s, size_t n)</td></tr>
<tr class="memdesc:ga0266462615f2f112003cdb591710d299"><td class="mdescLeft">&#160;</td><td class="mdescRight">Concatenate two strings, making the result no longer than count-1 characters, excluding the terminating NUL. The destination string is always NUL terminated. <a href="#ga0266462615f2f112003cdb591710d299">More...</a><br /></td></tr>
<tr class="separator:ga0266462615f2f112003cdb591710d299"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga161ec4a2112b65d3653b8753795cac5a"><td class="memItemLeft" align="right" valign="top">void *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga161ec4a2112b65d3653b8753795cac5a">memset</a> (void *dst_void, int c_int, size_t length)</td></tr>
<tr class="memdesc:ga161ec4a2112b65d3653b8753795cac5a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set the first <em>length</em> bytes at the given memory address <em>m</em> to the value of <em>c_int</em>. <a href="#ga161ec4a2112b65d3653b8753795cac5a">More...</a><br /></td></tr>
<tr class="separator:ga161ec4a2112b65d3653b8753795cac5a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gafb6cca33c6f8cf4ba69e190b2ca3910c"><td class="memItemLeft" align="right" valign="top">void *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#gafb6cca33c6f8cf4ba69e190b2ca3910c">memchr</a> (const void *src_void, int c_int, size_t length)</td></tr>
<tr class="memdesc:gafb6cca33c6f8cf4ba69e190b2ca3910c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Find the first occurence of the byte <em>c_int</em> in the memory range specified by <em>src_void</em> and <em>length</em>. <a href="#gafb6cca33c6f8cf4ba69e190b2ca3910c">More...</a><br /></td></tr>
<tr class="separator:gafb6cca33c6f8cf4ba69e190b2ca3910c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gae6be9598fbe5a1fa0a8a3e8d4a032a7e"><td class="memItemLeft" align="right" valign="top">void *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#gae6be9598fbe5a1fa0a8a3e8d4a032a7e">memcpy</a> (void *dst_void, const void *src_void, size_t length)</td></tr>
<tr class="memdesc:gae6be9598fbe5a1fa0a8a3e8d4a032a7e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Copy <em>length</em> bytes of the memory block starting at <em>src0</em> to the memory block starting at <em>dst_void</em>. <a href="#gae6be9598fbe5a1fa0a8a3e8d4a032a7e">More...</a><br /></td></tr>
<tr class="separator:gae6be9598fbe5a1fa0a8a3e8d4a032a7e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:gabe4c9182316f333045caae64f06d34ee"><td class="memItemLeft" align="right" valign="top">void *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#gabe4c9182316f333045caae64f06d34ee">memmove</a> (void *dst_void, const void *src_void, size_t len)</td></tr>
<tr class="memdesc:gabe4c9182316f333045caae64f06d34ee"><td class="mdescLeft">&#160;</td><td class="mdescRight">Copy <em>len</em> bytes of the memory block starting at <em>src0</em> to the overlapping memory block starting at <em>dst_void</em>. <a href="#gabe4c9182316f333045caae64f06d34ee">More...</a><br /></td></tr>
<tr class="separator:gabe4c9182316f333045caae64f06d34ee"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ga5ef3c4934e5f12655e4e349437a6fa93"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__string.html#ga5ef3c4934e5f12655e4e349437a6fa93">memcmp</a> (const void *a_void, const void *b_void, size_t n)</td></tr>
<tr class="memdesc:ga5ef3c4934e5f12655e4e349437a6fa93"><td class="mdescLeft">&#160;</td><td class="mdescRight">Compare <em>n</em> bytes of the contents of the memory range pointed to by <em>s1</em> to the contents of the memory range pointed to by <em>b_void</em>. <a href="#ga5ef3c4934e5f12655e4e349437a6fa93">More...</a><br /></td></tr>
<tr class="separator:ga5ef3c4934e5f12655e4e349437a6fa93"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<h2 class="groupheader">Function Documentation</h2>
<a id="ga3bc2c779d25f90da5243dc55d76b2259"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga3bc2c779d25f90da5243dc55d76b2259">&#9670;&nbsp;</a></span>strncat()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* strncat </td>
<td>(</td>
<td class="paramtype">char *&#160;</td>
<td class="paramname"><em>dst</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>n0</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Concatenate two strings by appending not more than <em>n0</em> characters (including the terminating NUL character) from the string pointed to by <em>src</em> to the string pointed to by <em>s1</em>. The first character of <em>src</em> overwrites the terminating NUL character of <em>s1</em>. A terminating NUL character is always appended to the result. This means that the number of characters appended to <em>s1</em> may exceed <em>n0</em> by one. </p>
<dl class="section return"><dt>Returns</dt><dd>The pointer given as <em>dst</em>. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>OUT: String to append to. </td></tr>
<tr><td class="paramname">src</td><td>IN: String which is appended from. </td></tr>
<tr><td class="paramname">n0</td><td>IN: Number of characters to append. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga3cbea25d508f28f392ee202e96c039ea"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga3cbea25d508f28f392ee202e96c039ea">&#9670;&nbsp;</a></span>strncmp()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int strncmp </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>a</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>i</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>n</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare not more than the first <em>n</em> characters of the string pointed to by <em>s1</em> and <em>i</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>If <em>s1</em> sorts lexicographically after <em>i</em>, a value greater than than zero is returned. In the opposite case, a value smaller than zero is returned. If the strings are equivalent, zero is returned. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">a</td><td>IN: Pointer to a string which is compared. </td></tr>
<tr><td class="paramname">i</td><td>IN: Pointer to a string which is compared. </td></tr>
<tr><td class="paramname">n</td><td>IN: Number of characters to compare. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga11bd144d7d44914099a3aeddf1c8567d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga11bd144d7d44914099a3aeddf1c8567d">&#9670;&nbsp;</a></span>strcmp()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int strcmp </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>s1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>s2</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare the string pointed to by <em>s1</em> and <em>s2</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>If <em>s1</em> sorts lexicographically after <em>s2</em>, a value greater than than zero is returned. In the opposite case, a value smaller than zero is returned. If the strings are equivalent, zero is returned. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s1</td><td>IN: Pointer to a string which is compared. </td></tr>
<tr><td class="paramname">s2</td><td>IN: Pointer to a string which is compared. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="gad7ddf24a988deea9545e2aa3eb6c69f9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gad7ddf24a988deea9545e2aa3eb6c69f9">&#9670;&nbsp;</a></span>strncpy()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* strncpy </td>
<td>(</td>
<td class="paramtype">char *&#160;</td>
<td class="paramname"><em>dst</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>n0</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy not more than <em>n0</em> characters (including the terminating NUL character) from the string pointed to by <em>src</em> to the string pointed to by <em>dst0</em>. If <em>n0</em> is greater than the number of characters in <em>src</em>, NUL characters are appended to <em>src</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>The pointer given as <em>dst</em>. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>IN: Pointer to the destination string. </td></tr>
<tr><td class="paramname">src</td><td>OUT: Pointer to the source string. </td></tr>
<tr><td class="paramname">n0</td><td>IN: Number of characters to copy. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga008e171a518fe0e0352f31b245e03875"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga008e171a518fe0e0352f31b245e03875">&#9670;&nbsp;</a></span>strlen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">size_t strlen </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>str</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Determine the string length of the string pointed to by a <em>str</em>. The string length is the number of characters in the string disreagrding the terminating NUL character. </p>
<dl class="section return"><dt>Returns</dt><dd>The number of characters the given string consists of without the terminating NUL character. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>IN: The string to determine the length of. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="gac99b922a369d7ff6a58d9b5118c61441"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gac99b922a369d7ff6a58d9b5118c61441">&#9670;&nbsp;</a></span>strnchr()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* strnchr </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>src_void</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>c_int</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the first occurrence of the character <em>c_int</em> (casted to unsigned char) in the first <em>length</em> characters of the string pointed to by <em>s</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the first occurrence of the character <em>c_int</em> in <em>s</em> or NULL, if <em>c_int</em> is not contained in the first <em>n</em> characters of <em>s</em>. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">src_void</td><td>IN: Pointer to the string in which to find the specified character. </td></tr>
<tr><td class="paramname">length</td><td>IN: Number of bytes of the given string to scan for the specified character. </td></tr>
<tr><td class="paramname">c_int</td><td>IN: The character to find. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga4004b2e67a611b69077c9f7ac81e88ad"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga4004b2e67a611b69077c9f7ac81e88ad">&#9670;&nbsp;</a></span>strnrchr()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* strnrchr </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>n</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>c</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the last occurrence of the character <em>c</em> (casted to unsigned char) in the first <em>n</em> characters of the string pointed to by <em>s</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the last occurrence of the character <em>c</em> in <em>s</em> or NULL, if <em>c</em> is not contained in the first <em>n</em> characters of <em>s</em>. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">s</td><td>IN: Pointer to the string in which to find the specified character. </td></tr>
<tr><td class="paramname">n</td><td>IN: Number of bytes of the given string to scan for the specified character. </td></tr>
<tr><td class="paramname">c</td><td>IN: The character to find. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="gaabb02a8d289c95414ec5c17eb8ffef64"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gaabb02a8d289c95414ec5c17eb8ffef64">&#9670;&nbsp;</a></span>strnlen()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">size_t strnlen </td>
<td>(</td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>n</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Determine the number of characters in the string pointed to by <em>str</em> not taking the terminating NUL character into account. Up to <em>n</em> characters are scanned. </p>
<dl class="section return"><dt>Returns</dt><dd>The number of characters in the string pointed to by <em>str</em> not including the terminating NUL character or <em>n</em> if no terminating NUL character is contained in the first <em>n</em> characters. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>IN: Pointer to the string to determine the length of. </td></tr>
<tr><td class="paramname">n</td><td>IN: Maximum length of the given string. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga50bd3317d65f3da7d180b8981e58c5a4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga50bd3317d65f3da7d180b8981e58c5a4">&#9670;&nbsp;</a></span>strlcpy()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">size_t strlcpy </td>
<td>(</td>
<td class="paramtype">char *&#160;</td>
<td class="paramname"><em>d</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>n</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy not more than <em>n-1</em> characters (excluding the terminating NUL character) from the string pointed to by <em>s</em> to the string pointed to by <em>d</em>. If count is &gt; 0, dst0 is terminated with NUL. </p>
<dl class="section return"><dt>Returns</dt><dd>The length of string dst0, excluding character 0, or count if the resulting string was too long. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">d</td><td>IN: Pointer to the destination string. </td></tr>
<tr><td class="paramname">s</td><td>OUT: Pointer to the source string. </td></tr>
<tr><td class="paramname">n</td><td>IN: Number of characters to copy. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga0266462615f2f112003cdb591710d299"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga0266462615f2f112003cdb591710d299">&#9670;&nbsp;</a></span>strlcat()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">size_t strlcat </td>
<td>(</td>
<td class="paramtype">char *&#160;</td>
<td class="paramname"><em>d</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *&#160;</td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>n</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Concatenate two strings, making the result no longer than count-1 characters, excluding the terminating NUL. The destination string is always NUL terminated. </p>
<dl class="section return"><dt>Returns</dt><dd>The length of the string s1, excluding character 0, or count if the resulting string was too long. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">d</td><td>OUT: String to append to. </td></tr>
<tr><td class="paramname">s</td><td>IN: String which is appended from. </td></tr>
<tr><td class="paramname">n</td><td>IN: Number of characters to append. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga161ec4a2112b65d3653b8753795cac5a"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga161ec4a2112b65d3653b8753795cac5a">&#9670;&nbsp;</a></span>memset()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* memset </td>
<td>(</td>
<td class="paramtype">void *&#160;</td>
<td class="paramname"><em>dst_void</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>c_int</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>length</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the first <em>length</em> bytes at the given memory address <em>m</em> to the value of <em>c_int</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>The pointer given as <em>dst_void</em>. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst_void</td><td>OUT: Start memory address. </td></tr>
<tr><td class="paramname">c_int</td><td>IN: The value to assign to each byte in the specified range. </td></tr>
<tr><td class="paramname">length</td><td>IN: The length, in bytes, of the range to modify. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="gafb6cca33c6f8cf4ba69e190b2ca3910c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gafb6cca33c6f8cf4ba69e190b2ca3910c">&#9670;&nbsp;</a></span>memchr()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* memchr </td>
<td>(</td>
<td class="paramtype">const void *&#160;</td>
<td class="paramname"><em>src_void</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int&#160;</td>
<td class="paramname"><em>c_int</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>length</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Find the first occurence of the byte <em>c_int</em> in the memory range specified by <em>src_void</em> and <em>length</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>A pointer to the first occurrence of the byte <em>c_int</em> in the specified memory range or NULL, if the byte <em>c_int</em> does not occur in the first <em>length</em> bytes. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">src_void</td><td>IN: Start memory address. </td></tr>
<tr><td class="paramname">c_int</td><td>IN: The byte value to find. </td></tr>
<tr><td class="paramname">length</td><td>IN: The length, in bytes, of the range to search in. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="gae6be9598fbe5a1fa0a8a3e8d4a032a7e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gae6be9598fbe5a1fa0a8a3e8d4a032a7e">&#9670;&nbsp;</a></span>memcpy()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* memcpy </td>
<td>(</td>
<td class="paramtype">void *&#160;</td>
<td class="paramname"><em>dst_void</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void *&#160;</td>
<td class="paramname"><em>src_void</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>length</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy <em>length</em> bytes of the memory block starting at <em>src0</em> to the memory block starting at <em>dst_void</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>The pointer given as <em>dst_void</em>. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst_void</td><td>OUT: Start address of the destination memory range. </td></tr>
<tr><td class="paramname">src_void</td><td>IN: Start address of the source memory range. </td></tr>
<tr><td class="paramname">length</td><td>IN: Number of bytes to copy from <em>src_void</em> to <em>dst0</em>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="gabe4c9182316f333045caae64f06d34ee"></a>
<h2 class="memtitle"><span class="permalink"><a href="#gabe4c9182316f333045caae64f06d34ee">&#9670;&nbsp;</a></span>memmove()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* memmove </td>
<td>(</td>
<td class="paramtype">void *&#160;</td>
<td class="paramname"><em>dst_void</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void *&#160;</td>
<td class="paramname"><em>src_void</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>len</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy <em>len</em> bytes of the memory block starting at <em>src0</em> to the overlapping memory block starting at <em>dst_void</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>The pointer given as <em>dst_void</em>. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst_void</td><td>OUT: Start address of the destination memory range. </td></tr>
<tr><td class="paramname">src_void</td><td>IN: Start address of the source memory range. </td></tr>
<tr><td class="paramname">len</td><td>IN: Number of bytes to copy from <em>src_void</em> to <em>dst0</em>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="ga5ef3c4934e5f12655e4e349437a6fa93"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ga5ef3c4934e5f12655e4e349437a6fa93">&#9670;&nbsp;</a></span>memcmp()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int memcmp </td>
<td>(</td>
<td class="paramtype">const void *&#160;</td>
<td class="paramname"><em>a_void</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void *&#160;</td>
<td class="paramname"><em>b_void</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t&#160;</td>
<td class="paramname"><em>n</em>&#160;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Compare <em>n</em> bytes of the contents of the memory range pointed to by <em>s1</em> to the contents of the memory range pointed to by <em>b_void</em>. </p>
<dl class="section return"><dt>Returns</dt><dd>A value greater than, equal to or smaller than zero, according to whether the memory range pointed to by <em>a_void</em> is gearter than, equal to or smaller than the memory range pointed to by <em>b_void</em>. </dd></dl>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">a_void</td><td>IN: Start address of the memory range to compare. </td></tr>
<tr><td class="paramname">b_void</td><td>IN: Start address of the memory range to compare. </td></tr>
<tr><td class="paramname">n</td><td>IN: Number of bytes to compare. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="footer">(C) Copyright SYSGO AG</li>
</ul>
</div>
</body>
</html>
Reference in a new issue View git blame Copy permalink