mirror of
https://github.com/deltachat/deltachat-core.git
synced 2025-10-04 18:29:19 +02:00
425 lines
24 KiB
HTML
425 lines
24 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
|
|
<meta name="generator" content="Doxygen 1.8.11"/>
|
|
<title>Delta Chat Core C-API: mrcontact_t Struct Reference</title>
|
|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="jquery.js"></script>
|
|
<script type="text/javascript" src="dynsections.js"></script>
|
|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="search/searchdata.js"></script>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<script type="text/javascript">
|
|
$(document).ready(function() { init_search(); });
|
|
</script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
<link href="user.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">Delta Chat Core C-API
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.8.11 -->
|
|
<script type="text/javascript">
|
|
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
|
</script>
|
|
<div id="navrow1" class="tabs">
|
|
<ul class="tablist">
|
|
<li><a href="index.html"><span>Main Page</span></a></li>
|
|
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
|
|
<li><a href="files.html"><span>Files</span></a></li>
|
|
<li>
|
|
<div id="MSearchBox" class="MSearchBoxInactive">
|
|
<span class="left">
|
|
<img id="MSearchSelect" src="search/mag_sel.png"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
alt=""/>
|
|
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
|
onfocus="searchBox.OnSearchFieldFocus(true)"
|
|
onblur="searchBox.OnSearchFieldFocus(false)"
|
|
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
|
</span><span class="right">
|
|
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
|
</span>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div id="navrow2" class="tabs2">
|
|
<ul class="tablist">
|
|
<li><a href="annotated.html"><span>Class List</span></a></li>
|
|
<li><a href="functions.html"><span>Class Members</span></a></li>
|
|
</ul>
|
|
</div>
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
</div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<iframe src="javascript:void(0)" frameborder="0"
|
|
name="MSearchResults" id="MSearchResults">
|
|
</iframe>
|
|
</div>
|
|
|
|
</div><!-- top -->
|
|
<div class="header">
|
|
<div class="summary">
|
|
<a href="#pub-methods">Public Member Functions</a> |
|
|
<a href="#pub-attribs">Public Attributes</a> |
|
|
<a href="structmrcontact__t-members.html">List of all members</a> </div>
|
|
<div class="headertitle">
|
|
<div class="title">mrcontact_t Struct Reference</div> </div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
|
|
<p>An object representing a single contact in memory.
|
|
<a href="structmrcontact__t.html#details">More...</a></p>
|
|
|
|
<p><code>#include <<a class="el" href="mrcontact_8h_source.html">mrcontact.h</a>></code></p>
|
|
<table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
|
|
Public Member Functions</h2></td></tr>
|
|
<tr class="memitem:a38e17e55cd66f5e86a1dcb8d1f67797a"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#a38e17e55cd66f5e86a1dcb8d1f67797a">mrcontact_unref</a> (<a class="el" href="structmrcontact__t.html">mrcontact_t</a> *contact)</td></tr>
|
|
<tr class="memdesc:a38e17e55cd66f5e86a1dcb8d1f67797a"><td class="mdescLeft"> </td><td class="mdescRight">Free a contact object. <a href="#a38e17e55cd66f5e86a1dcb8d1f67797a">More...</a><br /></td></tr>
|
|
<tr class="separator:a38e17e55cd66f5e86a1dcb8d1f67797a"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:abfe19c7f41061c1946d00556f3e4a971"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#abfe19c7f41061c1946d00556f3e4a971">mrcontact_get_addr</a> (<a class="el" href="structmrcontact__t.html">mrcontact_t</a> *contact)</td></tr>
|
|
<tr class="memdesc:abfe19c7f41061c1946d00556f3e4a971"><td class="mdescLeft"> </td><td class="mdescRight">Get email address. <a href="#abfe19c7f41061c1946d00556f3e4a971">More...</a><br /></td></tr>
|
|
<tr class="separator:abfe19c7f41061c1946d00556f3e4a971"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a5b559ef46c96f38bf2d1f2c39de3ccb2"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#a5b559ef46c96f38bf2d1f2c39de3ccb2">mrcontact_get_name</a> (<a class="el" href="structmrcontact__t.html">mrcontact_t</a> *contact)</td></tr>
|
|
<tr class="memdesc:a5b559ef46c96f38bf2d1f2c39de3ccb2"><td class="mdescLeft"> </td><td class="mdescRight">Get name. <a href="#a5b559ef46c96f38bf2d1f2c39de3ccb2">More...</a><br /></td></tr>
|
|
<tr class="separator:a5b559ef46c96f38bf2d1f2c39de3ccb2"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a29a93300d97183f795fc711c93fac689"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#a29a93300d97183f795fc711c93fac689">mrcontact_get_display_name</a> (<a class="el" href="structmrcontact__t.html">mrcontact_t</a> *contact)</td></tr>
|
|
<tr class="memdesc:a29a93300d97183f795fc711c93fac689"><td class="mdescLeft"> </td><td class="mdescRight">Get display name. <a href="#a29a93300d97183f795fc711c93fac689">More...</a><br /></td></tr>
|
|
<tr class="separator:a29a93300d97183f795fc711c93fac689"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a2658329d9e3c74f93943dfd8c25554b2"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#a2658329d9e3c74f93943dfd8c25554b2">mrcontact_get_name_n_addr</a> (<a class="el" href="structmrcontact__t.html">mrcontact_t</a> *contact)</td></tr>
|
|
<tr class="memdesc:a2658329d9e3c74f93943dfd8c25554b2"><td class="mdescLeft"> </td><td class="mdescRight">Get a summary of name and address. <a href="#a2658329d9e3c74f93943dfd8c25554b2">More...</a><br /></td></tr>
|
|
<tr class="separator:a2658329d9e3c74f93943dfd8c25554b2"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a804337f9c9e735a5429559b0fcb06121"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#a804337f9c9e735a5429559b0fcb06121">mrcontact_get_first_name</a> (const char *full_name)</td></tr>
|
|
<tr class="memdesc:a804337f9c9e735a5429559b0fcb06121"><td class="mdescLeft"> </td><td class="mdescRight">Get the first name. <a href="#a804337f9c9e735a5429559b0fcb06121">More...</a><br /></td></tr>
|
|
<tr class="separator:a804337f9c9e735a5429559b0fcb06121"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ad906207191f0cfd62e408dbc82a156cf"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#ad906207191f0cfd62e408dbc82a156cf">mrcontact_normalize_name</a> (char *full_name)</td></tr>
|
|
<tr class="memdesc:ad906207191f0cfd62e408dbc82a156cf"><td class="mdescLeft"> </td><td class="mdescRight">Normalize a name in-place. <a href="#ad906207191f0cfd62e408dbc82a156cf">More...</a><br /></td></tr>
|
|
<tr class="separator:ad906207191f0cfd62e408dbc82a156cf"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a>
|
|
Public Attributes</h2></td></tr>
|
|
<tr class="memitem:ab2ee31297c327e04ed14673adbd49716"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#ab2ee31297c327e04ed14673adbd49716">m_id</a></td></tr>
|
|
<tr class="memdesc:ab2ee31297c327e04ed14673adbd49716"><td class="mdescLeft"> </td><td class="mdescRight">The contact ID. <a href="#ab2ee31297c327e04ed14673adbd49716">More...</a><br /></td></tr>
|
|
<tr class="separator:ab2ee31297c327e04ed14673adbd49716"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a48fba862b41f7da3b8c6193c0554654b"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#a48fba862b41f7da3b8c6193c0554654b">m_name</a></td></tr>
|
|
<tr class="memdesc:a48fba862b41f7da3b8c6193c0554654b"><td class="mdescLeft"> </td><td class="mdescRight">Contact name. <a href="#a48fba862b41f7da3b8c6193c0554654b">More...</a><br /></td></tr>
|
|
<tr class="separator:a48fba862b41f7da3b8c6193c0554654b"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a559c848feee29d334098f9a581448e56"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#a559c848feee29d334098f9a581448e56">m_authname</a></td></tr>
|
|
<tr class="memdesc:a559c848feee29d334098f9a581448e56"><td class="mdescLeft"> </td><td class="mdescRight">Name authorized by the contact himself. <a href="#a559c848feee29d334098f9a581448e56">More...</a><br /></td></tr>
|
|
<tr class="separator:a559c848feee29d334098f9a581448e56"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:aaedd60ba4cad97bb87ba5a55958341e5"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#aaedd60ba4cad97bb87ba5a55958341e5">m_addr</a></td></tr>
|
|
<tr class="memdesc:aaedd60ba4cad97bb87ba5a55958341e5"><td class="mdescLeft"> </td><td class="mdescRight">E-Mail-Address of the contact. <a href="#aaedd60ba4cad97bb87ba5a55958341e5">More...</a><br /></td></tr>
|
|
<tr class="separator:aaedd60ba4cad97bb87ba5a55958341e5"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ac22d500e5c439b07c943ed2c7afb2a23"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="structmrcontact__t.html#ac22d500e5c439b07c943ed2c7afb2a23">m_blocked</a></td></tr>
|
|
<tr class="memdesc:ac22d500e5c439b07c943ed2c7afb2a23"><td class="mdescLeft"> </td><td class="mdescRight">Blocked state. <a href="#ac22d500e5c439b07c943ed2c7afb2a23">More...</a><br /></td></tr>
|
|
<tr class="separator:ac22d500e5c439b07c943ed2c7afb2a23"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
|
|
<div class="textblock"><p>An object representing a single contact in memory. </p>
|
|
<p>The contact object is not updated. If you want an update, you have to recreate the object. </p>
|
|
</div><h2 class="groupheader">Member Function Documentation</h2>
|
|
<a class="anchor" id="a38e17e55cd66f5e86a1dcb8d1f67797a"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void mrcontact_unref </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structmrcontact__t.html">mrcontact_t</a> * </td>
|
|
<td class="paramname"><em>contact</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Free a contact object. </p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">contact</td><td>The contact object as created eg. by <a class="el" href="structmrmailbox__t.html#a057660d94350ff98eca72785c6e88962" title="Get a single contact object. ">mrmailbox_get_contact()</a>.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>None. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="abfe19c7f41061c1946d00556f3e4a971"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">char * mrcontact_get_addr </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structmrcontact__t.html">mrcontact_t</a> * </td>
|
|
<td class="paramname"><em>contact</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get email address. </p>
|
|
<p>The email address is always set for a contact.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">contact</td><td>The contact object</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>String with the email address, must be free()'d. Never returns NULL. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a5b559ef46c96f38bf2d1f2c39de3ccb2"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">char * mrcontact_get_name </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structmrcontact__t.html">mrcontact_t</a> * </td>
|
|
<td class="paramname"><em>contact</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get name. </p>
|
|
<p>This is the name as defined the the contact himself or modified by the user. May be an empty string.</p>
|
|
<p>This name is typically used in a form where the user can edit the name of a contact. This name must not be spreaded via mail (To:, CC: ...) as it as it may be sth. like "Daddy". To get a fine name to display in lists etc., use <a class="el" href="structmrcontact__t.html#a29a93300d97183f795fc711c93fac689" title="Get display name. ">mrcontact_get_display_name()</a> or <a class="el" href="structmrcontact__t.html#a2658329d9e3c74f93943dfd8c25554b2" title="Get a summary of name and address. ">mrcontact_get_name_n_addr()</a>.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">contact</td><td>The contact object</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>String with the name to display, must be free()'d. Empty string if unset, never returns NULL. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a29a93300d97183f795fc711c93fac689"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">char * mrcontact_get_display_name </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structmrcontact__t.html">mrcontact_t</a> * </td>
|
|
<td class="paramname"><em>contact</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get display name. </p>
|
|
<p>This is the name as defined the the contact himself, modified by the user or, if both are unset, the email address.</p>
|
|
<p>This name is typically used in lists and must not be speaded via mail (To:, CC: ...). To get the name editable in a formular, use mrcontact_get_edit_name().</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">contact</td><td>The contact object</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>String with the name to display, must be free()'d. Never returns NULL. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a2658329d9e3c74f93943dfd8c25554b2"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">char * mrcontact_get_name_n_addr </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="structmrcontact__t.html">mrcontact_t</a> * </td>
|
|
<td class="paramname"><em>contact</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get a summary of name and address. </p>
|
|
<p>The returned string is either "Name (email@domain.com)" or just "email@domain.com" if the name is unset.</p>
|
|
<p>The summary is typically used when asking the user something about the contact. The attached email address makes the question unique, eg. "Chat with Alan Miller (am@uniquedomain.com)?"</p>
|
|
<p>The summary must not be spreaded via mail (To:, CC: ...) as it as it may contain sth. like "Daddy".</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">contact</td><td>The contact object</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>Summary string, must be free()'d. Never returns NULL. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a804337f9c9e735a5429559b0fcb06121"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">char * mrcontact_get_first_name </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const char * </td>
|
|
<td class="paramname"><em>full_name</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Get the first name. </p>
|
|
<p>In a string, get the part before the first space. If there is no space in the string, the whole string is returned.</p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">full_name</td><td>Full name of the contct.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>String with the first name, must be free()'d after usage. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ad906207191f0cfd62e408dbc82a156cf"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void mrcontact_normalize_name </td>
|
|
<td>(</td>
|
|
<td class="paramtype">char * </td>
|
|
<td class="paramname"><em>full_name</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Normalize a name in-place. </p>
|
|
<ul>
|
|
<li>Remove quotes (come from some bad MUA implementations)</li>
|
|
<li>Convert names as "Petersen, Björn" to "Björn Petersen"</li>
|
|
<li>Trims the resulting string</li>
|
|
</ul>
|
|
<p>Typically, this function is not needed as it is called implicitly by <a class="el" href="structmrmailbox__t.html#a25720ea41355cc32cc93aa45709937d6" title="Add a number of contacts. ">mrmailbox_add_address_book()</a></p>
|
|
<dl class="params"><dt>Parameters</dt><dd>
|
|
<table class="params">
|
|
<tr><td class="paramname">full_name</td><td>Buffer with the name, is modified during processing; the resulting string may be shorter but never longer.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="section return"><dt>Returns</dt><dd>None. But the given buffer may be modified. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Member Data Documentation</h2>
|
|
<a class="anchor" id="ab2ee31297c327e04ed14673adbd49716"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">uint32_t mrcontact_t::m_id</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>The contact ID. </p>
|
|
<p>Special message IDs:</p><ul>
|
|
<li>MR_CONTACT_ID_SELF (1) - this is the owner of the mailbox with the email-address set by <a class="el" href="structmrmailbox__t.html#a19b3e9f5209bc326fc77f3944522e8ad" title="Configure the mailbox. ">mrmailbox_set_config()</a> using "addr".</li>
|
|
</ul>
|
|
<p>Normal contact IDs are larger than these special ones (larger than MR_CONTACT_ID_LAST_SPECIAL). </p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a48fba862b41f7da3b8c6193c0554654b"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">char* mrcontact_t::m_name</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Contact name. </p>
|
|
<p>It is recommended to use <a class="el" href="structmrcontact__t.html#a5b559ef46c96f38bf2d1f2c39de3ccb2" title="Get name. ">mrcontact_get_name()</a>, <a class="el" href="structmrcontact__t.html#a29a93300d97183f795fc711c93fac689" title="Get display name. ">mrcontact_get_display_name()</a> or <a class="el" href="structmrcontact__t.html#a2658329d9e3c74f93943dfd8c25554b2" title="Get a summary of name and address. ">mrcontact_get_name_n_addr()</a> to access this field. May be NULL or empty, initially set to <a class="el" href="structmrcontact__t.html#a559c848feee29d334098f9a581448e56" title="Name authorized by the contact himself. ">m_authname</a>. </p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a559c848feee29d334098f9a581448e56"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">char* mrcontact_t::m_authname</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Name authorized by the contact himself. </p>
|
|
<p>It is recommended to use <a class="el" href="structmrcontact__t.html#a5b559ef46c96f38bf2d1f2c39de3ccb2" title="Get name. ">mrcontact_get_name()</a>, <a class="el" href="structmrcontact__t.html#a29a93300d97183f795fc711c93fac689" title="Get display name. ">mrcontact_get_display_name()</a> or <a class="el" href="structmrcontact__t.html#a2658329d9e3c74f93943dfd8c25554b2" title="Get a summary of name and address. ">mrcontact_get_name_n_addr()</a> to access this field. This is the name authorized by the sender, only this name may be speaded to others, eg. in To:-lists. May be NULL or empty. </p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="aaedd60ba4cad97bb87ba5a55958341e5"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">char* mrcontact_t::m_addr</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>E-Mail-Address of the contact. </p>
|
|
<p>It is recommended to use <a class="el" href="structmrcontact__t.html#abfe19c7f41061c1946d00556f3e4a971" title="Get email address. ">mrcontact_get_addr()</a> to access this field. May be NULL. </p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ac22d500e5c439b07c943ed2c7afb2a23"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">int mrcontact_t::m_blocked</td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Blocked state. </p>
|
|
<p>1=contact is blocked, 0=contact is not blocked. To block or unblock a contact, use <a class="el" href="structmrmailbox__t.html#abb069358386b767a60444651195e0895" title="Block or unblock a contact. ">mrmailbox_block_contact()</a>. </p>
|
|
|
|
</div>
|
|
</div>
|
|
<hr/>The documentation for this struct was generated from the following files:<ul>
|
|
<li>/home/bpetersen/projects/deltachat-core/src/<a class="el" href="mrcontact_8h_source.html">mrcontact.h</a></li>
|
|
<li>/home/bpetersen/projects/deltachat-core/src/mrcontact.c</li>
|
|
</ul>
|
|
</div><!-- contents -->
|
|
<!-- start footer part -->
|
|
<hr class="footer"/><address class="footer"><small>
|
|
Generated by  <a href="http://www.doxygen.org/index.html">
|
|
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
|
</a> 1.8.11
|
|
</small></address>
|
|
</body>
|
|
</html>
|