<!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" xml:lang="en"
lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>
memchr [C++ Reference]
</title>
<meta name="generator" content="DokuWiki Release 2009-12-25c "Lemming"" />
<meta name="robots" content="index,follow" />
<meta name="date" content="2008-10-14T15:42:02-0700" />
<meta name="keywords" content="c,string,memchr" />
<link rel="search" type="application/opensearchdescription+xml" href="/wiki/lib/exe/opensearch.php" title="C++ Reference" />
<link rel="start" href="/wiki/" />
<link rel="contents" href="/wiki/c/string/memchr?do=index" title="Index" />
<link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/wiki/feed.php" />
<link rel="alternate" type="application/rss+xml" title="Current Namespace" href="/wiki/feed.php?mode=list&ns=c:string" />
<link rel="edit" title="Edit this page" href="/wiki/c/string/memchr?do=edit" />
<link rel="alternate" type="text/html" title="Plain HTML" href="/wiki/_export/xhtml/c/string/memchr" />
<link rel="alternate" type="text/plain" title="Wiki Markup" href="/wiki/_export/raw/c/string/memchr" />
<link rel="canonical" href="http://www.cppreference.com/wiki/c/string/memchr" />
<link rel="stylesheet" media="all" type="text/css" href="/wiki/lib/exe/css.php?s=all&t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="screen" type="text/css" href="/wiki/lib/exe/css.php?t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="print" type="text/css" href="/wiki/lib/exe/css.php?s=print&t=custom1&tseed=1272971091" />
<script type="text/javascript" charset="utf-8" ><!--//--><![CDATA[//><!--
var NS='c:string';var JSINFO = {"id":"c:string:memchr","namespace":"c:string"};
//--><!]]></script>
<script type="text/javascript" charset="utf-8" src="/wiki/lib/exe/js.php?tseed=1272971091" ></script>
<link rel="shortcut icon" href="/wiki/lib/tpl/custom1/images/favicon.png" />
</head>
<body>
<div class="dokuwiki">
<div class="stylehead">
<div class="breadcrumbs">
<span class="bchead">You are here: </span><a href="../../start.html" title="start">C++ Reference</a> » <a href="../../c/start.html" title="c:start">The Standard C Library</a> » <a href="../../c/string/start.html" title="c:string:start">Standard C String and Character</a> » <a href="../../c/string/memchr.html" title="c:string:memchr">memchr</a> </div>
</div>
<div class="page">
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-2828341-1";
urchinTracker();
</script>
<!-- wikipage start -->
<h2><a name="memchr" id="memchr">memchr</a></h2>
<div class="level2">
<p>
Syntax:
</p>
<pre class="c code c++" style="font-family:monospace;"> <span class="co2">#include <cstring></span>
<span class="kw4">void</span> <span class="sy0">*</span>memchr<span class="br0">(</span> <span class="kw4">const</span> <span class="kw4">void</span> <span class="sy0">*</span>buffer<span class="sy0">,</span> <span class="kw4">int</span> ch<span class="sy0">,</span> size_t count <span class="br0">)</span><span class="sy0">;</span></pre>
<p>
The memchr() function looks for the first occurrence of ch within count
characters in the array pointed to by buffer. The return value points to the
location of the first occurrence of ch, or NULL if ch isn't found. For example:
</p>
<pre class="c code c++" style="font-family:monospace;"> <span class="kw4">char</span> names<span class="br0">[</span><span class="br0">]</span> <span class="sy0">=</span> <span class="st0">"Alan Bob Chris X Dave"</span><span class="sy0">;</span>
<span class="kw1">if</span><span class="br0">(</span> memchr<span class="br0">(</span>names<span class="sy0">,</span><span class="st0">'X'</span><span class="sy0">,</span>strlen<span class="br0">(</span>names<span class="br0">)</span><span class="br0">)</span> <span class="sy0">==</span> NULL <span class="br0">)</span>
<a href="http://www.opengroup.org/onlinepubs/009695399/functions/printf.html"><span class="kw3">printf</span></a><span class="br0">(</span> <span class="st0">"Didn't find an X<span class="es1">\n</span>"</span> <span class="br0">)</span><span class="sy0">;</span>
<span class="kw1">else</span>
<a href="http://www.opengroup.org/onlinepubs/009695399/functions/printf.html"><span class="kw3">printf</span></a><span class="br0">(</span> <span class="st0">"Found an X<span class="es1">\n</span>"</span> <span class="br0">)</span><span class="sy0">;</span></pre>
<p>
Related Topics: <a href="../../c/string/memcmp.html" class="wikilink1" title="c:string:memcmp">memcmp</a>, <a href="../../c/string/memcpy.html" class="wikilink1" title="c:string:memcpy">memcpy</a>, <a href="../../c/string/strstr.html" class="wikilink1" title="c:string:strstr">strstr</a>
</p>
</div>
<!-- wikipage stop -->
</div>
<div class="clearer"> </div>
<div class="stylefoot">
<div class="meta">
<div class="user">
</div>
<!--
<div class="doc">
c/string/memchr.txt · Last modified: 10/14/2008 15:42 (external edit) </div>
-->
</div>
</div></div></body>
</html>