1mail::folder::hasMessagemsa(i3lx:):folder Native API refmearieln:c:efolder::hasMessages(3x)
2
3
4
6 mail::folder::hasMessages - Determine if the folder is capable of stor‐
7 ing messages
8
10 #include <libmail/mail.H>
11
12 mail::folder *folder;
13
14
15
16 bool flag=folder->hasMessages(void);
17
19 Some folders contain messages. Other folders contain other folder
20 (subfolders). Some IMAP servers are capable of creating dual-purpose
21 folders that contain both messages and other subfolders. The hasMes‐
22 sages method indicates whether folder is capable of storing messages.
23
25 A true result indicates that folder is capable of storing messages. It
26 may not necessarily mean that folder actually contains any messages, it
27 might very well be an empty folder.
28
29 Note:
30
31 POP3 folders return a true, even though application cannot
32 directly add messages to POP3 folders. Applications should
33 interpret a true result to mean that:
34
35 · mail::folder::open(3x) may be used to open this folder.
36
37 · This folder's mail::folder::addmessage(3x) method, and using
38 this folder as a parameter to mail::folder::copyMessagesTo(3x)
39 will probably work.
40
41 Applications should interpret a false result as a guarantee that
42 neither of the above procedures will work.
43
45 mail::folder::hasSubFolders(3x).
46
47
48
49 10 April 2006 mail::folder::hasMessages(3x)