<!-- This comment will put IE 6, 7 and 8 in quirks mode -->
<!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"/>
<title>ICU 4.4: udatpg.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javaScript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body onload='searchBox.OnSelectItem(0);'>
<!-- Generated by Doxygen 1.6.1 -->
<script type="text/javascript"><!--
var searchBox = new SearchBox("searchBox", "search",false,'Search');
--></script>
<div class="navigation" id="top">
<div class="tabs">
<ul>
<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><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<img id="MSearchSelect" src="search/search.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)"/>
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</div>
</li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>udatpg.h File Reference</h1>
<p>C API: Wrapper for <a class="el" href="classDateTimePatternGenerator.html" title="This class provides flexible generation of date format patterns, like "yy-MM-dd"...">DateTimePatternGenerator</a> (<a class="el" href="dtptngen_8h.html" title="C++ API: Date/Time Pattern Generator.">unicode/dtptngen.h</a>).
<a href="#_details">More...</a></p>
<code>#include "<a class="el" href="utypes_8h_source.html">unicode/utypes.h</a>"</code><br/>
<code>#include "<a class="el" href="uenum_8h_source.html">unicode/uenum.h</a>"</code><br/>
<code>#include "<a class="el" href="localpointer_8h_source.html">unicode/localpointer.h</a>"</code><br/>
<p><a href="udatpg_8h_source.html">Go to the source code of this file.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Opaque type for a date/time pattern generator object. <a href="#a41aa5fa585671c3b2e0bb2e90c30c938"></a><br/></td></tr>
<tr><td colspan="2"><h2>Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a> { <br/>
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03af2e44039bb0fdb50c1bc31e323cbd46f">UDATPG_ERA_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03ada786243fbeffbcbe12445b05d82fa10">UDATPG_YEAR_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03a27e3bfb407c4501ef12c44885c803159">UDATPG_QUARTER_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03a5ef5a4c2d9ccc5b92a2636a012407f3e">UDATPG_MONTH_FIELD</a>,
<br/>
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03a131b4c49846539ea7d6283775156fe04">UDATPG_WEEK_OF_YEAR_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03aedbf1cb6a57ccbb9724799d67fbdc5bd">UDATPG_WEEK_OF_MONTH_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03a30f9a60cb9a8cba497ad1c1d3c6de2b8">UDATPG_WEEKDAY_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03a1f21860126aee872b3f7374e094494be">UDATPG_DAY_OF_YEAR_FIELD</a>,
<br/>
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03ad93d688d893ec8af8e79d429ec4468b9">UDATPG_DAY_OF_WEEK_IN_MONTH_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03a6a4cd711b9091a1d04b5097e3972284e">UDATPG_DAY_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03a421b7cfcfe7220c1732c91c46bb9e756">UDATPG_DAYPERIOD_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03aee102352c14977764c77a400f712f425">UDATPG_HOUR_FIELD</a>,
<br/>
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03afd1738fed5720fbec55be1cafdcb3f22">UDATPG_MINUTE_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03a6c41ab35226844ef8c401abff391599e">UDATPG_SECOND_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03aa5f9e4af321282b3c14e2d076b678b99">UDATPG_FRACTIONAL_SECOND_FIELD</a>,
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03a76bb9f23123d7a1e047b8cb100328e91">UDATPG_ZONE_FIELD</a>,
<br/>
<a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03ae543fb494963248f8de19b1f9d0990a0">UDATPG_FIELD_COUNT</a>
<br/>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><p>Field number constants for udatpg_getAppendItemFormats() and similar functions. </p>
<a href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8">UDateTimePatternMatchOptions</a> { <br/>
<a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8a7ecba3f1d8b2a1dbcfb481edaf7f66f8">UDATPG_MATCH_NO_OPTIONS</a> = 0,
<a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8a2f95b1bbaa929dca304c83f032d2568a">UDATPG_MATCH_HOUR_FIELD_LENGTH</a> = 1 << UDATPG_HOUR_FIELD,
<a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8a64df7efaaaff19e66b11c51a66c4203b">UDATPG_MATCH_MINUTE_FIELD_LENGTH</a> = 1 << UDATPG_MINUTE_FIELD,
<a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8a6fc13c4f3c6d449326a6322215a0ea44">UDATPG_MATCH_SECOND_FIELD_LENGTH</a> = 1 << UDATPG_SECOND_FIELD,
<br/>
<a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8aee4494e2b7e68a780cf2f4aef195d99c">UDATPG_MATCH_ALL_FIELDS_LENGTH</a> = (1 << UDATPG_FIELD_COUNT) - 1
<br/>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><p>Masks to control forcing the length of specified fields in the returned pattern to match those in the skeleton (when this would not happen otherwise). </p>
<a href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8">More...</a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a8ecf3c8a68ecb811372c59fa2cfad265">UDateTimePatternConflict</a> { <a class="el" href="udatpg_8h.html#a8ecf3c8a68ecb811372c59fa2cfad265a10a25e59dcbd298663b28a6380b5cff0">UDATPG_NO_CONFLICT</a>,
<a class="el" href="udatpg_8h.html#a8ecf3c8a68ecb811372c59fa2cfad265a23c5ecebe90224a7d0718fd299939364">UDATPG_BASE_CONFLICT</a>,
<a class="el" href="udatpg_8h.html#a8ecf3c8a68ecb811372c59fa2cfad265a4a4e59e2d5069c00e8e5d65083462a59">UDATPG_CONFLICT</a>,
<a class="el" href="udatpg_8h.html#a8ecf3c8a68ecb811372c59fa2cfad265a591345f6cf30ead875319f22ae6ded00">UDATPG_CONFLICT_COUNT</a>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><p>Status return values from <a class="el" href="udatpg_8h.html#aa581b798ce7c2d3e628cae3fb1ff7911" title="Adds a pattern to the generator.">udatpg_addPattern()</a>. </p>
<a href="udatpg_8h.html#a8ecf3c8a68ecb811372c59fa2cfad265">More...</a><br/></td></tr>
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a7a625f7855a743cd377ea9cb2f8cb624">udatpg_open</a> (const char *locale, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Open a generator according to a given locale. <a href="#a7a625f7855a743cd377ea9cb2f8cb624"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a76faa83bca85eda47918b721f7de0fcf">udatpg_openEmpty</a> (<a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Open an empty generator, to be constructed with udatpg_addPattern(. <a href="#a76faa83bca85eda47918b721f7de0fcf"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a2cfa97e0f00c6f439897fe37a2c0f07a">udatpg_close</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Close a generator. <a href="#a2cfa97e0f00c6f439897fe37a2c0f07a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a5452d195a0646510502d660313bd5226">udatpg_clone</a> (const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a copy pf a generator. <a href="#a5452d195a0646510502d660313bd5226"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a7f844bceff859d32de49583e3d496ac4">udatpg_getBestPattern</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *skeleton, int32_t length, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *bestPattern, int32_t capacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the best pattern matching the input skeleton. <a href="#a7f844bceff859d32de49583e3d496ac4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a5327a64b164f975dc0636e36b4d0f02c">udatpg_getBestPatternWithOptions</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *skeleton, int32_t length, <a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8">UDateTimePatternMatchOptions</a> options, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *bestPattern, int32_t capacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the best pattern matching the input skeleton. <a href="#a5327a64b164f975dc0636e36b4d0f02c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#aecc7ea9afef72acc5d3e234345491714">udatpg_getSkeleton</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *pattern, int32_t length, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *skeleton, int32_t capacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a unique skeleton from a given pattern. <a href="#aecc7ea9afef72acc5d3e234345491714"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a62d4bb2d90262895efa94037a9946a22">udatpg_getBaseSkeleton</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *pattern, int32_t length, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *baseSkeleton, int32_t capacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a unique base skeleton from a given pattern. <a href="#a62d4bb2d90262895efa94037a9946a22"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="udatpg_8h.html#a8ecf3c8a68ecb811372c59fa2cfad265">UDateTimePatternConflict</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#aa581b798ce7c2d3e628cae3fb1ff7911">udatpg_addPattern</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *pattern, int32_t patternLength, <a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> override, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *conflictingPattern, int32_t capacity, int32_t *pLength, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adds a pattern to the generator. <a href="#aa581b798ce7c2d3e628cae3fb1ff7911"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#ac21e5486c0133a59974ea21d27aa36a1">udatpg_setAppendItemFormat</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, <a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a> field, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *value, int32_t length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">An AppendItem format is a pattern used to append a field if there is no good match. <a href="#ac21e5486c0133a59974ea21d27aa36a1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#af68f6d3ddf8fb56fc31b0c7fb58a5f69">udatpg_getAppendItemFormat</a> (const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, <a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a> field, int32_t *pLength)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Getter corresponding to setAppendItemFormat. <a href="#af68f6d3ddf8fb56fc31b0c7fb58a5f69"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a54de436656a76b55998e7440cc378723">udatpg_setAppendItemName</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, <a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a> field, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *value, int32_t length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the name of field, eg "era" in English for ERA. <a href="#a54de436656a76b55998e7440cc378723"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a9b602c32d604b0f6639573cf2f62e2ee">udatpg_getAppendItemName</a> (const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, <a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a> field, int32_t *pLength)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Getter corresponding to setAppendItemNames. <a href="#a9b602c32d604b0f6639573cf2f62e2ee"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a5f7d6e89623cb906780881fc3bb4e975">udatpg_setDateTimeFormat</a> (const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dtFormat, int32_t length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The date time format is a message format pattern used to compose date and time patterns. <a href="#a5f7d6e89623cb906780881fc3bb4e975"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a815c3413aca5b156f12a6cf2581e270a">udatpg_getDateTimeFormat</a> (const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, int32_t *pLength)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Getter corresponding to setDateTimeFormat. <a href="#a815c3413aca5b156f12a6cf2581e270a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a595cae32436b43fbb4fd6f770d96b81f">udatpg_setDecimal</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *decimal, int32_t length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The decimal value is used in formatting fractions of seconds. <a href="#a595cae32436b43fbb4fd6f770d96b81f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#af24619c8b3f95646024cb883a5cd45e4">udatpg_getDecimal</a> (const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, int32_t *pLength)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Getter corresponding to setDecimal. <a href="#af24619c8b3f95646024cb883a5cd45e4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a84dfd1c80ca5b49b4eb5f398ed460961">udatpg_replaceFieldTypes</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *pattern, int32_t patternLength, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *skeleton, int32_t skeletonLength, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adjusts the field types (width and subtype) of a pattern to match what is in a skeleton. <a href="#a84dfd1c80ca5b49b4eb5f398ed460961"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#ab88c803cfacf7b9b0cd91a1bb30f858b">udatpg_replaceFieldTypesWithOptions</a> (<a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *pattern, int32_t patternLength, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *skeleton, int32_t skeletonLength, <a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8">UDateTimePatternMatchOptions</a> options, <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *dest, int32_t destCapacity, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Adjusts the field types (width and subtype) of a pattern to match what is in a skeleton. <a href="#ab88c803cfacf7b9b0cd91a1bb30f858b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#aadb81a35ebc9c6b799c2d10e62182031">udatpg_openSkeletons</a> (const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return a UEnumeration list of all the skeletons in canonical form. <a href="#aadb81a35ebc9c6b799c2d10e62182031"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a9bcfb46c6f4f0d9c38306e869f2a9c10">udatpg_openBaseSkeletons</a> (const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> *pErrorCode)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return a UEnumeration list of all the base skeletons in canonical form. <a href="#a9bcfb46c6f4f0d9c38306e869f2a9c10"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="udatpg_8h.html#a08cd0d48bbecc5a55deeafaff4e65b9a">udatpg_getPatternForSkeleton</a> (const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> *dtpg, const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> *skeleton, int32_t skeletonLength, int32_t *pLength)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the pattern corresponding to a given skeleton. <a href="#a08cd0d48bbecc5a55deeafaff4e65b9a"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>C API: Wrapper for <a class="el" href="classDateTimePatternGenerator.html" title="This class provides flexible generation of date format patterns, like "yy-MM-dd"...">DateTimePatternGenerator</a> (<a class="el" href="dtptngen_8h.html" title="C++ API: Date/Time Pattern Generator.">unicode/dtptngen.h</a>). </p>
<p>UDateTimePatternGenerator provides flexible generation of date format patterns, like "yy-MM-dd". The user can build up the generator by adding successive patterns. Once that is done, a query can be made using a "skeleton", which is a pattern which just includes the desired fields and lengths. The generator will return the "best fit" pattern corresponding to that skeleton. </p>
<p>The main method people will use is udatpg_getBestPattern, since normally UDateTimePatternGenerator is pre-built with data from a particular locale. However, generators can be built directly from other data as well. </p>
<p><em>Issue: may be useful to also have a function that returns the list of fields in a pattern, in order, since we have that internally. That would be useful for getting the UI order of field elements.</em> </p>
<p>Definition in file <a class="el" href="udatpg_8h_source.html">udatpg.h</a>.</p>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="a41aa5fa585671c3b2e0bb2e90c30c938"></a><!-- doxytag: member="udatpg.h::UDateTimePatternGenerator" ref="a41aa5fa585671c3b2e0bb2e90c30c938" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void* <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Opaque type for a date/time pattern generator object. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003664">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
<p>Definition at line <a class="el" href="udatpg_8h_source.html#l00045">45</a> of file <a class="el" href="udatpg_8h_source.html">udatpg.h</a>.</p>
</div>
</div>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="a8ecf3c8a68ecb811372c59fa2cfad265"></a><!-- doxytag: member="udatpg.h::UDateTimePatternConflict" ref="a8ecf3c8a68ecb811372c59fa2cfad265" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="udatpg_8h.html#a8ecf3c8a68ecb811372c59fa2cfad265">UDateTimePatternConflict</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Status return values from <a class="el" href="udatpg_8h.html#aa581b798ce7c2d3e628cae3fb1ff7911" title="Adds a pattern to the generator.">udatpg_addPattern()</a>. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003666">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="a8ecf3c8a68ecb811372c59fa2cfad265a10a25e59dcbd298663b28a6380b5cff0"></a><!-- doxytag: member="UDATPG_NO_CONFLICT" ref="a8ecf3c8a68ecb811372c59fa2cfad265a10a25e59dcbd298663b28a6380b5cff0" args="" -->UDATPG_NO_CONFLICT</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003704">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a8ecf3c8a68ecb811372c59fa2cfad265a23c5ecebe90224a7d0718fd299939364"></a><!-- doxytag: member="UDATPG_BASE_CONFLICT" ref="a8ecf3c8a68ecb811372c59fa2cfad265a23c5ecebe90224a7d0718fd299939364" args="" -->UDATPG_BASE_CONFLICT</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003705">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a8ecf3c8a68ecb811372c59fa2cfad265a4a4e59e2d5069c00e8e5d65083462a59"></a><!-- doxytag: member="UDATPG_CONFLICT" ref="a8ecf3c8a68ecb811372c59fa2cfad265a4a4e59e2d5069c00e8e5d65083462a59" args="" -->UDATPG_CONFLICT</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003706">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="a8ecf3c8a68ecb811372c59fa2cfad265a591345f6cf30ead875319f22ae6ded00"></a><!-- doxytag: member="UDATPG_CONFLICT_COUNT" ref="a8ecf3c8a68ecb811372c59fa2cfad265a591345f6cf30ead875319f22ae6ded00" args="" -->UDATPG_CONFLICT_COUNT</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003707">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="udatpg_8h_source.html#l00114">114</a> of file <a class="el" href="udatpg_8h_source.html">udatpg.h</a>.</p>
</div>
</div>
<a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03"></a><!-- doxytag: member="udatpg.h::UDateTimePatternField" ref="af4ac5e0a850e2f49084fc0bcfc07ed03" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Field number constants for udatpg_getAppendItemFormats() and similar functions. </p>
<p>These constants are separate from UDateFormatField despite semantic overlap because some fields are merged for the date/time pattern generator. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003665">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03af2e44039bb0fdb50c1bc31e323cbd46f"></a><!-- doxytag: member="UDATPG_ERA_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03af2e44039bb0fdb50c1bc31e323cbd46f" args="" -->UDATPG_ERA_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003687">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03ada786243fbeffbcbe12445b05d82fa10"></a><!-- doxytag: member="UDATPG_YEAR_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03ada786243fbeffbcbe12445b05d82fa10" args="" -->UDATPG_YEAR_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003688">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03a27e3bfb407c4501ef12c44885c803159"></a><!-- doxytag: member="UDATPG_QUARTER_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03a27e3bfb407c4501ef12c44885c803159" args="" -->UDATPG_QUARTER_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003689">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03a5ef5a4c2d9ccc5b92a2636a012407f3e"></a><!-- doxytag: member="UDATPG_MONTH_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03a5ef5a4c2d9ccc5b92a2636a012407f3e" args="" -->UDATPG_MONTH_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003690">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03a131b4c49846539ea7d6283775156fe04"></a><!-- doxytag: member="UDATPG_WEEK_OF_YEAR_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03a131b4c49846539ea7d6283775156fe04" args="" -->UDATPG_WEEK_OF_YEAR_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003691">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03aedbf1cb6a57ccbb9724799d67fbdc5bd"></a><!-- doxytag: member="UDATPG_WEEK_OF_MONTH_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03aedbf1cb6a57ccbb9724799d67fbdc5bd" args="" -->UDATPG_WEEK_OF_MONTH_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003692">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03a30f9a60cb9a8cba497ad1c1d3c6de2b8"></a><!-- doxytag: member="UDATPG_WEEKDAY_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03a30f9a60cb9a8cba497ad1c1d3c6de2b8" args="" -->UDATPG_WEEKDAY_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003693">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03a1f21860126aee872b3f7374e094494be"></a><!-- doxytag: member="UDATPG_DAY_OF_YEAR_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03a1f21860126aee872b3f7374e094494be" args="" -->UDATPG_DAY_OF_YEAR_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003694">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03ad93d688d893ec8af8e79d429ec4468b9"></a><!-- doxytag: member="UDATPG_DAY_OF_WEEK_IN_MONTH_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03ad93d688d893ec8af8e79d429ec4468b9" args="" -->UDATPG_DAY_OF_WEEK_IN_MONTH_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003695">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03a6a4cd711b9091a1d04b5097e3972284e"></a><!-- doxytag: member="UDATPG_DAY_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03a6a4cd711b9091a1d04b5097e3972284e" args="" -->UDATPG_DAY_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003696">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03a421b7cfcfe7220c1732c91c46bb9e756"></a><!-- doxytag: member="UDATPG_DAYPERIOD_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03a421b7cfcfe7220c1732c91c46bb9e756" args="" -->UDATPG_DAYPERIOD_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003697">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03aee102352c14977764c77a400f712f425"></a><!-- doxytag: member="UDATPG_HOUR_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03aee102352c14977764c77a400f712f425" args="" -->UDATPG_HOUR_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003698">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03afd1738fed5720fbec55be1cafdcb3f22"></a><!-- doxytag: member="UDATPG_MINUTE_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03afd1738fed5720fbec55be1cafdcb3f22" args="" -->UDATPG_MINUTE_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003699">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03a6c41ab35226844ef8c401abff391599e"></a><!-- doxytag: member="UDATPG_SECOND_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03a6c41ab35226844ef8c401abff391599e" args="" -->UDATPG_SECOND_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003700">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03aa5f9e4af321282b3c14e2d076b678b99"></a><!-- doxytag: member="UDATPG_FRACTIONAL_SECOND_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03aa5f9e4af321282b3c14e2d076b678b99" args="" -->UDATPG_FRACTIONAL_SECOND_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003701">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03a76bb9f23123d7a1e047b8cb100328e91"></a><!-- doxytag: member="UDATPG_ZONE_FIELD" ref="af4ac5e0a850e2f49084fc0bcfc07ed03a76bb9f23123d7a1e047b8cb100328e91" args="" -->UDATPG_ZONE_FIELD</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003702">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="af4ac5e0a850e2f49084fc0bcfc07ed03ae543fb494963248f8de19b1f9d0990a0"></a><!-- doxytag: member="UDATPG_FIELD_COUNT" ref="af4ac5e0a850e2f49084fc0bcfc07ed03ae543fb494963248f8de19b1f9d0990a0" args="" -->UDATPG_FIELD_COUNT</em> </td><td>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003703">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="udatpg_8h_source.html#l00053">53</a> of file <a class="el" href="udatpg_8h_source.html">udatpg.h</a>.</p>
</div>
</div>
<a class="anchor" id="ab3c76ea5c08e4acb44e0ddc66c5831e8"></a><!-- doxytag: member="udatpg.h::UDateTimePatternMatchOptions" ref="ab3c76ea5c08e4acb44e0ddc66c5831e8" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8">UDateTimePatternMatchOptions</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Masks to control forcing the length of specified fields in the returned pattern to match those in the skeleton (when this would not happen otherwise). </p>
<p>These may be combined to force the length of multiple fields. Used with udatpg_getBestPatternWithOptions, udatpg_replaceFieldTypesWithOptions. </p>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000216">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.4 </dd></dl>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ab3c76ea5c08e4acb44e0ddc66c5831e8a7ecba3f1d8b2a1dbcfb481edaf7f66f8"></a><!-- doxytag: member="UDATPG_MATCH_NO_OPTIONS" ref="ab3c76ea5c08e4acb44e0ddc66c5831e8a7ecba3f1d8b2a1dbcfb481edaf7f66f8" args="" -->UDATPG_MATCH_NO_OPTIONS</em> </td><td>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000219">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.4 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ab3c76ea5c08e4acb44e0ddc66c5831e8a2f95b1bbaa929dca304c83f032d2568a"></a><!-- doxytag: member="UDATPG_MATCH_HOUR_FIELD_LENGTH" ref="ab3c76ea5c08e4acb44e0ddc66c5831e8a2f95b1bbaa929dca304c83f032d2568a" args="" -->UDATPG_MATCH_HOUR_FIELD_LENGTH</em> </td><td>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000220">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.4 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ab3c76ea5c08e4acb44e0ddc66c5831e8a64df7efaaaff19e66b11c51a66c4203b"></a><!-- doxytag: member="UDATPG_MATCH_MINUTE_FIELD_LENGTH" ref="ab3c76ea5c08e4acb44e0ddc66c5831e8a64df7efaaaff19e66b11c51a66c4203b" args="" -->UDATPG_MATCH_MINUTE_FIELD_LENGTH</em> </td><td>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000388">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. ICU 4.4 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ab3c76ea5c08e4acb44e0ddc66c5831e8a6fc13c4f3c6d449326a6322215a0ea44"></a><!-- doxytag: member="UDATPG_MATCH_SECOND_FIELD_LENGTH" ref="ab3c76ea5c08e4acb44e0ddc66c5831e8a6fc13c4f3c6d449326a6322215a0ea44" args="" -->UDATPG_MATCH_SECOND_FIELD_LENGTH</em> </td><td>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000389">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. ICU 4.4 </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ab3c76ea5c08e4acb44e0ddc66c5831e8aee4494e2b7e68a780cf2f4aef195d99c"></a><!-- doxytag: member="UDATPG_MATCH_ALL_FIELDS_LENGTH" ref="ab3c76ea5c08e4acb44e0ddc66c5831e8aee4494e2b7e68a780cf2f4aef195d99c" args="" -->UDATPG_MATCH_ALL_FIELDS_LENGTH</em> </td><td>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000221">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.4 </dd></dl>
</td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="udatpg_8h_source.html#l00097">97</a> of file <a class="el" href="udatpg_8h_source.html">udatpg.h</a>.</p>
</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="aa581b798ce7c2d3e628cae3fb1ff7911"></a><!-- doxytag: member="udatpg.h::udatpg_addPattern" ref="aa581b798ce7c2d3e628cae3fb1ff7911" args="(UDateTimePatternGenerator *dtpg, const UChar *pattern, int32_t patternLength, UBool override, UChar *conflictingPattern, int32_t capacity, int32_t *pLength, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="udatpg_8h.html#a8ecf3c8a68ecb811372c59fa2cfad265">UDateTimePatternConflict</a> udatpg_addPattern </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>pattern</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>patternLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a349ef00011f20ccd1d3b424445681aa5">UBool</a> </td>
<td class="paramname"> <em>override</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>conflictingPattern</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>capacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"> <em>pLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds a pattern to the generator. </p>
<p>If the pattern has the same skeleton as an existing pattern, and the override parameter is set, then the previous value is overriden. Otherwise, the previous value is retained. In either case, the conflicting status is set and previous vale is stored in conflicting pattern. </p>
<p>Note that single-field patterns (like "MMM") are automatically added, and don't need to be added explicitly!</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pattern</em> </td><td>input pattern, such as "dd/MMM" </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternLength</em> </td><td>the length of pattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>override</em> </td><td>When existing values are to be overridden use true, otherwise use false. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>conflictingPattern</em> </td><td>Previous pattern with the same skeleton. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>capacity</em> </td><td>the capacity of conflictingPattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pLength</em> </td><td>a pointer to the length of conflictingPattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>conflicting status. The value could be UDATPG_NO_CONFLICT, UDATPG_BASE_CONFLICT or UDATPG_CONFLICT. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003674">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a5452d195a0646510502d660313bd5226"></a><!-- doxytag: member="udatpg.h::udatpg_clone" ref="a5452d195a0646510502d660313bd5226" args="(const UDateTimePatternGenerator *dtpg, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a>* udatpg_clone </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Create a copy pf a generator. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator to be copied. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to a new UDateTimePatternGenerator. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003670">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a2cfa97e0f00c6f439897fe37a2c0f07a"></a><!-- doxytag: member="udatpg.h::udatpg_close" ref="a2cfa97e0f00c6f439897fe37a2c0f07a" args="(UDateTimePatternGenerator *dtpg)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void udatpg_close </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Close a generator. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003669">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="af68f6d3ddf8fb56fc31b0c7fb58a5f69"></a><!-- doxytag: member="udatpg.h::udatpg_getAppendItemFormat" ref="af68f6d3ddf8fb56fc31b0c7fb58a5f69" args="(const UDateTimePatternGenerator *dtpg, UDateTimePatternField field, int32_t *pLength)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* udatpg_getAppendItemFormat </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a> </td>
<td class="paramname"> <em>field</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"> <em>pLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Getter corresponding to setAppendItemFormat. </p>
<p>Values below 0 or at or above UDATPG_FIELD_COUNT are illegal arguments.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>A pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>field</em> </td><td>UDateTimePatternField, such as UDATPG_ERA_FIELD </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pLength</em> </td><td>A pointer that will receive the length of appendItemFormat. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>appendItemFormat for field. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003676">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a9b602c32d604b0f6639573cf2f62e2ee"></a><!-- doxytag: member="udatpg.h::udatpg_getAppendItemName" ref="a9b602c32d604b0f6639573cf2f62e2ee" args="(const UDateTimePatternGenerator *dtpg, UDateTimePatternField field, int32_t *pLength)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* udatpg_getAppendItemName </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a> </td>
<td class="paramname"> <em>field</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"> <em>pLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Getter corresponding to setAppendItemNames. </p>
<p>Values below 0 or at or above UDATPG_FIELD_COUNT are illegal arguments.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>field</em> </td><td>UDateTimePatternField, such as UDATPG_ERA_FIELD </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pLength</em> </td><td>A pointer that will receive the length of the name for field. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>name for field </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003678">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a62d4bb2d90262895efa94037a9946a22"></a><!-- doxytag: member="udatpg.h::udatpg_getBaseSkeleton" ref="a62d4bb2d90262895efa94037a9946a22" args="(UDateTimePatternGenerator *dtpg, const UChar *pattern, int32_t length, UChar *baseSkeleton, int32_t capacity, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t udatpg_getBaseSkeleton </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>pattern</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>baseSkeleton</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>capacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a unique base skeleton from a given pattern. </p>
<p>This is the same as the skeleton, except that differences in length are minimized so as to only preserve the difference between string and numeric form. So for example, both "MMM-dd" and "d/MMM" produce the skeleton "MMMd" (notice the single d).</p>
<p>Note that this function uses a non-const UDateTimePatternGenerator: It uses a stateful pattern parser which is set up for each generator object, rather than creating one for each function call. Consecutive calls to this function do not affect each other, but this function cannot be used concurrently on a single generator object.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pattern</em> </td><td>input pattern, such as "dd/MMM". </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>the length of pattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>baseSkeleton</em> </td><td>such as "Md" </td></tr>
<tr><td valign="top"></td><td valign="top"><em>capacity</em> </td><td>the capacity of base skeleton. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the length of baseSkeleton. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003673">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a7f844bceff859d32de49583e3d496ac4"></a><!-- doxytag: member="udatpg.h::udatpg_getBestPattern" ref="a7f844bceff859d32de49583e3d496ac4" args="(UDateTimePatternGenerator *dtpg, const UChar *skeleton, int32_t length, UChar *bestPattern, int32_t capacity, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t udatpg_getBestPattern </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>skeleton</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>bestPattern</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>capacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the best pattern matching the input skeleton. </p>
<p>It is guaranteed to have all of the fields in the skeleton.</p>
<p>Note that this function uses a non-const UDateTimePatternGenerator: It uses a stateful pattern parser which is set up for each generator object, rather than creating one for each function call. Consecutive calls to this function do not affect each other, but this function cannot be used concurrently on a single generator object.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>skeleton</em> </td><td>The skeleton is a pattern containing only the variable fields. For example, "MMMdd" and "mmhh" are skeletons. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>the length of skeleton </td></tr>
<tr><td valign="top"></td><td valign="top"><em>bestPattern</em> </td><td>The best pattern found from the given skeleton. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>capacity</em> </td><td>the capacity of bestPattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the length of bestPattern. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003671">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a5327a64b164f975dc0636e36b4d0f02c"></a><!-- doxytag: member="udatpg.h::udatpg_getBestPatternWithOptions" ref="a5327a64b164f975dc0636e36b4d0f02c" args="(UDateTimePatternGenerator *dtpg, const UChar *skeleton, int32_t length, UDateTimePatternMatchOptions options, UChar *bestPattern, int32_t capacity, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t udatpg_getBestPatternWithOptions </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>skeleton</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8">UDateTimePatternMatchOptions</a> </td>
<td class="paramname"> <em>options</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>bestPattern</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>capacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the best pattern matching the input skeleton. </p>
<p>It is guaranteed to have all of the fields in the skeleton.</p>
<p>Note that this function uses a non-const UDateTimePatternGenerator: It uses a stateful pattern parser which is set up for each generator object, rather than creating one for each function call. Consecutive calls to this function do not affect each other, but this function cannot be used concurrently on a single generator object.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>skeleton</em> </td><td>The skeleton is a pattern containing only the variable fields. For example, "MMMdd" and "mmhh" are skeletons. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>the length of skeleton </td></tr>
<tr><td valign="top"></td><td valign="top"><em>options</em> </td><td>Options for forcing the length of specified fields in the returned pattern to match those in the skeleton (when this would not happen otherwise). For default behavior, use UDATPG_MATCH_NO_OPTIONS. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>bestPattern</em> </td><td>The best pattern found from the given skeleton. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>capacity</em> </td><td>the capacity of bestPattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the length of bestPattern. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000217">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.4 </dd></dl>
</div>
</div>
<a class="anchor" id="a815c3413aca5b156f12a6cf2581e270a"></a><!-- doxytag: member="udatpg.h::udatpg_getDateTimeFormat" ref="a815c3413aca5b156f12a6cf2581e270a" args="(const UDateTimePatternGenerator *dtpg, int32_t *pLength)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* udatpg_getDateTimeFormat </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"> <em>pLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Getter corresponding to setDateTimeFormat. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pLength</em> </td><td>A pointer that will receive the length of the format </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>dateTimeFormat. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003680">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="af24619c8b3f95646024cb883a5cd45e4"></a><!-- doxytag: member="udatpg.h::udatpg_getDecimal" ref="af24619c8b3f95646024cb883a5cd45e4" args="(const UDateTimePatternGenerator *dtpg, int32_t *pLength)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* udatpg_getDecimal </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"> <em>pLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Getter corresponding to setDecimal. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pLength</em> </td><td>A pointer that will receive the length of the decimal string. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>corresponding to the decimal point. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003682">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a08cd0d48bbecc5a55deeafaff4e65b9a"></a><!-- doxytag: member="udatpg.h::udatpg_getPatternForSkeleton" ref="a08cd0d48bbecc5a55deeafaff4e65b9a" args="(const UDateTimePatternGenerator *dtpg, const UChar *skeleton, int32_t skeletonLength, int32_t *pLength)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a>* udatpg_getPatternForSkeleton </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>skeleton</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>skeletonLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t * </td>
<td class="paramname"> <em>pLength</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the pattern corresponding to a given skeleton. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>skeleton</em> </td><td></td></tr>
<tr><td valign="top"></td><td valign="top"><em>skeletonLength</em> </td><td>pointer to the length of skeleton. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pLength</em> </td><td>pointer to the length of return pattern. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>pattern corresponding to a given skeleton. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003686">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="aecc7ea9afef72acc5d3e234345491714"></a><!-- doxytag: member="udatpg.h::udatpg_getSkeleton" ref="aecc7ea9afef72acc5d3e234345491714" args="(UDateTimePatternGenerator *dtpg, const UChar *pattern, int32_t length, UChar *skeleton, int32_t capacity, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t udatpg_getSkeleton </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>pattern</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>length</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>skeleton</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>capacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get a unique skeleton from a given pattern. </p>
<p>For example, both "MMM-dd" and "dd/MMM" produce the skeleton "MMMdd".</p>
<p>Note that this function uses a non-const UDateTimePatternGenerator: It uses a stateful pattern parser which is set up for each generator object, rather than creating one for each function call. Consecutive calls to this function do not affect each other, but this function cannot be used concurrently on a single generator object.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pattern</em> </td><td>input pattern, such as "dd/MMM". </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>the length of pattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>skeleton</em> </td><td>such as "MMMdd" </td></tr>
<tr><td valign="top"></td><td valign="top"><em>capacity</em> </td><td>the capacity of skeleton. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the length of skeleton. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003672">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a7a625f7855a743cd377ea9cb2f8cb624"></a><!-- doxytag: member="udatpg.h::udatpg_open" ref="a7a625f7855a743cd377ea9cb2f8cb624" args="(const char *locale, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a>* udatpg_open </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>locale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Open a generator according to a given locale. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>locale</em> </td><td></td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to UDateTimePatternGenerator. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003667">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a9bcfb46c6f4f0d9c38306e869f2a9c10"></a><!-- doxytag: member="udatpg.h::udatpg_openBaseSkeletons" ref="a9bcfb46c6f4f0d9c38306e869f2a9c10" args="(const UDateTimePatternGenerator *dtpg, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a>* udatpg_openBaseSkeletons </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return a UEnumeration list of all the base skeletons in canonical form. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a UEnumeration list of all the base skeletons The caller must close the object. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003685">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a76faa83bca85eda47918b721f7de0fcf"></a><!-- doxytag: member="udatpg.h::udatpg_openEmpty" ref="a76faa83bca85eda47918b721f7de0fcf" args="(UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a>* udatpg_openEmpty </td>
<td>(</td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Open an empty generator, to be constructed with udatpg_addPattern(. </p>
<p>..) etc. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to UDateTimePatternGenerator. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003668">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="aadb81a35ebc9c6b799c2d10e62182031"></a><!-- doxytag: member="udatpg.h::udatpg_openSkeletons" ref="aadb81a35ebc9c6b799c2d10e62182031" args="(const UDateTimePatternGenerator *dtpg, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="uenum_8h.html#a32b7253b2148022535be36a9fcdb5a8d">UEnumeration</a>* udatpg_openSkeletons </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return a UEnumeration list of all the skeletons in canonical form. </p>
<p>Call <a class="el" href="udatpg_8h.html#a08cd0d48bbecc5a55deeafaff4e65b9a" title="Get the pattern corresponding to a given skeleton.">udatpg_getPatternForSkeleton()</a> to get the corresponding pattern.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a UEnumeration list of all the skeletons The caller must close the object. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003684">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a84dfd1c80ca5b49b4eb5f398ed460961"></a><!-- doxytag: member="udatpg.h::udatpg_replaceFieldTypes" ref="a84dfd1c80ca5b49b4eb5f398ed460961" args="(UDateTimePatternGenerator *dtpg, const UChar *pattern, int32_t patternLength, const UChar *skeleton, int32_t skeletonLength, UChar *dest, int32_t destCapacity, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t udatpg_replaceFieldTypes </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>pattern</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>patternLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>skeleton</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>skeletonLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>destCapacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adjusts the field types (width and subtype) of a pattern to match what is in a skeleton. </p>
<p>That is, if you supply a pattern like "d-M H:m", and a skeleton of "MMMMddhhmm", then the input pattern is adjusted to be "dd-MMMM hh:mm". This is used internally to get the best match for the input skeleton, but can also be used externally.</p>
<p>Note that this function uses a non-const UDateTimePatternGenerator: It uses a stateful pattern parser which is set up for each generator object, rather than creating one for each function call. Consecutive calls to this function do not affect each other, but this function cannot be used concurrently on a single generator object.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pattern</em> </td><td>Input pattern </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternLength</em> </td><td>the length of input pattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>skeleton</em> </td><td></td></tr>
<tr><td valign="top"></td><td valign="top"><em>skeletonLength</em> </td><td>the length of input skeleton. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest</em> </td><td>pattern adjusted to match the skeleton fields widths and subtypes. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>destCapacity</em> </td><td>the capacity of dest. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the length of dest. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003683">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="ab88c803cfacf7b9b0cd91a1bb30f858b"></a><!-- doxytag: member="udatpg.h::udatpg_replaceFieldTypesWithOptions" ref="ab88c803cfacf7b9b0cd91a1bb30f858b" args="(UDateTimePatternGenerator *dtpg, const UChar *pattern, int32_t patternLength, const UChar *skeleton, int32_t skeletonLength, UDateTimePatternMatchOptions options, UChar *dest, int32_t destCapacity, UErrorCode *pErrorCode)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int32_t udatpg_replaceFieldTypesWithOptions </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>pattern</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>patternLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>skeleton</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>skeletonLength</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#ab3c76ea5c08e4acb44e0ddc66c5831e8">UDateTimePatternMatchOptions</a> </td>
<td class="paramname"> <em>options</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>destCapacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> * </td>
<td class="paramname"> <em>pErrorCode</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adjusts the field types (width and subtype) of a pattern to match what is in a skeleton. </p>
<p>That is, if you supply a pattern like "d-M H:m", and a skeleton of "MMMMddhhmm", then the input pattern is adjusted to be "dd-MMMM hh:mm". This is used internally to get the best match for the input skeleton, but can also be used externally.</p>
<p>Note that this function uses a non-const UDateTimePatternGenerator: It uses a stateful pattern parser which is set up for each generator object, rather than creating one for each function call. Consecutive calls to this function do not affect each other, but this function cannot be used concurrently on a single generator object.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pattern</em> </td><td>Input pattern </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternLength</em> </td><td>the length of input pattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>skeleton</em> </td><td></td></tr>
<tr><td valign="top"></td><td valign="top"><em>skeletonLength</em> </td><td>the length of input skeleton. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>options</em> </td><td>Options controlling whether the length of specified fields in the pattern are adjusted to match those in the skeleton (when this would not happen otherwise). For default behavior, use UDATPG_MATCH_NO_OPTIONS. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dest</em> </td><td>pattern adjusted to match the skeleton fields widths and subtypes. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>destCapacity</em> </td><td>the capacity of dest. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pErrorCode</em> </td><td>a pointer to the UErrorCode which must not indicate a failure before the function call. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the length of dest. </dd></dl>
<dl class="draft"><dt><b><a class="el" href="draft.html#_draft000218">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in ICU 4.4 </dd></dl>
</div>
</div>
<a class="anchor" id="ac21e5486c0133a59974ea21d27aa36a1"></a><!-- doxytag: member="udatpg.h::udatpg_setAppendItemFormat" ref="ac21e5486c0133a59974ea21d27aa36a1" args="(UDateTimePatternGenerator *dtpg, UDateTimePatternField field, const UChar *value, int32_t length)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void udatpg_setAppendItemFormat </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a> </td>
<td class="paramname"> <em>field</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>length</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>An AppendItem format is a pattern used to append a field if there is no good match. </p>
<p>For example, suppose that the input skeleton is "GyyyyMMMd", and there is no matching pattern internally, but there is a pattern matching "yyyyMMMd", say "d-MM-yyyy". Then that pattern is used, plus the G. The way these two are conjoined is by using the AppendItemFormat for G (era). So if that value is, say "{0}, {1}" then the final resulting pattern is "d-MM-yyyy, G". </p>
<p>There are actually three available variables: {0} is the pattern so far, {1} is the element we are adding, and {2} is the name of the element. </p>
<p>This reflects the way that the CLDR data is organized.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>field</em> </td><td>UDateTimePatternField, such as UDATPG_ERA_FIELD </td></tr>
<tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>pattern, such as "{0}, {1}" </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>the length of value. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003675">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a54de436656a76b55998e7440cc378723"></a><!-- doxytag: member="udatpg.h::udatpg_setAppendItemName" ref="a54de436656a76b55998e7440cc378723" args="(UDateTimePatternGenerator *dtpg, UDateTimePatternField field, const UChar *value, int32_t length)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void udatpg_setAppendItemName </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#af4ac5e0a850e2f49084fc0bcfc07ed03">UDateTimePatternField</a> </td>
<td class="paramname"> <em>field</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>length</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the name of field, eg "era" in English for ERA. </p>
<p>These are only used if the corresponding AppendItemFormat is used, and if it contains a {2} variable. </p>
<p>This reflects the way that the CLDR data is organized.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>field</em> </td><td>UDateTimePatternField </td></tr>
<tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>name for the field. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>the length of value. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003677">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a5f7d6e89623cb906780881fc3bb4e975"></a><!-- doxytag: member="udatpg.h::udatpg_setDateTimeFormat" ref="a5f7d6e89623cb906780881fc3bb4e975" args="(const UDateTimePatternGenerator *dtpg, const UChar *dtFormat, int32_t length)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void udatpg_setDateTimeFormat </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>dtFormat</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>length</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The date time format is a message format pattern used to compose date and time patterns. </p>
<p>The default value is "{0} {1}", where {0} will be replaced by the date pattern and {1} will be replaced by the time pattern. </p>
<p>This is used when the input skeleton contains both date and time fields, but there is not a close match among the added patterns. For example, suppose that this object was created by adding "dd-MMM" and "hh:mm", and its datetimeFormat is the default "{0} {1}". Then if the input skeleton is "MMMdhmm", there is not an exact match, so the input skeleton is broken up into two components "MMMd" and "hmm". There are close matches for those two skeletons, so the result is put together with this pattern, resulting in "d-MMM h:mm".</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dtFormat</em> </td><td>message format pattern, here {0} will be replaced by the date pattern and {1} will be replaced by the time pattern. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>the length of dtFormat. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003679">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
<a class="anchor" id="a595cae32436b43fbb4fd6f770d96b81f"></a><!-- doxytag: member="udatpg.h::udatpg_setDecimal" ref="a595cae32436b43fbb4fd6f770d96b81f" args="(UDateTimePatternGenerator *dtpg, const UChar *decimal, int32_t length)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void udatpg_setDecimal </td>
<td>(</td>
<td class="paramtype"><a class="el" href="udatpg_8h.html#a41aa5fa585671c3b2e0bb2e90c30c938">UDateTimePatternGenerator</a> * </td>
<td class="paramname"> <em>dtpg</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="umachine_8h.html#a6bb9fad572d65b305324ef288165e2ac">UChar</a> * </td>
<td class="paramname"> <em>decimal</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int32_t </td>
<td class="paramname"> <em>length</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The decimal value is used in formatting fractions of seconds. </p>
<p>If the skeleton contains fractional seconds, then this is used with the fractional seconds. For example, suppose that the input pattern is "hhmmssSSSS", and the best matching pattern internally is "H:mm:ss", and the decimal string is ",". Then the resulting pattern is modified to be "H:mm:ss,SSSS"</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dtpg</em> </td><td>a pointer to UDateTimePatternGenerator. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>decimal</em> </td><td></td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>the length of decimal. </td></tr>
</table>
</dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003681">Stable:</a></b></dt><dd>ICU 3.8 </dd></dl>
</div>
</div>
</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>Defines</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on 16 Mar 2010 for ICU 4.4 by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Mandriva
>
current
>
i586
>
media
>
main-updates
>
by-pkgid
>
f51238514e2abe817779ad2fe01b0759
>
files
>
714
