2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
4
<refentry id="libebook-EAddressWestern">
6
<refentrytitle role="top_of_page" id="libebook-EAddressWestern.top_of_page">e-address-western</refentrytitle>
7
<manvolnum>3</manvolnum>
13
<refname>e-address-western</refname>
14
<refpurpose>A physical address in the format used in the Western hemisphere.</refpurpose>
17
<refsynopsisdiv id="libebook-EAddressWestern.synopsis" role="synopsis">
18
<title role="synopsis.title">Synopsis</title>
20
<synopsis> <link linkend="EAddressWestern">EAddressWestern</link>;
21
<link linkend="EAddressWestern"><returnvalue>EAddressWestern</returnvalue></link> * <link linkend="e-address-western-parse">e_address_western_parse</link> (<parameter>const <link linkend="gchar"><type>gchar</type></link> *in_address</parameter>);
22
<link linkend="void"><returnvalue>void</returnvalue></link> <link linkend="e-address-western-free">e_address_western_free</link> (<parameter><link linkend="EAddressWestern"><type>EAddressWestern</type></link> *eaw</parameter>);
26
<refsect1 id="libebook-EAddressWestern.description" role="desc">
27
<title role="desc.title">Description</title>
31
<refsect1 id="libebook-EAddressWestern.details" role="details">
32
<title role="details.title">Details</title>
33
<refsect2 id="EAddressWestern" role="struct">
34
<title>EAddressWestern</title>
35
<indexterm zone="EAddressWestern"><primary>EAddressWestern</primary></indexterm>
36
<programlisting>typedef struct {
39
gchar *extended; /* I'm not sure what this is. */
41
gchar *locality; /* For example, the city or town. */
42
gchar *region; /* The state or province. */
49
<refsect2 id="e-address-western-parse" role="function">
50
<title>e_address_western_parse ()</title>
51
<indexterm zone="e-address-western-parse"><primary>e_address_western_parse</primary></indexterm>
52
<programlisting><link linkend="EAddressWestern"><returnvalue>EAddressWestern</returnvalue></link> * e_address_western_parse (<parameter>const <link linkend="gchar"><type>gchar</type></link> *in_address</parameter>);</programlisting>
54
Parses a string representing a mailing address into a
55
structure of type <link linkend="EAddressWestern"><type>EAddressWestern</type></link>.</para>
56
<variablelist role="params">
57
<varlistentry><term><parameter>in_address</parameter> :</term>
58
<listitem><simpara>a string representing a mailing address
59
</simpara></listitem></varlistentry>
60
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A new <link linkend="EAddressWestern"><type>EAddressWestern</type></link> structure, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the parsing failed.
61
</simpara></listitem></varlistentry>
62
</variablelist></refsect2>
63
<refsect2 id="e-address-western-free" role="function">
64
<title>e_address_western_free ()</title>
65
<indexterm zone="e-address-western-free"><primary>e_address_western_free</primary></indexterm>
66
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link> e_address_western_free (<parameter><link linkend="EAddressWestern"><type>EAddressWestern</type></link> *eaw</parameter>);</programlisting>
68
Frees <parameter>eaw</parameter> and its contents.</para>
69
<variablelist role="params">
70
<varlistentry><term><parameter>eaw</parameter> :</term>
71
<listitem><simpara>an <link linkend="EAddressWestern"><type>EAddressWestern</type></link>
72
</simpara></listitem></varlistentry>
73
</variablelist></refsect2>