PNG  IHDR pHYs   OiCCPPhotoshop ICC profilexڝSgTS=BKKoR RB&*! J!QEEȠQ, !{kּ> H3Q5 B.@ $pd!s#~<<+"x M0B\t8K@zB@F&S`cbP-`'{[! eDh;VEX0fK9-0IWfH  0Q){`##xFW<+*x<$9E[-qWW.(I+6aa@.y24x6_-"bbϫp@t~,/;m%h^ uf@Wp~<5j>{-]cK'Xto(hw?G%fIq^D$.Tʳ?D*A, `6B$BB dr`)B(Ͱ*`/@4Qhp.U=pa( Aa!ڈbX#!H$ ɈQ"K5H1RT UH=r9\F;2G1Q= C7F dt1r=6Ыhڏ>C03l0.B8, c˱" VcϱwE 6wB aAHXLXNH $4 7 Q'"K&b21XH,#/{C7$C2'ITFnR#,4H#dk9, +ȅ3![ b@qS(RjJ4e2AURݨT5ZBRQ4u9̓IKhhitݕNWGw Ljg(gwLӋT071oUX**| J&*/Tު UUT^S}FU3S ԖUPSSg;goT?~YYLOCQ_ cx,!k u5&|v*=9C3J3WRf?qtN (~))4L1e\kXHQG6EYAJ'\'GgSSݧ M=:.kDwn^Loy}/TmG X $ <5qo</QC]@Caaᄑ.ȽJtq]zۯ6iܟ4)Y3sCQ? 0k߬~OCOg#/c/Wװwa>>r><72Y_7ȷOo_C#dz%gA[z|!?:eAAA!h쐭!ΑiP~aa~ 'W?pX15wCsDDDޛg1O9-J5*>.j<74?.fYXXIlK9.*6nl {/]py.,:@LN8A*%w% yg"/6шC\*NH*Mz쑼5y$3,幄'L Lݛ:v m2=:1qB!Mggfvˬen/kY- BTZ(*geWf͉9+̳ې7ᒶKW-X潬j9(xoʿܔĹdff-[n ڴ VE/(ۻCɾUUMfeI?m]Nmq#׹=TR+Gw- 6 U#pDy  :v{vg/jBFS[b[O>zG499?rCd&ˮ/~јѡ򗓿m|x31^VwwO| (hSЧc3- cHRMz%u0`:o_F@8N ' p @8N@8}' p '#@8N@8N pQ9p!i~}|6-ӪG` VP.@*j>[ K^<֐Z]@8N'KQ<Q(`s" 'hgpKB`R@Dqj '  'P$a ( `D$Na L?u80e J,K˷NI'0eݷ(NI'؀ 2ipIIKp`:O'`ʤxB8Ѥx Ѥx $ $P6 :vRNb 'p,>NB 'P]-->P T+*^h& p '‰a ‰ (ĵt#u33;Nt̵'ޯ; [3W ~]0KH1q@8]O2]3*̧7# *p>us p _6]/}-4|t'|Smx= DoʾM×M_8!)6lq':l7!|4} '\ne t!=hnLn (~Dn\+‰_4k)0e@OhZ`F `.m1} 'vp{F`ON7Srx 'D˸nV`><;yMx!IS钦OM)Ե٥x 'DSD6bS8!" ODz#R >S8!7ّxEh0m$MIPHi$IvS8IN$I p$O8I,sk&I)$IN$Hi$I^Ah.p$MIN$IR8I·N "IF9Ah0m$MIN$IR8IN$I 3jIU;kO$ɳN$+ q.x* tEXtComment

Viewing File: /opt/alt/alt-nodejs18/root/usr/share/doc/alt-nodejs18-libicu-doc/utrace_8h.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.9.1"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>ICU 74.2: common/unicode/utrace.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectalign" style="padding-left: 0.5em;">
   <div id="projectname">ICU 74.2
   &#160;<span id="projectnumber">74.2</span>
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.1 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
  initMenu('',false,false,'search.php','Search');
});
/* @license-end */</script>
<div id="main-nav"></div>
<div id="nav-path" class="navpath">
  <ul>
<li class="navelem"><a class="el" href="dir_bdd9a5d540de89e9fe90efdfc6973a4f.html">common</a></li><li class="navelem"><a class="el" href="dir_f59c6450ff718ff1b085cfd1c36acbd7.html">unicode</a></li>  </ul>
</div>
</div><!-- top -->
<div class="header">
  <div class="summary">
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<div class="title">utrace.h File Reference</div>  </div>
</div><!--header-->
<div class="contents">

