Caleb Cooper: Created page with "{{Documentation subpage}} === Usage === This template converses a '''''numerical'' character referenc..."

2020-10-18T21:09:26Z

Created page with "{{Documentation subpage}}  === Usage === This template converses a '''''numerical'' character referenc..."

New page

{{Documentation subpage}}


=== Usage ===
This template converses a '''''numerical'' character reference''' into a '''''named'' character reference'''. It converts a number to the named character reference for HTML, also often called a "character entity". The input number can be decimal or hexadecimal.
* <code><nowiki>{{Numcr2namecr|A0}}</nowiki></code> --> {{Numcr2namecr|A0}}
* <code><nowiki>{{Numcr2namecr|160|base=dec}}</nowiki></code> --> {{Numcr2namecr|160|base=dec}}

By default the numeric base is presumed to be ''hexadecimal''. When the base is decimal, it needs to be specified using "base=dec"

When the number has no related named character, an blank is presented. This message can be overruled:
* <code><nowiki>{{Numcr2namecr|61}}</nowiki></code> --> {{Numcr2namecr|61}}
* <code><nowiki>{{Numcr2namecr|61|notfoundmsg=Not named}}</nowiki></code> --> {{Numcr2namecr|61|notfoundmsg=Not named}}

===Parameters===
* '''First parameter, 1=''' Unnamed, required. Numerical value in hex or decimal. Hexadecimal can have the prefix "0x". Input like ''&#160;'' (expected output &nbsp;) can not be processed.
* '''base=''' Required when base=decimal, default base=hex. When the input number (parameter 1) is ''decimal'', the base= ''must'' be defined through: "base=dec", "base=d", "base=10".
:For clarity in code, the hex base may be defined as well: "base=hex", "base=h", "base=16". The base is also hexadecimal when the prefix "0x" is used with the number.
* '''notfoundmsg=''' Optional message, default= (blank). Will be returned when the value does not have a named reference.
* <code><nowiki>{{numcr2namecr|61}}</nowiki></code> --> {{numcr2namecr|61}}
* <code><nowiki>{{numcr2namecr|61|notfoundmsg=Cannot find the name}}</nowiki></code> --> {{Numcr2namecr|61|notfoundmsg=Cannot find the name}}

===Technical notes===
The template uses the subtemplate {{tlx|numcr2namecr/listbydec}}, which contains a list of all '''2032''' character names (or '''1446''' unique characters). Hexadecimal-decimal calculations are performed by {{tlx|hex2dec}} and {{tlx|hexadecimal}}.

=== See also ===
* [[List of XML and HTML character entity references]] gives background and an overview

<includeonly>{{Sandbox other||


[[Category:Conversion templates]]

}}</includeonly>

Template:Numcr2namecr/doc - Revision history

Caleb Cooper: Created page with "{{Documentation subpage}} === Usage === This template converses a '''''numerical'' character referenc..."