1MAIL::ACCOUNT::FOLDE(3x)Cone: COnsole Newsreader And EMAIL::ACCOUNT::FOLDE(3x)
2
3
4
6 mail::account::folderFromString - Restore a folder object
7
9 #include <libmail/mail.H>
10 mail::account *account;
11 mail::folder *folder;
12
13 std::string savedFolder=folder->toString();
14
15 ...
16
17 mail::folder *f=account->folderFromString(std::string savedFolder);
18
20 savedFolder is a folder object that was previously saved as a string.
21 The mail::account::folderFromString method recreates the original
22 folder object. That is, the returned mail::folder object refers to the
23 same mail folder as the original mail::folder object.
24
25 Note
26 Folders may only be recreated by mail::account objects that
27 reference the same mail account referenced by the original
28 mail::folder object.
29
31 This function returns a NULL pointer if it cannot allocate memory for
32 the new mail::folder object.
33
34 Note
35 mail::folders are linked to their corresponding mail::accounts. A
36 mail::folder created by one mail::account may not be used with a
37 different mail::folder. All mail::folders created by a
38 mail::account are invalidated when this mail::account object is
39 destroyed. Note that the mail::folder objects are not automatically
40 destroyed; the application is still responsible for destroying any
41 remaining mail::folders, after their a mail::account is destroyed.
42
44 mail::account::findFolder(3x).
45
46
47
48[FIXME: source] 05/08/2010 MAIL::ACCOUNT::FOLDE(3x)