<p>C API: Definitions for ICU tracing/logging.  
<a href="#details">More...</a></p>
<div class="textblock"><code>#include &lt;stdarg.h&gt;</code><br />
<code>#include &quot;<a class="el" href="utypes_8h_source.html">unicode/utypes.h</a>&quot;</code><br />
</div>
<p><a href="utrace_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:a58c70902dd527747ffa7ef8fd1a1139b"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079">UTraceLevel</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a58c70902dd527747ffa7ef8fd1a1139b">UTraceLevel</a></td></tr>
<tr class="memdesc:a58c70902dd527747ffa7ef8fd1a1139b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Trace severity levels.  <a href="utrace_8h.html#a58c70902dd527747ffa7ef8fd1a1139b">More...</a><br /></td></tr>
<tr class="separator:a58c70902dd527747ffa7ef8fd1a1139b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae7cb0950d251b2ec8f8bf0c78dd96046"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308">UTraceFunctionNumber</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#ae7cb0950d251b2ec8f8bf0c78dd96046">UTraceFunctionNumber</a></td></tr>
<tr class="memdesc:ae7cb0950d251b2ec8f8bf0c78dd96046"><td class="mdescLeft">&#160;</td><td class="mdescRight">These are the ICU functions that will be traced when tracing is enabled.  <a href="utrace_8h.html#ae7cb0950d251b2ec8f8bf0c78dd96046">More...</a><br /></td></tr>
<tr class="separator:ae7cb0950d251b2ec8f8bf0c78dd96046"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a57431e5b7de5217371b6b269039d8960"><td class="memItemLeft" align="right" valign="top">typedef void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a57431e5b7de5217371b6b269039d8960">UTraceEntry</a>(const void *context, int32_t fnNumber)</td></tr>
<tr class="memdesc:a57431e5b7de5217371b6b269039d8960"><td class="mdescLeft">&#160;</td><td class="mdescRight">Type signature for the trace function to be called when entering a function.  <a href="utrace_8h.html#a57431e5b7de5217371b6b269039d8960">More...</a><br /></td></tr>
<tr class="separator:a57431e5b7de5217371b6b269039d8960"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac819bbfb23657b4a4c465634a0dc0586"><td class="memItemLeft" align="right" valign="top">typedef void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#ac819bbfb23657b4a4c465634a0dc0586">UTraceExit</a>(const void *context, int32_t fnNumber, const char *fmt, va_list args)</td></tr>
<tr class="memdesc:ac819bbfb23657b4a4c465634a0dc0586"><td class="mdescLeft">&#160;</td><td class="mdescRight">Type signature for the trace function to be called when exiting from a function.  <a href="utrace_8h.html#ac819bbfb23657b4a4c465634a0dc0586">More...</a><br /></td></tr>
<tr class="separator:ac819bbfb23657b4a4c465634a0dc0586"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a22a4d10cb4754a7d3178dc55eb61842f"><td class="memItemLeft" align="right" valign="top">typedef void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a22a4d10cb4754a7d3178dc55eb61842f">UTraceData</a>(const void *context, int32_t fnNumber, int32_t level, const char *fmt, va_list args)</td></tr>
<tr class="memdesc:a22a4d10cb4754a7d3178dc55eb61842f"><td class="mdescLeft">&#160;</td><td class="mdescRight">Type signature for the trace function to be called from within an ICU function to display data or messages.  <a href="utrace_8h.html#a22a4d10cb4754a7d3178dc55eb61842f">More...</a><br /></td></tr>
<tr class="separator:a22a4d10cb4754a7d3178dc55eb61842f"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:a87213b0396d0aa046bd9116e89152079"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079">UTraceLevel</a> { <br />
&#160;&#160;<a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079ad73020624fba9734da1067a92799a7fd">UTRACE_OFF</a> =-1
, <a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079a8e9415b7ad8550fa3d9dcc196f88fe98">UTRACE_ERROR</a> =0
, <a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079a4329e6d348c1ce278aa5a70d9d678416">UTRACE_WARNING</a> =3
, <a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079acf27fc8d57f1b0bd0a1700abcc48e9ad">UTRACE_OPEN_CLOSE</a> =5
, <br />
&#160;&#160;<a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079ae88684e6ac3d6f889b5d1603395c6bf1">UTRACE_INFO</a> =7
, <a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079af0102c5618b566755d3d0315aeb18ff4">UTRACE_VERBOSE</a> =9
<br />
 }</td></tr>
