<html>
<head>
<title>Embryo: Embryo Data String Functions</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">
Embryo Documentation <small>at Tue Feb 8 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.3 -->
</div>
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<h1>Embryo Data String Functions</h1> </div>
</div>
<div class="contents">
<p>Functions that operate on strings in the memory of a virtual machine.
<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 int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Embryo__Data__String__Group.html#ga017e96ff1b5c2806c462ba08416a72d9">embryo_data_string_length_get</a> (Embryo_Program *ep, Embryo_Cell *str_cell)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the length of the string starting at the given cell. <a href="#ga017e96ff1b5c2806c462ba08416a72d9"></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__Embryo__Data__String__Group.html#ga6056316c070a146eb63f08e8e4176328">embryo_data_string_get</a> (Embryo_Program *ep, Embryo_Cell *str_cell, char *dst)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copies the string starting at the given cell to the given buffer. <a href="#ga6056316c070a146eb63f08e8e4176328"></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__Embryo__Data__String__Group.html#ga2f1b7e5ce221aaada5663e46f2578815">embryo_data_string_set</a> (Embryo_Program *ep, const char *src, Embryo_Cell *str_cell)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copies string in the given buffer into the virtual machine memory starting at the given cell. <a href="#ga2f1b7e5ce221aaada5663e46f2578815"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">EAPI Embryo_Cell * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__Embryo__Data__String__Group.html#gaa9c6beeb074c4495711c4817874ce04e">embryo_data_address_get</a> (Embryo_Program *ep, Embryo_Cell addr)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retreives a pointer to the address in the virtual machine given by the given cell. <a href="#gaa9c6beeb074c4495711c4817874ce04e"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Functions that operate on strings in the memory of a virtual machine. </p>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gaa9c6beeb074c4495711c4817874ce04e"></a><!-- doxytag: member="embryo_amx.c::embryo_data_address_get" ref="gaa9c6beeb074c4495711c4817874ce04e" args="(Embryo_Program *ep, Embryo_Cell addr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI Embryo_Cell* embryo_data_address_get </td>
<td>(</td>
<td class="paramtype">Embryo_Program * </td>
<td class="paramname"><em>ep</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Embryo_Cell </td>
<td class="paramname"><em>addr</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retreives a pointer to the address in the virtual machine given by the given cell. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">ep</td><td>The program whose virtual machine address is being queried. </td></tr>
<tr><td class="paramname">addr</td><td>The given cell. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to the cell at the given address. </dd></dl>
<p>Referenced by <a class="el" href="group__Embryo__Run__Group.html#ga29c5d998350f875882c2672c9be617c6">embryo_program_run()</a>.</p>
</div>
</div>
<a class="anchor" id="ga6056316c070a146eb63f08e8e4176328"></a><!-- doxytag: member="embryo_amx.c::embryo_data_string_get" ref="ga6056316c070a146eb63f08e8e4176328" args="(Embryo_Program *ep, Embryo_Cell *str_cell, char *dst)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void embryo_data_string_get </td>
<td>(</td>
<td class="paramtype">Embryo_Program * </td>
<td class="paramname"><em>ep</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Embryo_Cell * </td>
<td class="paramname"><em>str_cell</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">char * </td>
<td class="paramname"><em>dst</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Copies the string starting at the given cell to the given buffer. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">ep</td><td>The program the cell is part of. </td></tr>
<tr><td class="paramname">str_cell</td><td>Pointer to the first cell of the string. </td></tr>
<tr><td class="paramname">dst</td><td>The given buffer. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga017e96ff1b5c2806c462ba08416a72d9"></a><!-- doxytag: member="embryo_amx.c::embryo_data_string_length_get" ref="ga017e96ff1b5c2806c462ba08416a72d9" args="(Embryo_Program *ep, Embryo_Cell *str_cell)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI int embryo_data_string_length_get </td>
<td>(</td>
<td class="paramtype">Embryo_Program * </td>
<td class="paramname"><em>ep</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Embryo_Cell * </td>
<td class="paramname"><em>str_cell</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieves the length of the string starting at the given cell. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">ep</td><td>The program the cell is part of. </td></tr>
<tr><td class="paramname">str_cell</td><td>Pointer to the first cell of the string. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The length of the string. <code>0</code> is returned if there is an error. </dd></dl>
</div>
</div>
<a class="anchor" id="ga2f1b7e5ce221aaada5663e46f2578815"></a><!-- doxytag: member="embryo_amx.c::embryo_data_string_set" ref="ga2f1b7e5ce221aaada5663e46f2578815" args="(Embryo_Program *ep, const char *src, Embryo_Cell *str_cell)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">EAPI void embryo_data_string_set </td>
<td>(</td>
<td class="paramtype">Embryo_Program * </td>
<td class="paramname"><em>ep</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">Embryo_Cell * </td>
<td class="paramname"><em>str_cell</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Copies string in the given buffer into the virtual machine memory starting at the given cell. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">ep</td><td>The program the cell is part of. </td></tr>
<tr><td class="paramname">src</td><td>The given buffer. </td></tr>
<tr><td class="paramname">str_cell</td><td>Pointer to the first cell to copy the string to. </td></tr>
</table>
</dd>
</dl>
<p>Referenced by <a class="el" href="group__Embryo__Run__Group.html#ga29c5d998350f875882c2672c9be617c6">embryo_program_run()</a>.</p>
</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 Tue Feb 8 2011 18:11:42</td>
</tr></table>
</div>
</body>
</html>
