<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Find Unicode character by name and return its code point value</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="intlchar.chardirection.html">IntlChar::charDirection</a></div>
<div class="next" style="text-align: right; float: right;"><a href="intlchar.charmirror.html">IntlChar::charMirror</a></div>
<div class="up"><a href="class.intlchar.html">IntlChar</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="intlchar.charfromname" class="refentry">
<div class="refnamediv">
<h1 class="refname">IntlChar::charFromName</h1>
<p class="verinfo">(PHP 7)</p><p class="refpurpose"><span class="refname">IntlChar::charFromName</span> — <span class="dc-title">Find Unicode character by name and return its code point value</span></p>
</div>
<div class="refsect1 description" id="refsect1-intlchar.charfromname-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="modifier">public</span> <span class="modifier">static</span> <span class="type">int</span> <span class="methodname"><strong>IntlChar::charFromName</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$characterName</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$nameChoice</code><span class="initializer"> = <strong><code>IntlChar::UNICODE_CHAR_NAME</code></strong></span></span>
] )</div>
<p class="para rdfs-comment">
Finds a Unicode character by its name and returns its code point value.
</p>
<p class="para">
The name is matched exactly and completely. If the name does not correspond to a code point, <strong><code>FALSE</code></strong> is returned.
</p>
<p class="para">
A Unicode 1.0 name is matched only if it differs from the modern name. Unicode names are all uppercase.
Extended names are lowercase followed by an uppercase hexadecimal number, and within angle brackets.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-intlchar.charfromname-parameters">
<h3 class="title">Parameters</h3>
<dl>
<dt>
<code class="parameter">characterName</code></dt>
<dd>
<p class="para">
Full name of the Unicode character.
</p>
</dd>
<dt>
<code class="parameter">nameChoice</code></dt>
<dd>
<p class="para">
Which set of names to use for the lookup. Can be any of these constants:
<ul class="simplelist">
<li class="member"><strong><code>IntlChar::UNICODE_CHAR_NAME</code></strong> (default)</li>
<li class="member"><strong><code>IntlChar::UNICODE_10_CHAR_NAME</code></strong></li>
<li class="member"><strong><code>IntlChar::EXTENDED_CHAR_NAME</code></strong></li>
<li class="member"><strong><code>IntlChar::CHAR_NAME_ALIAS</code></strong></li>
<li class="member"><strong><code>IntlChar::CHAR_NAME_CHOICE_COUNT</code></strong></li>
</ul>
</p>
</dd>
</dl>
</div>
<div class="refsect1 returnvalues" id="refsect1-intlchar.charfromname-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
The Unicode value of the code point with the given name (as an <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>), or <strong><code>FALSE</code></strong> if there is no such code point.
</p>
</div>
<div class="refsect1 examples" id="refsect1-intlchar.charfromname-examples">
<h3 class="title">Examples</h3>
<div class="example" id="example-3195">
<p><strong>Example #1 Testing different code points</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">IntlChar</span><span style="color: #007700">::</span><span style="color: #0000BB">charFromName</span><span style="color: #007700">(</span><span style="color: #DD0000">"LATIN CAPITAL LETTER A"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">IntlChar</span><span style="color: #007700">::</span><span style="color: #0000BB">charFromName</span><span style="color: #007700">(</span><span style="color: #DD0000">"SNOWMAN"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">IntlChar</span><span style="color: #007700">::</span><span style="color: #0000BB">charFromName</span><span style="color: #007700">(</span><span style="color: #DD0000">"RECYCLING SYMBOL FOR TYPE-1 PLASTICS"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">IntlChar</span><span style="color: #007700">::</span><span style="color: #0000BB">charFromName</span><span style="color: #007700">(</span><span style="color: #DD0000">"A RANDOM STRING WHICH DOESN'T CORRESPOND TO ANY UNICODE CHARACTER"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>The above example will output:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
int(65)
int(9731)
int(9843)
bool(false)
</pre></div>
</div>
</div>
</div>
<div class="refsect1 seealso" id="refsect1-intlchar.charfromname-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="intlchar.charname.html" class="function" rel="rdfs-seeAlso">IntlChar::charName()</a> - Retrieve the name of a Unicode character</span></li>
<li class="member"><span class="function"><a href="intlchar.enumcharnames.html" class="function" rel="rdfs-seeAlso">IntlChar::enumCharNames()</a> - Enumerate all assigned Unicode characters within a range</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="intlchar.chardirection.html">IntlChar::charDirection</a></div>
<div class="next" style="text-align: right; float: right;"><a href="intlchar.charmirror.html">IntlChar::charMirror</a></div>
<div class="up"><a href="class.intlchar.html">IntlChar</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