<tr class="memdesc:a87213b0396d0aa046bd9116e89152079"><td class="mdescLeft">&#160;</td><td class="mdescRight">Trace severity levels.  <a href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079">More...</a><br /></td></tr>
<tr class="separator:a87213b0396d0aa046bd9116e89152079"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a6076ad13223437bd15a3266791905308"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308">UTraceFunctionNumber</a> { <br />
&#160;&#160;<b>UTRACE_FUNCTION_START</b> =0
, <b>UTRACE_U_INIT</b> =UTRACE_FUNCTION_START
, <b>UTRACE_U_CLEANUP</b>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a16b8c7b99796a8346d55b8ba0299b6db">UTRACE_FUNCTION_LIMIT</a>
, <br />
&#160;&#160;<b>UTRACE_CONVERSION_START</b> =0x1000
, <b>UTRACE_UCNV_OPEN</b> =UTRACE_CONVERSION_START
, <b>UTRACE_UCNV_OPEN_PACKAGE</b>
, <b>UTRACE_UCNV_OPEN_ALGORITHMIC</b>
, <br />
&#160;&#160;<b>UTRACE_UCNV_CLONE</b>
, <b>UTRACE_UCNV_CLOSE</b>
, <b>UTRACE_UCNV_FLUSH_CACHE</b>
, <b>UTRACE_UCNV_LOAD</b>
, <br />
&#160;&#160;<b>UTRACE_UCNV_UNLOAD</b>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308ae5986fb60ce52a8e3928873176406bf5">UTRACE_CONVERSION_LIMIT</a>
, <b>UTRACE_COLLATION_START</b> =0x2000
, <b>UTRACE_UCOL_OPEN</b> =UTRACE_COLLATION_START
, <br />
&#160;&#160;<b>UTRACE_UCOL_CLOSE</b>
, <b>UTRACE_UCOL_STRCOLL</b>
, <b>UTRACE_UCOL_GET_SORTKEY</b>
, <b>UTRACE_UCOL_GETLOCALE</b>
, <br />
&#160;&#160;<b>UTRACE_UCOL_NEXTSORTKEYPART</b>
, <b>UTRACE_UCOL_STRCOLLITER</b>
, <b>UTRACE_UCOL_OPEN_FROM_SHORT_STRING</b>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a18dca4774f919146c684b8071fb976f2">UTRACE_UCOL_STRCOLLUTF8</a>
, <br />
&#160;&#160;<a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a3b0b647c015de2cc2346797232ebc3a9">UTRACE_COLLATION_LIMIT</a>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a86015e94c5e12f1eddc552036e678df2">UTRACE_UDATA_START</a> =0x3000
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a9ce49bcce73ecaf836ae6afb59fb8d38">UTRACE_UDATA_RESOURCE</a> =UTRACE_UDATA_START
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a4b61d026018526c7708e9d3b99e48133">UTRACE_UDATA_BUNDLE</a>
, <br />
&#160;&#160;<a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a85a65aacd75ea3ff72385deb9e0972f2">UTRACE_UDATA_DATA_FILE</a>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308ac08925b9fed621934d63325a9d1ea381">UTRACE_UDATA_RES_FILE</a>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308adc7c76609b5e07c3693c596ba27335a2">UTRACE_RES_DATA_LIMIT</a>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a4e009d643b954d675880d288da512459">UTRACE_UBRK_START</a> =0x4000
, <br />
&#160;&#160;<a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308af5c0a7b71785aaa95443f79fb0f2b905">UTRACE_UBRK_CREATE_CHARACTER</a> = UTRACE_UBRK_START
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a43b7d767e1efb264ef9552904d9f180f">UTRACE_UBRK_CREATE_WORD</a>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a5108fe0fd5a171761c0f0d97657c7300">UTRACE_UBRK_CREATE_LINE</a>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a773111da8901eb083eddbc4bf93230d3">UTRACE_UBRK_CREATE_SENTENCE</a>
, <br />
&#160;&#160;<a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a97a23b1c2675dea309615a78b0dfbcb4">UTRACE_UBRK_CREATE_TITLE</a>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a0d5758489b9feb53124ba77e17d07d74">UTRACE_UBRK_CREATE_BREAK_ENGINE</a>
, <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308a7d42702c04b0cd2c8d50f83a1f76986f">UTRACE_UBRK_LIMIT</a>
<br />
 }</td></tr>
