1mail::account::folderFrmoamiSlt:r:iancgc(o3uxn)t Native AmPaIilr:e:faecrceonucnet::folderFromString(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
18
19 mail::folder *f=account->folderFromString (std::string savedFolder);
20
22 savedFolder is a folder object that was previously saved as a string.
23 The mail::account::folderFromString method recreates the original
24 folder object. That is, the returned mail::folder object refers to the
25 same mail folder as the original mail::folder object.
26
27 Note: Folders may only be recreated by mail::account objects
28 that reference the same mail account referenced by the original
29 mail::folder object.
30
32 This function returns a NULL pointer if it cannot allocate memory for
33 the new mail::folder object.
34
35 Note: mail::folders are linked to their corresponding
36 mail::accounts. A mail::folder created by one mail::account may
37 not be used with a different mail::folder. All mail::folders
38 created by a mail::account are invalidated when this
39 mail::account object is destroyed. Note that the mail::folder
40 objects are not automatically destroyed; the application is
41 still responsible for destroying any remaining mail::folders,
42 after their a mail::account is destroyed.
43
45 mail::account::findFolder(3x).
46
47
48
49 10 April 20m0a6il::account::folderFromString(3x)