<!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"/>
<title>ICU 4.8.1.1: FieldPosition Class Reference</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="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</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! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">ICU 4.8.1.1
 <span id="projectnumber">4.8.1.1</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.1.1 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<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 class="current"><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="classes.html"><span>Data Structure Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Data Fields</span></a></li>
</ul>
</div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark"> </span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(11)"><span class="SelectionMark"> </span>Pages</a></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><!-- top -->
<div class="header">
<div class="summary">
<a href="#pub-types">Public Types</a> |
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> </div>
<div class="headertitle">
<div class="title">FieldPosition Class Reference</div> </div>
</div><!--header-->
<div class="contents">
<p><code><a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a></code> is a simple class used by <code><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a></code> and its subclasses to identify fields in formatted output.
<a href="classFieldPosition.html#details">More...</a></p>
<p><code>#include <<a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for FieldPosition:</div>
<div class="dyncontent">
<div class="center">
<img src="classFieldPosition.png" usemap="#FieldPosition_map" alt=""/>
<map id="FieldPosition_map" name="FieldPosition_map">
<area href="classUObject.html" title="UObject is the common ICU "boilerplate" class." alt="UObject" shape="rect" coords="0,56,84,80"/>
<area href="classUMemory.html" title="UMemory is the common ICU base class." alt="UMemory" shape="rect" coords="0,0,84,24"/>
</map>
</div></div>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr class="memitem:ad16275b7a0b979762d161a741c54728c"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom">{ <b>DONT_CARE</b> = -1
}</td></tr>
<tr class="memdesc:ad16275b7a0b979762d161a741c54728c"><td class="mdescLeft"> </td><td class="mdescRight">DONT_CARE may be specified as the field to indicate that the caller doesn't need to specify a field. <a href="classFieldPosition.html#ad16275b7a0b979762d161a741c54728c">More...</a><br/></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:a75a87d2e7d6d97217daff8e029a0f9b9"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#a75a87d2e7d6d97217daff8e029a0f9b9">FieldPosition</a> ()</td></tr>
<tr class="memdesc:a75a87d2e7d6d97217daff8e029a0f9b9"><td class="mdescLeft"> </td><td class="mdescRight">Creates a <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a> object with a non-specified field. <a href="#a75a87d2e7d6d97217daff8e029a0f9b9"></a><br/></td></tr>
<tr class="memitem:aa03f4d3490bf5f56b797c36363bfae4f"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#aa03f4d3490bf5f56b797c36363bfae4f">FieldPosition</a> (<a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> field)</td></tr>
<tr class="memdesc:aa03f4d3490bf5f56b797c36363bfae4f"><td class="mdescLeft"> </td><td class="mdescRight">Creates a <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a> object for the given field. <a href="#aa03f4d3490bf5f56b797c36363bfae4f"></a><br/></td></tr>
<tr class="memitem:aee8d7c91df960f9f020b480e7b2fa628"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#aee8d7c91df960f9f020b480e7b2fa628">FieldPosition</a> (const <a class="el" href="classFieldPosition.html">FieldPosition</a> &copy)</td></tr>
<tr class="memdesc:aee8d7c91df960f9f020b480e7b2fa628"><td class="mdescLeft"> </td><td class="mdescRight">Copy constructor. <a href="#aee8d7c91df960f9f020b480e7b2fa628"></a><br/></td></tr>
<tr class="memitem:a29226fbee478ae6ff23ef868e7810793"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#a29226fbee478ae6ff23ef868e7810793">~FieldPosition</a> ()</td></tr>
<tr class="memdesc:a29226fbee478ae6ff23ef868e7810793"><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#a29226fbee478ae6ff23ef868e7810793"></a><br/></td></tr>
<tr class="memitem:a71afa3cf2ccf393943034c2c7d7eb7ce"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classFieldPosition.html">FieldPosition</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#a71afa3cf2ccf393943034c2c7d7eb7ce">operator=</a> (const <a class="el" href="classFieldPosition.html">FieldPosition</a> &copy)</td></tr>
<tr class="memdesc:a71afa3cf2ccf393943034c2c7d7eb7ce"><td class="mdescLeft"> </td><td class="mdescRight">Assignment operator. <a href="#a71afa3cf2ccf393943034c2c7d7eb7ce"></a><br/></td></tr>
<tr class="memitem:ae9dbfaa44ccd20e4eb792546df80e714"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#ae9dbfaa44ccd20e4eb792546df80e714">operator==</a> (const <a class="el" href="classFieldPosition.html">FieldPosition</a> &that) const </td></tr>
<tr class="memdesc:ae9dbfaa44ccd20e4eb792546df80e714"><td class="mdescLeft"> </td><td class="mdescRight">Equality operator. <a href="#ae9dbfaa44ccd20e4eb792546df80e714"></a><br/></td></tr>
<tr class="memitem:ad142ffe1884a49a2bf4d4073aa303038"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#ad142ffe1884a49a2bf4d4073aa303038">operator!=</a> (const <a class="el" href="classFieldPosition.html">FieldPosition</a> &that) const </td></tr>
<tr class="memdesc:ad142ffe1884a49a2bf4d4073aa303038"><td class="mdescLeft"> </td><td class="mdescRight">Equality operator. <a href="#ad142ffe1884a49a2bf4d4073aa303038"></a><br/></td></tr>
<tr class="memitem:a64641de3d32fedd8dcc7cf299cd1f9cb"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classFieldPosition.html">FieldPosition</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#a64641de3d32fedd8dcc7cf299cd1f9cb">clone</a> () const </td></tr>
<tr class="memdesc:a64641de3d32fedd8dcc7cf299cd1f9cb"><td class="mdescLeft"> </td><td class="mdescRight">Clone this object. <a href="#a64641de3d32fedd8dcc7cf299cd1f9cb"></a><br/></td></tr>
<tr class="memitem:ad62441dc0bcc91af346d78a3faca2812"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#ad62441dc0bcc91af346d78a3faca2812">getField</a> (void) const </td></tr>
<tr class="memdesc:ad62441dc0bcc91af346d78a3faca2812"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the field identifier. <a href="#ad62441dc0bcc91af346d78a3faca2812"></a><br/></td></tr>
<tr class="memitem:ac1b3be1343963a616b7eaf335437a2ff"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#ac1b3be1343963a616b7eaf335437a2ff">getBeginIndex</a> (void) const </td></tr>
<tr class="memdesc:ac1b3be1343963a616b7eaf335437a2ff"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the index of the first character in the requested field. <a href="#ac1b3be1343963a616b7eaf335437a2ff"></a><br/></td></tr>
<tr class="memitem:ad94244fb17162aa8a6629bd5e978f5d2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#ad94244fb17162aa8a6629bd5e978f5d2">getEndIndex</a> (void) const </td></tr>
<tr class="memdesc:ad94244fb17162aa8a6629bd5e978f5d2"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve the index of the character following the last character in the requested field. <a href="#ad94244fb17162aa8a6629bd5e978f5d2"></a><br/></td></tr>
<tr class="memitem:aa5fab63fb11108011e818b7904648a98"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#aa5fab63fb11108011e818b7904648a98">setField</a> (<a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> f)</td></tr>
<tr class="memdesc:aa5fab63fb11108011e818b7904648a98"><td class="mdescLeft"> </td><td class="mdescRight">Set the field. <a href="#aa5fab63fb11108011e818b7904648a98"></a><br/></td></tr>
<tr class="memitem:ae08c2e084a51bc0602b374d5ac69d76f"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#ae08c2e084a51bc0602b374d5ac69d76f">setBeginIndex</a> (<a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> bi)</td></tr>
<tr class="memdesc:ae08c2e084a51bc0602b374d5ac69d76f"><td class="mdescLeft"> </td><td class="mdescRight">Set the begin index. <a href="#ae08c2e084a51bc0602b374d5ac69d76f"></a><br/></td></tr>
<tr class="memitem:a272f8398a2757804560771cc67d1f0f8"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#a272f8398a2757804560771cc67d1f0f8">setEndIndex</a> (<a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> ei)</td></tr>
<tr class="memdesc:a272f8398a2757804560771cc67d1f0f8"><td class="mdescLeft"> </td><td class="mdescRight">Set the end index. <a href="#a272f8398a2757804560771cc67d1f0f8"></a><br/></td></tr>
<tr class="memitem:acdf9fdcb5a7d838293537a6459eb997d"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="utypes_8h.html#a22af10545208a455a6e884008df48e9f">UClassID</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#acdf9fdcb5a7d838293537a6459eb997d">getDynamicClassID</a> () const </td></tr>
<tr class="memdesc:acdf9fdcb5a7d838293537a6459eb997d"><td class="mdescLeft"> </td><td class="mdescRight">ICU "poor man's RTTI", returns a UClassID for the actual class. <a href="#acdf9fdcb5a7d838293537a6459eb997d"></a><br/></td></tr>
<tr class="inherit_header pub_methods_classUObject"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_classUObject')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="classUObject.html">UObject</a></td></tr>
<tr class="memitem:ace22cf29a90641ef43350deae5bedb85 inherit pub_methods_classUObject"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classUObject.html#ace22cf29a90641ef43350deae5bedb85">~UObject</a> ()</td></tr>
<tr class="memdesc:ace22cf29a90641ef43350deae5bedb85 inherit pub_methods_classUObject"><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#ace22cf29a90641ef43350deae5bedb85"></a><br/></td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr class="memitem:a953781a8cc4ab8919c74d7b5633b4b06"><td class="memItemLeft" align="right" valign="top">static <a class="el" href="utypes_8h.html#a22af10545208a455a6e884008df48e9f">UClassID</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFieldPosition.html#a953781a8cc4ab8919c74d7b5633b4b06">getStaticClassID</a> ()</td></tr>
<tr class="memdesc:a953781a8cc4ab8919c74d7b5633b4b06"><td class="mdescLeft"> </td><td class="mdescRight">ICU "poor man's RTTI", returns a UClassID for this class. <a href="#a953781a8cc4ab8919c74d7b5633b4b06"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p><code><a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a></code> is a simple class used by <code><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a></code> and its subclasses to identify fields in formatted output. </p>
<p>Fields are identified by constants, whose names typically end with <code>_FIELD</code>, defined in the various subclasses of <code><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a></code>. See <code>ERA_FIELD</code> and its friends in <code><a class="el" href="classDateFormat.html" title="DateFormat is an abstract class for a family of classes that convert dates and times from their inter...">DateFormat</a></code> for an example.</p>
<p><code><a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a></code> keeps track of the position of the field within the formatted output with two indices: the index of the first character of the field and the index of the last character of the field.</p>
<p>One version of the <code>format</code> method in the various <code><a class="el" href="classFormat.html" title="Base class for all formats.">Format</a></code> classes requires a <code><a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a></code> object as an argument. You use this <code>format</code> method to perform partial formatting or to get information about the formatted output (such as the position of a field).</p>
<p>The <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a> class is not suitable for subclassing.</p>
<p>Below is an example of using <code><a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a></code> to aid alignment of an array of formatted floating-point numbers on their decimal points: </p>
<pre>
<div class="fragment"><div class="line"> <span class="keywordtype">double</span> doubleNum[] = {123456789.0, -12345678.9, 1234567.89, -123456.789,</div>
<div class="line"> 12345.6789, -1234.56789, 123.456789, -12.3456789, 1.23456789};</div>
<div class="line"> <span class="keywordtype">int</span> dNumSize = (int)(<span class="keyword">sizeof</span>(doubleNum)/<span class="keyword">sizeof</span>(double));</div>
<div class="line"> </div>
<div class="line"> <a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c" title="Error code to replace exception handling, so that the code is compatible with all C++ compilers...">UErrorCode</a> status = <a class="code" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78caa43dbfc9499c5f911d04e1a0ca3bf6f9" title="No error, no warning.">U_ZERO_ERROR</a>;</div>
<div class="line"> <a class="code" href="classDecimalFormat.html" title="DecimalFormat is a concrete subclass of NumberFormat that formats decimal numbers.">DecimalFormat</a>* fmt = (<a class="code" href="classDecimalFormat.html" title="DecimalFormat is a concrete subclass of NumberFormat that formats decimal numbers.">DecimalFormat</a>*) <a class="code" href="classNumberFormat.html#a2483fa1e87f3600395ff0c8f364f7b6f" title="Returns the default number format for the current default locale.">NumberFormat::createInstance</a>(status);</div>
<div class="line"> fmt-><a class="code" href="classDecimalFormat.html#a1c767fd7397fd26ca7c0bae7fdcf2343" title="Allows you to set the behavior of the decimal separator with integers.">setDecimalSeparatorAlwaysShown</a>(<span class="keyword">true</span>);</div>
<div class="line"> </div>
<div class="line"> <span class="keyword">const</span> <span class="keywordtype">int</span> tempLen = 20;</div>
<div class="line"> <span class="keywordtype">char</span> temp[tempLen];</div>
<div class="line"> </div>
<div class="line"> <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i=0; i<dNumSize; i++) {</div>
<div class="line"> <a class="code" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a> pos(<a class="code" href="classNumberFormat.html#aac1d8bfe4ccd2cdf6fa1a933b2df75a1a193401497626cb3ca7f4f9baabe1c123" title="These constants are provided for backwards compatibility only.">NumberFormat::INTEGER_FIELD</a>);</div>
<div class="line"> <a class="code" href="classUnicodeString.html" title="UnicodeString is a string class that stores Unicode characters directly and provides similar function...">UnicodeString</a> buf;</div>
<div class="line"> <span class="keywordtype">char</span> fmtText[tempLen];</div>
<div class="line"> ToCharString(fmt-><a class="code" href="classDecimalFormat.html#aed19f9279def60133b3122a2435ea568" title="Format a double or long number using base-10 representation.">format</a>(doubleNum[i], buf, pos), fmtText);</div>
<div class="line"> <span class="keywordflow">for</span> (<span class="keywordtype">int</span> j=0; j<tempLen; j++) temp[j] = <span class="charliteral">' '</span>; <span class="comment">// clear with spaces</span></div>
<div class="line"> temp[__min(tempLen, tempLen-pos.<a class="code" href="classFieldPosition.html#ad94244fb17162aa8a6629bd5e978f5d2" title="Retrieve the index of the character following the last character in the requested field...">getEndIndex</a>())] = <span class="charliteral">'\0'</span>;</div>
<div class="line"> cout << temp << fmtText << endl;</div>
<div class="line"> }</div>
<div class="line"> <span class="keyword">delete</span> fmt;</div>
</div><!-- fragment -->
</pre> <p>The code will generate the following output: </p>
<pre>
<div class="fragment"><div class="line"> 123,456,789.000</div>
<div class="line"> -12,345,678.900</div>
<div class="line"> 1,234,567.880</div>
<div class="line"> -123,456.789</div>
<div class="line"> 12,345.678</div>
<div class="line"> -1,234.567</div>
<div class="line"> 123.456</div>
<div class="line"> -12.345</div>
<div class="line"> 1.234</div>
</div><!-- fragment -->
</pre>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00106">106</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div><hr/><h2>Member Enumeration Documentation</h2>
<a class="anchor" id="ad16275b7a0b979762d161a741c54728c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">anonymous enum</td>
</tr>
</table>
</div><div class="memdoc">
<p>DONT_CARE may be specified as the field to indicate that the caller doesn't need to specify a field. </p>
<p>Do not subclass. </p>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00112">112</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a75a87d2e7d6d97217daff8e029a0f9b9"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">FieldPosition::FieldPosition </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Creates a <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a> object with a non-specified field. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002951">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00118">118</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<a class="anchor" id="aa03f4d3490bf5f56b797c36363bfae4f"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">FieldPosition::FieldPosition </td>
<td>(</td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>field</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Creates a <a class="el" href="classFieldPosition.html" title="FieldPosition is a simple class used by Format and its subclasses to identify fields in formatted out...">FieldPosition</a> object for the given field. </p>
<p>Fields are identified by constants, whose names typically end with _FIELD, in the various subclasses of <a class="el" href="classFormat.html" title="Base class for all formats.">Format</a>.</p>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="classNumberFormat.html#aac1d8bfe4ccd2cdf6fa1a933b2df75a1a193401497626cb3ca7f4f9baabe1c123" title="These constants are provided for backwards compatibility only.">NumberFormat::INTEGER_FIELD</a> </dd>
<dd>
NumberFormat::FRACTION_FIELD </dd>
<dd>
DateFormat::YEAR_FIELD </dd>
<dd>
DateFormat::MONTH_FIELD </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002952">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00132">132</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<a class="anchor" id="aee8d7c91df960f9f020b480e7b2fa628"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">FieldPosition::FieldPosition </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classFieldPosition.html">FieldPosition</a> & </td>
<td class="paramname"><em>copy</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy constructor. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">copy</td><td>the object to be copied from. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002953">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00140">140</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<a class="anchor" id="a29226fbee478ae6ff23ef868e7810793"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual FieldPosition::~FieldPosition </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Destructor. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002954">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a64641de3d32fedd8dcc7cf299cd1f9cb"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classFieldPosition.html">FieldPosition</a>* FieldPosition::clone </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Clone this object. </p>
<p>Clones can be used concurrently in multiple threads. If an error occurs, then NULL is returned. The caller must delete the clone.</p>
<dl class="section return"><dt>Returns:</dt><dd>a clone of this object</dd></dl>
<dl class="section see"><dt>See also:</dt><dd><a class="el" href="classFieldPosition.html#acdf9fdcb5a7d838293537a6459eb997d" title="ICU "poor man's RTTI", returns a UClassID for the actual class.">getDynamicClassID</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002958">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</div>
</div>
<a class="anchor" id="ac1b3be1343963a616b7eaf335437a2ff"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> FieldPosition::getBeginIndex </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Retrieve the index of the first character in the requested field. </p>
<dl class="section return"><dt>Returns:</dt><dd>the index of the first character in the requested field. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002960">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00197">197</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<a class="anchor" id="acdf9fdcb5a7d838293537a6459eb997d"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="utypes_8h.html#a22af10545208a455a6e884008df48e9f">UClassID</a> FieldPosition::getDynamicClassID </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>ICU "poor man's RTTI", returns a UClassID for the actual class. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002965">Stable:</a></b></dt><dd>ICU 2.2 </dd></dl>
<p>Implements <a class="el" href="classUObject.html#a9b1acc95efd89cb86ec31f2dc947a262">UObject</a>.</p>
</div>
</div>
<a class="anchor" id="ad94244fb17162aa8a6629bd5e978f5d2"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> FieldPosition::getEndIndex </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Retrieve the index of the character following the last character in the requested field. </p>
<dl class="section return"><dt>Returns:</dt><dd>the index of the character following the last character in the requested field. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002961">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00206">206</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<a class="anchor" id="ad62441dc0bcc91af346d78a3faca2812"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> FieldPosition::getField </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Retrieve the field identifier. </p>
<dl class="section return"><dt>Returns:</dt><dd>the field identifier. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002959">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00190">190</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<a class="anchor" id="a953781a8cc4ab8919c74d7b5633b4b06"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="utypes_8h.html#a22af10545208a455a6e884008df48e9f">UClassID</a> FieldPosition::getStaticClassID </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">static</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>ICU "poor man's RTTI", returns a UClassID for this class. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002966">Stable:</a></b></dt><dd>ICU 2.2 </dd></dl>
</div>
</div>
<a class="anchor" id="ad142ffe1884a49a2bf4d4073aa303038"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> FieldPosition::operator!= </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classFieldPosition.html">FieldPosition</a> & </td>
<td class="paramname"><em>that</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Equality operator. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">that</td><td>the object to be compared with. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>TRUE if the two field positions are not equal, FALSE otherwise. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002957">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00281">281</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
<p>References <a class="el" href="fieldpos_8h_source.html#l00273">operator==()</a>.</p>
</div>
</div>
<a class="anchor" id="a71afa3cf2ccf393943034c2c7d7eb7ce"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classFieldPosition.html">FieldPosition</a> & FieldPosition::operator= </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classFieldPosition.html">FieldPosition</a> & </td>
<td class="paramname"><em>copy</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Assignment operator. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">copy</td><td>the object to be copied from. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002955">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00264">264</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<a class="anchor" id="ae9dbfaa44ccd20e4eb792546df80e714"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> FieldPosition::operator== </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classFieldPosition.html">FieldPosition</a> & </td>
<td class="paramname"><em>that</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Equality operator. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">that</td><td>the object to be compared with. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns:</dt><dd>TRUE if the two field positions are equal, FALSE otherwise. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002956">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00273">273</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
<p>Referenced by <a class="el" href="fieldpos_8h_source.html#l00281">operator!=()</a>.</p>
</div>
</div>
<a class="anchor" id="ae08c2e084a51bc0602b374d5ac69d76f"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">void FieldPosition::setBeginIndex </td>
<td>(</td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>bi</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the begin index. </p>
<p>For use by subclasses of <a class="el" href="classFormat.html" title="Base class for all formats.">Format</a>. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">bi</td><td>the new value of the begin index </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002963">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00220">220</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<a class="anchor" id="a272f8398a2757804560771cc67d1f0f8"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">void FieldPosition::setEndIndex </td>
<td>(</td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>ei</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the end index. </p>
<p>For use by subclasses of <a class="el" href="classFormat.html" title="Base class for all formats.">Format</a>. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">ei</td><td>the new value of the end index </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002964">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00227">227</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<a class="anchor" id="aa5fab63fb11108011e818b7904648a98"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">void FieldPosition::setField </td>
<td>(</td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#ab1967d8591af1a4e48c37fd2b0f184d0">int32_t</a> </td>
<td class="paramname"><em>f</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the field. </p>
<dl class="params"><dt>Parameters:</dt><dd>
<table class="params">
<tr><td class="paramname">f</td><td>the new value of the field. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable002962">Stable:</a></b></dt><dd>ICU 2.0 </dd></dl>
<p>Definition at line <a class="el" href="fieldpos_8h_source.html#l00213">213</a> of file <a class="el" href="fieldpos_8h_source.html">fieldpos.h</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="fieldpos_8h_source.html">fieldpos.h</a></li>
</ul>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.1.1
</small></address>
</body>
</html>