<tr class="memdesc:a6076ad13223437bd15a3266791905308"><td class="mdescLeft">&#160;</td><td class="mdescRight">These are the ICU functions that will be traced when tracing is enabled.  <a href="utrace_8h.html#a6076ad13223437bd15a3266791905308">More...</a><br /></td></tr>
<tr class="separator:a6076ad13223437bd15a3266791905308"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:a28c850a0d0d58a9fd5ceb413837bc290"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a28c850a0d0d58a9fd5ceb413837bc290">utrace_setLevel</a> (int32_t traceLevel)</td></tr>
<tr class="memdesc:a28c850a0d0d58a9fd5ceb413837bc290"><td class="mdescLeft">&#160;</td><td class="mdescRight">Setter for the trace level.  <a href="utrace_8h.html#a28c850a0d0d58a9fd5ceb413837bc290">More...</a><br /></td></tr>
<tr class="separator:a28c850a0d0d58a9fd5ceb413837bc290"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae3f8d87f6bb4f9ea3e4ee41ffc9cb416"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#ae3f8d87f6bb4f9ea3e4ee41ffc9cb416">utrace_getLevel</a> (void)</td></tr>
<tr class="memdesc:ae3f8d87f6bb4f9ea3e4ee41ffc9cb416"><td class="mdescLeft">&#160;</td><td class="mdescRight">Getter for the trace level.  <a href="utrace_8h.html#ae3f8d87f6bb4f9ea3e4ee41ffc9cb416">More...</a><br /></td></tr>
<tr class="separator:ae3f8d87f6bb4f9ea3e4ee41ffc9cb416"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a897b9657eef1b5072be85270e7073b81"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a897b9657eef1b5072be85270e7073b81">utrace_setFunctions</a> (const void *context, <a class="el" href="utrace_8h.html#a57431e5b7de5217371b6b269039d8960">UTraceEntry</a> *e, <a class="el" href="utrace_8h.html#ac819bbfb23657b4a4c465634a0dc0586">UTraceExit</a> *x, <a class="el" href="utrace_8h.html#a22a4d10cb4754a7d3178dc55eb61842f">UTraceData</a> *d)</td></tr>
<tr class="memdesc:a897b9657eef1b5072be85270e7073b81"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set ICU Tracing functions.  <a href="utrace_8h.html#a897b9657eef1b5072be85270e7073b81">More...</a><br /></td></tr>
<tr class="separator:a897b9657eef1b5072be85270e7073b81"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a8861bd8485df67fd38dd8399db4f9d38"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a8861bd8485df67fd38dd8399db4f9d38">utrace_getFunctions</a> (const void **context, <a class="el" href="utrace_8h.html#a57431e5b7de5217371b6b269039d8960">UTraceEntry</a> **e, <a class="el" href="utrace_8h.html#ac819bbfb23657b4a4c465634a0dc0586">UTraceExit</a> **x, <a class="el" href="utrace_8h.html#a22a4d10cb4754a7d3178dc55eb61842f">UTraceData</a> **d)</td></tr>
<tr class="memdesc:a8861bd8485df67fd38dd8399db4f9d38"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the currently installed ICU tracing functions.  <a href="utrace_8h.html#a8861bd8485df67fd38dd8399db4f9d38">More...</a><br /></td></tr>
<tr class="separator:a8861bd8485df67fd38dd8399db4f9d38"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a69c427067cd9362a7a6532eea3d553cf"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a69c427067cd9362a7a6532eea3d553cf">utrace_vformat</a> (char *outBuf, int32_t capacity, int32_t indent, const char *fmt, va_list args)</td></tr>
<tr class="memdesc:a69c427067cd9362a7a6532eea3d553cf"><td class="mdescLeft">&#160;</td><td class="mdescRight">Trace output Formatter.  <a href="utrace_8h.html#a69c427067cd9362a7a6532eea3d553cf">More...</a><br /></td></tr>
<tr class="separator:a69c427067cd9362a7a6532eea3d553cf"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a3b5f830089d99488adb67ec5fbf57cf8"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a3b5f830089d99488adb67ec5fbf57cf8">utrace_format</a> (char *outBuf, int32_t capacity, int32_t indent, const char *fmt,...)</td></tr>
<tr class="memdesc:a3b5f830089d99488adb67ec5fbf57cf8"><td class="mdescLeft">&#160;</td><td class="mdescRight">Trace output Formatter.  <a href="utrace_8h.html#a3b5f830089d99488adb67ec5fbf57cf8">More...</a><br /></td></tr>
<tr class="separator:a3b5f830089d99488adb67ec5fbf57cf8"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a3e1bbf84ed8aee3761ac737a749eece9"><td class="memItemLeft" align="right" valign="top"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="utrace_8h.html#a3e1bbf84ed8aee3761ac737a749eece9">utrace_functionName</a> (int32_t fnNumber)</td></tr>
<tr class="memdesc:a3e1bbf84ed8aee3761ac737a749eece9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the name of a function from its trace function number.  <a href="utrace_8h.html#a3e1bbf84ed8aee3761ac737a749eece9">More...</a><br /></td></tr>
<tr class="separator:a3e1bbf84ed8aee3761ac737a749eece9"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>C API: Definitions for ICU tracing/logging. </p>
<p>This provides API for debugging the internals of ICU without the use of a traditional debugger.</p>
<p>By default, tracing is disabled in ICU. If you need to debug ICU with tracing, please compile ICU with the &ndash;enable-tracing configure option. </p>

<p class="definition">Definition in file <a class="el" href="utrace_8h_source.html">utrace.h</a>.</p>
</div><h2 class="groupheader">Typedef Documentation</h2>
<a id="a22a4d10cb4754a7d3178dc55eb61842f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a22a4d10cb4754a7d3178dc55eb61842f">&#9670;&nbsp;</a></span>UTraceData</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef void UTraceData(const void *context, int32_t fnNumber, int32_t level, const char *fmt, va_list args)</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Type signature for the trace function to be called from within an ICU function to display data or messages. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>value supplied at the time the trace functions are set. </td></tr>
    <tr><td class="paramname">fnNumber</td><td>Enum value indicating the ICU function being exited. </td></tr>
    <tr><td class="paramname">level</td><td>The current tracing level </td></tr>
    <tr><td class="paramname">fmt</td><td>A format string describing the tracing data that is supplied as variable args </td></tr>
    <tr><td class="paramname">args</td><td>The data being traced, passed as variable args. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003413">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

