<html>
<head>
<title>Evas: General Utilities</title>
<meta http-equiv="content-type" content="text/html;charset=UTF-8">
<meta name="author" content="Andres Blanc" >
<link rel="icon" href="img/favicon.png" type="image/x-icon">
<link rel="shortcut icon" href="img/favicon.png" type="image/x-icon">
<link rel="icon" href="img/favicon.png" type="image/ico">
<link rel="shortcut icon" href="img/favicon.png" type="image/ico">
<link rel="stylesheet" type="text/css" media="screen" href="e.css">
<link rel="stylesheet" type="text/css" media="screen" href="edoxy.css">
</head>
<body>
<div id="container">
<div id="header">
<div class="layout">
<h1><span>Enlightenment</span></h1>
<h2><span>Beauty at your fingertips</span></h2>
<div class="menu-container">
<div class="menu">
<ul>
<li class="current"><a href="http://web.enlightenment.org/p.php?p=docs">Docs</a></li>
<li><a href="http://trac.enlightenment.org/e">Tracker</a></li>
<li><a href="http://www.enlightenment.org/p.php?p=contact">Contact</a></li>
<li><a href="http://www.enlightenment.org/p.php?p=contribute">Contribute</a></li>
<li><a href="http://www.enlightenment.org/p.php?p=support">Support</a></li>
<li><a href="http://www.enlightenment.org/p.php?p=download">Download</a></li>
<li><a href="http://www.enlightenment.org/p.php?p=about">About</a></li>
<li><a href="http://www.enlightenment.org/p.php?p=news">News</a></li>
<li><a href="http://www.enlightenment.org/">Home</a></li>
</ul>
</div>
</div>
<div class="doxytitle">
Evas Documentation <small>at Thu Jul 14 2011</small>
</div>
<div class="menu-container">
<div class="submenu">
<ul class="current">
<li><a href="todo.html">Todo</a></li>
<li><a href="files.html">Files</a></li>
<li><a href="annotated.html">Data Structures</a></li>
<li><a href="globals.html">Globals</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="pages.html">Related Pages</a></li>
<li class="current"><a href="index.html">Main Page</a></li>
</ul>
</div>
</div>
<div class="clear"></div>
</div>
</div>
<div id="content">
<div class="layout">
<!-- Generated by Doxygen 1.7.4 -->
</div>
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">General Utilities</div> </div>
</div>
<div class="contents">
<p>Some functions that are handy but are not specific of canvas or objects.
<a href="#details">More...</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#ga50bb423e88ce97cf82cca9b316fc7a1a">evas_load_error_str</a> (<a class="el" href="Evas_8h.html#aff351ae694a58aecd7834ef12bdf3d64">Evas_Load_Error</a> error)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Converts the given error code into a string describing it in english. <a href="#ga50bb423e88ce97cf82cca9b316fc7a1a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#ga2a28c2e6ecdc72189040ae3f5bd829d0">evas_color_hsv_to_rgb</a> (float h, float s, float v, int *r, int *g, int *b)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convert a given color from HSV to RGB format. <a href="#ga2a28c2e6ecdc72189040ae3f5bd829d0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#ga4054acb14873d5923306ddde5537171d">evas_color_rgb_to_hsv</a> (int r, int g, int b, float *h, float *s, float *v)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Convert a given color from RGB to HSV format. <a href="#ga4054acb14873d5923306ddde5537171d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#ga892ffc2ac011e24a141816e0c72f7dfa">evas_color_argb_premul</a> (int a, int *r, int *g, int *b)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Pre-multiplies a rgb triplet by an alpha factor. <a href="#ga892ffc2ac011e24a141816e0c72f7dfa"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#ga520b64aa41b81e13bf7fc9f16fd2f3e5">evas_color_argb_unpremul</a> (int a, int *r, int *g, int *b)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Undo pre-multiplication of a rgb triplet by an alpha factor. <a href="#ga520b64aa41b81e13bf7fc9f16fd2f3e5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#gad61423a02fa7c3cb0293c3bdd5516216">evas_data_argb_premul</a> (unsigned int *data, unsigned int len)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Pre-multiplies data by an alpha factor. <a href="#gad61423a02fa7c3cb0293c3bdd5516216"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#ga6794135ce6545bd5e16f6563043a8f18">evas_data_argb_unpremul</a> (unsigned int *data, unsigned int len)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Undo pre-multiplication data by an alpha factor. <a href="#ga6794135ce6545bd5e16f6563043a8f18"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#ga31161605cf449d16e0ea0183509a1e3b">evas_string_char_next_get</a> (const char *str, int pos, int *decoded)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the next character in the string. <a href="#ga31161605cf449d16e0ea0183509a1e3b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#ga20119def41aa1f24aea7961b3fa0fd72">evas_string_char_prev_get</a> (const char *str, int pos, int *decoded)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the previous character in the string. <a href="#ga20119def41aa1f24aea7961b3fa0fd72"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Evas__Utils.html#gaf9edd726590b1f56ca3e566ba1a2dbb2">evas_string_char_len_get</a> (const char *str)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the length in characters of the string. <a href="#gaf9edd726590b1f56ca3e566ba1a2dbb2"></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<p>Some functions that are handy but are not specific of canvas or objects. </p>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga892ffc2ac011e24a141816e0c72f7dfa"></a><!-- doxytag: member="evas_main.c::evas_color_argb_premul" ref="ga892ffc2ac011e24a141816e0c72f7dfa" args="(int a, int *r, int *g, int *b)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void evas_color_argb_premul </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>a</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>r</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>g</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>b</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Pre-multiplies a rgb triplet by an alpha factor. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">a</td><td>The alpha factor. </td></tr>
<tr><td class="paramname">r</td><td>The Red component of the color. </td></tr>
<tr><td class="paramname">g</td><td>The Green component of the color. </td></tr>
<tr><td class="paramname">b</td><td>The Blue component of the color.</td></tr>
</table>
</dd>
</dl>
<p>This function pre-multiplies a given rbg triplet by an alpha factor. Alpha factor is used to define transparency. </p>
</div>
</div>
<a class="anchor" id="ga520b64aa41b81e13bf7fc9f16fd2f3e5"></a><!-- doxytag: member="evas_main.c::evas_color_argb_unpremul" ref="ga520b64aa41b81e13bf7fc9f16fd2f3e5" args="(int a, int *r, int *g, int *b)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void evas_color_argb_unpremul </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>a</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>r</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>g</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>b</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Undo pre-multiplication of a rgb triplet by an alpha factor. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">a</td><td>The alpha factor. </td></tr>
<tr><td class="paramname">r</td><td>The Red component of the color. </td></tr>
<tr><td class="paramname">g</td><td>The Green component of the color. </td></tr>
<tr><td class="paramname">b</td><td>The Blue component of the color.</td></tr>
</table>
</dd>
</dl>
<p>This function undoes pre-multiplication a given rbg triplet by an alpha factor. Alpha factor is used to define transparency.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__Evas__Utils.html#ga892ffc2ac011e24a141816e0c72f7dfa" title="Pre-multiplies a rgb triplet by an alpha factor.">evas_color_argb_premul()</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="ga2a28c2e6ecdc72189040ae3f5bd829d0"></a><!-- doxytag: member="evas_main.c::evas_color_hsv_to_rgb" ref="ga2a28c2e6ecdc72189040ae3f5bd829d0" args="(float h, float s, float v, int *r, int *g, int *b)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void evas_color_hsv_to_rgb </td>
<td>(</td>
<td class="paramtype">float </td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">float </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">float </td>
<td class="paramname"><em>v</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>r</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>g</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>b</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Convert a given color from HSV to RGB format. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">h</td><td>The Hue component of the color. </td></tr>
<tr><td class="paramname">s</td><td>The Saturation component of the color. </td></tr>
<tr><td class="paramname">v</td><td>The Value component of the color. </td></tr>
<tr><td class="paramname">r</td><td>The Red component of the color. </td></tr>
<tr><td class="paramname">g</td><td>The Green component of the color. </td></tr>
<tr><td class="paramname">b</td><td>The Blue component of the color.</td></tr>
</table>
</dd>
</dl>
<p>This function converts a given color in HSV color format to RGB color format. </p>
</div>
</div>
<a class="anchor" id="ga4054acb14873d5923306ddde5537171d"></a><!-- doxytag: member="evas_main.c::evas_color_rgb_to_hsv" ref="ga4054acb14873d5923306ddde5537171d" args="(int r, int g, int b, float *h, float *s, float *v)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void evas_color_rgb_to_hsv </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>r</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>g</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>b</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">float * </td>
<td class="paramname"><em>h</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">float * </td>
<td class="paramname"><em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">float * </td>
<td class="paramname"><em>v</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Convert a given color from RGB to HSV format. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">r</td><td>The Red component of the color. </td></tr>
<tr><td class="paramname">g</td><td>The Green component of the color. </td></tr>
<tr><td class="paramname">b</td><td>The Blue component of the color. </td></tr>
<tr><td class="paramname">h</td><td>The Hue component of the color. </td></tr>
<tr><td class="paramname">s</td><td>The Saturation component of the color. </td></tr>
<tr><td class="paramname">v</td><td>The Value component of the color.</td></tr>
</table>
</dd>
</dl>
<p>This function converts a given color in RGB color format to HSV color format. </p>
</div>
</div>
<a class="anchor" id="gad61423a02fa7c3cb0293c3bdd5516216"></a><!-- doxytag: member="evas_main.c::evas_data_argb_premul" ref="gad61423a02fa7c3cb0293c3bdd5516216" args="(unsigned int *data, unsigned int len)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void evas_data_argb_premul </td>
<td>(</td>
<td class="paramtype">unsigned int * </td>
<td class="paramname"><em>data</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>len</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Pre-multiplies data by an alpha factor. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">data</td><td>The data value. </td></tr>
<tr><td class="paramname">len</td><td>The length value.</td></tr>
</table>
</dd>
</dl>
<p>This function pre-multiplies a given data by an alpha factor. Alpha factor is used to define transparency. </p>
</div>
</div>
<a class="anchor" id="ga6794135ce6545bd5e16f6563043a8f18"></a><!-- doxytag: member="evas_main.c::evas_data_argb_unpremul" ref="ga6794135ce6545bd5e16f6563043a8f18" args="(unsigned int *data, unsigned int len)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void evas_data_argb_unpremul </td>
<td>(</td>
<td class="paramtype">unsigned int * </td>
<td class="paramname"><em>data</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>len</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Undo pre-multiplication data by an alpha factor. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">data</td><td>The data value. </td></tr>
<tr><td class="paramname">len</td><td>The length value.</td></tr>
</table>
</dd>
</dl>
<p>This function undoes pre-multiplication of a given data by an alpha factor. Alpha factor is used to define transparency. </p>
</div>
</div>
<a class="anchor" id="ga50bb423e88ce97cf82cca9b316fc7a1a"></a><!-- doxytag: member="evas_main.c::evas_load_error_str" ref="ga50bb423e88ce97cf82cca9b316fc7a1a" args="(Evas_Load_Error error)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI const char* evas_load_error_str </td>
<td>(</td>
<td class="paramtype"><a class="el" href="Evas_8h.html#aff351ae694a58aecd7834ef12bdf3d64">Evas_Load_Error</a> </td>
<td class="paramname"><em>error</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Converts the given error code into a string describing it in english. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">error</td><td>the error code. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Always return a valid string. If given <code>error</code> is not supported "Unknown error" is returned. </dd></dl>
<p>References <a class="el" href="Evas_8h.html#ac6e5fe4a54ab26d2d9ceaefff0962b5fa7ba46c8865335ca085213b7dbf039a75">EVAS_LOAD_ERROR_CORRUPT_FILE</a>, <a class="el" href="Evas_8h.html#ac6e5fe4a54ab26d2d9ceaefff0962b5fa0230814bb1fe9cb194e253e840aa8529">EVAS_LOAD_ERROR_DOES_NOT_EXIST</a>, <a class="el" href="Evas_8h.html#ac6e5fe4a54ab26d2d9ceaefff0962b5fab9e5061c8c74bcd8a283fb7598a8b81d">EVAS_LOAD_ERROR_GENERIC</a>, <a class="el" href="Evas_8h.html#ac6e5fe4a54ab26d2d9ceaefff0962b5fa016233a6ae27765a3aa2759753c112ac">EVAS_LOAD_ERROR_NONE</a>, <a class="el" href="Evas_8h.html#ac6e5fe4a54ab26d2d9ceaefff0962b5fa17e04ec01edcabf21f33537872fb7200">EVAS_LOAD_ERROR_PERMISSION_DENIED</a>, <a class="el" href="Evas_8h.html#ac6e5fe4a54ab26d2d9ceaefff0962b5fa22a36ddde85a5fd1c1f2e68d7052f6f4">EVAS_LOAD_ERROR_RESOURCE_ALLOCATION_FAILED</a>, and <a class="el" href="Evas_8h.html#ac6e5fe4a54ab26d2d9ceaefff0962b5fa604b6c7bf6345c773d3083707d9f0a80">EVAS_LOAD_ERROR_UNKNOWN_FORMAT</a>.</p>
</div>
</div>
<a class="anchor" id="gaf9edd726590b1f56ca3e566ba1a2dbb2"></a><!-- doxytag: member="evas_object_text.c::evas_string_char_len_get" ref="gaf9edd726590b1f56ca3e566ba1a2dbb2" args="(const char *str)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int evas_string_char_len_get </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>str</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the length in characters of the string. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>The string to get the length of. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The length in characters (not bytes) </dd></dl>
</div>
</div>
<a class="anchor" id="ga31161605cf449d16e0ea0183509a1e3b"></a><!-- doxytag: member="evas_object_text.c::evas_string_char_next_get" ref="ga31161605cf449d16e0ea0183509a1e3b" args="(const char *str, int pos, int *decoded)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int evas_string_char_next_get </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>pos</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>decoded</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the next character in the string. </p>
<p>Given the UTF-8 string in <code>str</code>, and starting byte position in <code>pos</code>, this function will place in <code>decoded</code> the decoded code point at <code>pos</code> and return the byte index for the next character in the string.</p>
<p>The only boundary check done is that <code>pos</code> must be >= 0. Other than that, no checks are performed, so passing an index value that's not within the length of the string will result in undefined behavior.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>The UTF-8 string </td></tr>
<tr><td class="paramname">pos</td><td>The byte index where to start </td></tr>
<tr><td class="paramname">decoded</td><td>Address where to store the decoded code point. Optional.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The byte index of the next character </dd></dl>
</div>
</div>
<a class="anchor" id="ga20119def41aa1f24aea7961b3fa0fd72"></a><!-- doxytag: member="evas_object_text.c::evas_string_char_prev_get" ref="ga20119def41aa1f24aea7961b3fa0fd72" args="(const char *str, int pos, int *decoded)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int evas_string_char_prev_get </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>str</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>pos</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"><em>decoded</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the previous character in the string. </p>
<p>Given the UTF-8 string in <code>str</code>, and starting byte position in <code>pos</code>, this function will place in <code>decoded</code> the decoded code point at <code>pos</code> and return the byte index for the previous character in the string.</p>
<p>The only boundary check done is that <code>pos</code> must be >= 1. Other than that, no checks are performed, so passing an index value that's not within the length of the string will result in undefined behavior.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>The UTF-8 string </td></tr>
<tr><td class="paramname">pos</td><td>The byte index where to start </td></tr>
<tr><td class="paramname">decoded</td><td>Address where to store the decoded code point. Optional.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The byte index of the previous character </dd></dl>
</div>
</div>
</div>
<div id="push"></div>
</div> <!-- #content -->
</div> <!-- .layout -->
</div> <!-- #container -->
<div id="footer">
<table><tr>
<td class="poweredby"><img src="doxygen.png"></td>
<td class="copyright">Copyright ©2011 Enlightenment</td>
<td class="generated">Docs generated Thu Jul 14 2011 20:45:33</td>
</tr></table>
</div>
</body>
</html>