<p class="definition">Definition at line <a class="el" href="utrace_8h_source.html#l00296">296</a> of file <a class="el" href="utrace_8h_source.html">utrace.h</a>.</p>

</div>
</div>
<a id="a57431e5b7de5217371b6b269039d8960"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a57431e5b7de5217371b6b269039d8960">&#9670;&nbsp;</a></span>UTraceEntry</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef void UTraceEntry(const void *context, int32_t fnNumber)</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Type signature for the trace function to be called when entering a function. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>value supplied at the time the trace functions are set. </td></tr>
    <tr><td class="paramname">fnNumber</td><td>Enum value indicating the ICU function being entered. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003411">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

<p class="definition">Definition at line <a class="el" href="utrace_8h_source.html#l00265">265</a> of file <a class="el" href="utrace_8h_source.html">utrace.h</a>.</p>

</div>
</div>
<a id="ac819bbfb23657b4a4c465634a0dc0586"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ac819bbfb23657b4a4c465634a0dc0586">&#9670;&nbsp;</a></span>UTraceExit</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef void UTraceExit(const void *context, int32_t fnNumber, const char *fmt, va_list args)</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Type signature for the trace function to be called when exiting from a function. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>value supplied at the time the trace functions are set. </td></tr>
    <tr><td class="paramname">fnNumber</td><td>Enum value indicating the ICU function being exited. </td></tr>
    <tr><td class="paramname">fmt</td><td>A formatting string that describes the number and types of arguments included with the variable args. The fmt string has the same form as the utrace_vformat format string. </td></tr>
    <tr><td class="paramname">args</td><td>A variable arguments list. Contents are described by the fmt parameter. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="utrace_8h.html#a69c427067cd9362a7a6532eea3d553cf" title="Trace output Formatter.">utrace_vformat</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003412">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

<p class="definition">Definition at line <a class="el" href="utrace_8h_source.html#l00281">281</a> of file <a class="el" href="utrace_8h_source.html">utrace.h</a>.</p>

</div>
</div>
<a id="ae7cb0950d251b2ec8f8bf0c78dd96046"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ae7cb0950d251b2ec8f8bf0c78dd96046">&#9670;&nbsp;</a></span>UTraceFunctionNumber</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308">UTraceFunctionNumber</a> <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308">UTraceFunctionNumber</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>These are the ICU functions that will be traced when tracing is enabled. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003408">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

</div>
</div>
<a id="a58c70902dd527747ffa7ef8fd1a1139b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a58c70902dd527747ffa7ef8fd1a1139b">&#9670;&nbsp;</a></span>UTraceLevel</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079">UTraceLevel</a> <a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079">UTraceLevel</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Trace severity levels. </p>
<p>Higher levels increase the verbosity of the trace output. </p><dl class="section see"><dt>See also</dt><dd><a class="el" href="utrace_8h.html#a28c850a0d0d58a9fd5ceb413837bc290" title="Setter for the trace level.">utrace_setLevel</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003407">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

</div>
</div>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a id="a6076ad13223437bd15a3266791905308"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a6076ad13223437bd15a3266791905308">&#9670;&nbsp;</a></span>UTraceFunctionNumber</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308">UTraceFunctionNumber</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>These are the ICU functions that will be traced when tracing is enabled. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003408">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a16b8c7b99796a8346d55b8ba0299b6db"></a>UTRACE_FUNCTION_LIMIT&#160;</td><td class="fielddoc"><p>One more than the highest normal collation trace location. </p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000278">Deprecated:</a></b></dt><dd>ICU 58 The numeric value may change over time, see ICU ticket #12420. </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308ae5986fb60ce52a8e3928873176406bf5"></a>UTRACE_CONVERSION_LIMIT&#160;</td><td class="fielddoc"><p>One more than the highest normal collation trace location. </p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000279">Deprecated:</a></b></dt><dd>ICU 58 The numeric value may change over time, see ICU ticket #12420. </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a18dca4774f919146c684b8071fb976f2"></a>UTRACE_UCOL_STRCOLLUTF8&#160;</td><td class="fielddoc"><dl class="stable"><dt><b><a class="el" href="stable.html#_stable003425">Stable:</a></b></dt><dd>ICU 50 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a3b0b647c015de2cc2346797232ebc3a9"></a>UTRACE_COLLATION_LIMIT&#160;</td><td class="fielddoc"><p>One more than the highest normal collation trace location. </p>
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000280">Deprecated:</a></b></dt><dd>ICU 58 The numeric value may change over time, see ICU ticket #12420. </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a86015e94c5e12f1eddc552036e678df2"></a>UTRACE_UDATA_START&#160;</td><td class="fielddoc"><p>The lowest resource/data location. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003426">Stable:</a></b></dt><dd>ICU 65 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a9ce49bcce73ecaf836ae6afb59fb8d38"></a>UTRACE_UDATA_RESOURCE&#160;</td><td class="fielddoc"><p>Indicates that a value was read from a resource bundle. </p>
<p>Provides three C-style strings to UTraceData: type, file name, and resource path. The possible types are:</p>
<ul>
<li>"string" (a string value was accessed)</li>
<li>"binary" (a binary value was accessed)</li>
<li>"intvector" (a integer vector value was accessed)</li>
<li>"int" (a signed integer value was accessed)</li>
<li>"uint" (a unsigned integer value was accessed)</li>
<li>"get" (a path was loaded, but the value was not accessed)</li>
<li><p class="startli">"getalias" (a path was loaded, and an alias was resolved)</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003427">Stable:</a></b></dt><dd>ICU 65 </dd></dl>
</li>
</ul>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a4b61d026018526c7708e9d3b99e48133"></a>UTRACE_UDATA_BUNDLE&#160;</td><td class="fielddoc"><p>Indicates that a resource bundle was opened. </p>
<p>Provides one C-style string to UTraceData: file name. </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable003428">Stable:</a></b></dt><dd>ICU 65 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a85a65aacd75ea3ff72385deb9e0972f2"></a>UTRACE_UDATA_DATA_FILE&#160;</td><td class="fielddoc"><p>Indicates that a data file was opened, but not *.res files. </p>
<p>Provides one C-style string to UTraceData: file name.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003429">Stable:</a></b></dt><dd>ICU 65 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308ac08925b9fed621934d63325a9d1ea381"></a>UTRACE_UDATA_RES_FILE&#160;</td><td class="fielddoc"><p>Indicates that a *.res file was opened. </p>
<p>This differs from UTRACE_UDATA_BUNDLE because a res file is typically opened only once per application runtime, but the bundle corresponding to that res file may be opened many times.</p>
<p>Provides one C-style string to UTraceData: file name.</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003430">Stable:</a></b></dt><dd>ICU 65 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308adc7c76609b5e07c3693c596ba27335a2"></a>UTRACE_RES_DATA_LIMIT&#160;</td><td class="fielddoc"><p>One more than the highest normal resource/data trace location. </p>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000184">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. The numeric value may change over time, see ICU ticket #12420. </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a4e009d643b954d675880d288da512459"></a>UTRACE_UBRK_START&#160;</td><td class="fielddoc"><p>The lowest break iterator location. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003431">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308af5c0a7b71785aaa95443f79fb0f2b905"></a>UTRACE_UBRK_CREATE_CHARACTER&#160;</td><td class="fielddoc"><p>Indicates that a character instance of break iterator was created. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003432">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a43b7d767e1efb264ef9552904d9f180f"></a>UTRACE_UBRK_CREATE_WORD&#160;</td><td class="fielddoc"><p>Indicates that a word instance of break iterator was created. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003433">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a5108fe0fd5a171761c0f0d97657c7300"></a>UTRACE_UBRK_CREATE_LINE&#160;</td><td class="fielddoc"><p>Indicates that a line instance of break iterator was created. </p>
<p>Provides one C-style string to UTraceData: the lb value ("", "loose", "strict", or "normal").</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003434">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a773111da8901eb083eddbc4bf93230d3"></a>UTRACE_UBRK_CREATE_SENTENCE&#160;</td><td class="fielddoc"><p>Indicates that a sentence instance of break iterator was created. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003435">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a97a23b1c2675dea309615a78b0dfbcb4"></a>UTRACE_UBRK_CREATE_TITLE&#160;</td><td class="fielddoc"><p>Indicates that a title instance of break iterator was created. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003436">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a0d5758489b9feb53124ba77e17d07d74"></a>UTRACE_UBRK_CREATE_BREAK_ENGINE&#160;</td><td class="fielddoc"><p>Indicates that an internal dictionary break engine was created. </p>
<p>Provides one C-style string to UTraceData: the script code of what the break engine cover ("Hani", "Khmr", "Laoo", "Mymr", or "Thai").</p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003437">Stable:</a></b></dt><dd>ICU 67 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a6076ad13223437bd15a3266791905308a7d42702c04b0cd2c8d50f83a1f76986f"></a>UTRACE_UBRK_LIMIT&#160;</td><td class="fielddoc"><p>One more than the highest normal break iterator trace location. </p>
<dl class="internal"><dt><b><a class="el" href="internal.html#_internal000185">Internal:</a></b></dt><dd>Do not use. This API is for internal use only. The numeric value may change over time, see ICU ticket #12420. </dd></dl>
</td></tr>
</table>

<p class="definition">Definition at line <a class="el" href="utrace_8h_source.html#l00065">65</a> of file <a class="el" href="utrace_8h_source.html">utrace.h</a>.</p>

</div>
</div>
<a id="a87213b0396d0aa046bd9116e89152079"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a87213b0396d0aa046bd9116e89152079">&#9670;&nbsp;</a></span>UTraceLevel</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="utrace_8h.html#a87213b0396d0aa046bd9116e89152079">UTraceLevel</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Trace severity levels. </p>
<p>Higher levels increase the verbosity of the trace output. </p><dl class="section see"><dt>See also</dt><dd><a class="el" href="utrace_8h.html#a28c850a0d0d58a9fd5ceb413837bc290" title="Setter for the trace level.">utrace_setLevel</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003407">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a87213b0396d0aa046bd9116e89152079ad73020624fba9734da1067a92799a7fd"></a>UTRACE_OFF&#160;</td><td class="fielddoc"><p>Disable all tracing. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003419">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a87213b0396d0aa046bd9116e89152079a8e9415b7ad8550fa3d9dcc196f88fe98"></a>UTRACE_ERROR&#160;</td><td class="fielddoc"><p>Trace error conditions only. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003420">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a87213b0396d0aa046bd9116e89152079a4329e6d348c1ce278aa5a70d9d678416"></a>UTRACE_WARNING&#160;</td><td class="fielddoc"><p>Trace errors and warnings. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003421">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a87213b0396d0aa046bd9116e89152079acf27fc8d57f1b0bd0a1700abcc48e9ad"></a>UTRACE_OPEN_CLOSE&#160;</td><td class="fielddoc"><p>Trace opens and closes of ICU services. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003422">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a87213b0396d0aa046bd9116e89152079ae88684e6ac3d6f889b5d1603395c6bf1"></a>UTRACE_INFO&#160;</td><td class="fielddoc"><p>Trace an intermediate number of ICU operations. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003423">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="a87213b0396d0aa046bd9116e89152079af0102c5618b566755d3d0315aeb18ff4"></a>UTRACE_VERBOSE&#160;</td><td class="fielddoc"><p>Trace the maximum number of ICU operations. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003424">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>
</td></tr>
</table>

<p class="definition">Definition at line <a class="el" href="utrace_8h_source.html#l00046">46</a> of file <a class="el" href="utrace_8h_source.html">utrace.h</a>.</p>

</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="a3b5f830089d99488adb67ec5fbf57cf8"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3b5f830089d99488adb67ec5fbf57cf8">&#9670;&nbsp;</a></span>utrace_format()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t utrace_format </td>
          <td>(</td>
          <td class="paramtype">char *&#160;</td>
          <td class="paramname"><em>outBuf</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>capacity</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>indent</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>fmt</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">&#160;</td>
          <td class="paramname"><em>...</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Trace output Formatter. </p>
<p>An application's UTraceData tracing functions may call this function to format any additional trace data, beyond that provided by default, in human readable form with the same formatting conventions used by <a class="el" href="utrace_8h.html#a69c427067cd9362a7a6532eea3d553cf" title="Trace output Formatter.">utrace_vformat()</a>. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">outBuf</td><td>pointer to a buffer to receive the formatted output. Output will be nul terminated if there is space in the buffer - if the length of the requested output &lt; the output buffer size. </td></tr>
    <tr><td class="paramname">capacity</td><td>Length of the output buffer. </td></tr>
    <tr><td class="paramname">indent</td><td>Number of spaces to indent the output. Intended to allow data displayed from nested functions to be indented for readability. </td></tr>
    <tr><td class="paramname">fmt</td><td>Format specification for the data to output </td></tr>
    <tr><td class="paramname">...</td><td>Data to be formatted. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Length of formatted output, including the terminating NUL. If buffer capacity is insufficient, the required capacity is returned. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003417">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

</div>
</div>
<a id="a3e1bbf84ed8aee3761ac737a749eece9"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3e1bbf84ed8aee3761ac737a749eece9">&#9670;&nbsp;</a></span>utrace_functionName()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> const char* utrace_functionName </td>
          <td>(</td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>fnNumber</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Get the name of a function from its trace function number. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">fnNumber</td><td>The trace number for an ICU function. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The name string for the function.</dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="utrace_8h.html#a6076ad13223437bd15a3266791905308" title="These are the ICU functions that will be traced when tracing is enabled.">UTraceFunctionNumber</a> </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003418">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

</div>
</div>
<a id="a8861bd8485df67fd38dd8399db4f9d38"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a8861bd8485df67fd38dd8399db4f9d38">&#9670;&nbsp;</a></span>utrace_getFunctions()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void utrace_getFunctions </td>
          <td>(</td>
          <td class="paramtype">const void **&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utrace_8h.html#a57431e5b7de5217371b6b269039d8960">UTraceEntry</a> **&#160;</td>
          <td class="paramname"><em>e</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utrace_8h.html#ac819bbfb23657b4a4c465634a0dc0586">UTraceExit</a> **&#160;</td>
          <td class="paramname"><em>x</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utrace_8h.html#a22a4d10cb4754a7d3178dc55eb61842f">UTraceData</a> **&#160;</td>
          <td class="paramname"><em>d</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Get the currently installed ICU tracing functions. </p>
<p>Note that a null function pointer will be returned if no trace function has been set.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>The currently installed tracing context. </td></tr>
    <tr><td class="paramname">e</td><td>The currently installed UTraceEntry function. </td></tr>
    <tr><td class="paramname">x</td><td>The currently installed UTraceExit function. </td></tr>
    <tr><td class="paramname">d</td><td>The currently installed UTraceData function. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003415">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

</div>
</div>
<a id="ae3f8d87f6bb4f9ea3e4ee41ffc9cb416"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ae3f8d87f6bb4f9ea3e4ee41ffc9cb416">&#9670;&nbsp;</a></span>utrace_getLevel()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t utrace_getLevel </td>
          <td>(</td>
          <td class="paramtype">void&#160;</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Getter for the trace level. </p>
<dl class="section return"><dt>Returns</dt><dd>The UTraceLevel value being used by ICU. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003410">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

</div>
</div>
<a id="a897b9657eef1b5072be85270e7073b81"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a897b9657eef1b5072be85270e7073b81">&#9670;&nbsp;</a></span>utrace_setFunctions()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void utrace_setFunctions </td>
          <td>(</td>
          <td class="paramtype">const void *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utrace_8h.html#a57431e5b7de5217371b6b269039d8960">UTraceEntry</a> *&#160;</td>
          <td class="paramname"><em>e</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utrace_8h.html#ac819bbfb23657b4a4c465634a0dc0586">UTraceExit</a> *&#160;</td>
          <td class="paramname"><em>x</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="utrace_8h.html#a22a4d10cb4754a7d3178dc55eb61842f">UTraceData</a> *&#160;</td>
          <td class="paramname"><em>d</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Set ICU Tracing functions. </p>
<p>Installs application-provided tracing functions into ICU. After doing this, subsequent ICU operations will call back to the installed functions, providing a trace of the use of ICU. Passing a NULL pointer for a tracing function is allowed, and inhibits tracing action at points where that function would be called. </p>
<p>Tracing and Threads: Tracing functions are global to a process, and will be called in response to ICU operations performed by any thread. If tracing of an individual thread is desired, the tracing functions must themselves filter by checking that the current thread is the desired thread.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>an uninterpreted pointer. Whatever is passed in here will in turn be passed to each of the tracing functions UTraceEntry, UTraceExit and UTraceData. ICU does not use or alter this pointer. </td></tr>
    <tr><td class="paramname">e</td><td>Callback function to be called on entry to a a traced ICU function. </td></tr>
    <tr><td class="paramname">x</td><td>Callback function to be called on exit from a traced ICU function. </td></tr>
    <tr><td class="paramname">d</td><td>Callback function to be called from within a traced ICU function, for the purpose of providing data to the trace.</td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003414">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

</div>
</div>
<a id="a28c850a0d0d58a9fd5ceb413837bc290"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a28c850a0d0d58a9fd5ceb413837bc290">&#9670;&nbsp;</a></span>utrace_setLevel()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> void utrace_setLevel </td>
          <td>(</td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>traceLevel</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Setter for the trace level. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">traceLevel</td><td>A UTraceLevel value. </td></tr>
  </table>
  </dd>
</dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003409">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

</div>
</div>
<a id="a69c427067cd9362a7a6532eea3d553cf"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a69c427067cd9362a7a6532eea3d553cf">&#9670;&nbsp;</a></span>utrace_vformat()</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="umachine_8h.html#a676114b1a64bb7c2de15c919a00b28df">U_CAPI</a> int32_t utrace_vformat </td>
          <td>(</td>
          <td class="paramtype">char *&#160;</td>
          <td class="paramname"><em>outBuf</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>capacity</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>indent</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>fmt</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">va_list&#160;</td>
          <td class="paramname"><em>args</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Trace output Formatter. </p>
<p>An application's UTraceData tracing functions may call back to this function to format the trace output in a human readable form. Note that a UTraceData function may choose to not format the data; it could, for example, save it in in the raw form it was received (more compact), leaving formatting for a later trace analysis tool. </p><dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">outBuf</td><td>pointer to a buffer to receive the formatted output. Output will be nul terminated if there is space in the buffer - if the length of the requested output &lt; the output buffer size. </td></tr>
    <tr><td class="paramname">capacity</td><td>Length of the output buffer. </td></tr>
    <tr><td class="paramname">indent</td><td>Number of spaces to indent the output. Intended to allow data displayed from nested functions to be indented for readability. </td></tr>
    <tr><td class="paramname">fmt</td><td>Format specification for the data to output </td></tr>
    <tr><td class="paramname">args</td><td>Data to be formatted. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Length of formatted output, including the terminating NUL. If buffer capacity is insufficient, the required capacity is returned. </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable003416">Stable:</a></b></dt><dd>ICU 2.8 </dd></dl>

</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1
</small></address>
</body>
</html>
Back to Directory=ceiIENDB`