1        Cone©
2
3MAIL::ACCOUNT::TRANS(3x)Cone: COnsole Newsreader And EMAIL::ACCOUNT::TRANS(3x)
4
5
6

NAME

8       mail::account::translatePath - Convert readable folder path to internal
9       folder path
10

SYNOPSIS

12       std::string folderPath=folder->getPath();
13
14       std::string path=account->translatePath(std::string folderPath);
15

USAGE

17       This function converts a human-readable representation of a folder's
18       path to the internal folder path in the mail account. For example, IMAP
19       server mailboxes use names encoded in a modified version of the UTF-7
20       character set, and this method converts a folder path from the
21       application's character set to the modified UTF-7 character set.
22       Specifically:
23
24       IMAP[1]
25           folderPath is converted from application's character set to the
26           modified UTF-7 character set.
27
28       SMAP
29           folderPath is converted from application's character set to UTF-8.
30           The forward slash character, “/” separates names of individual
31           folders in the SMAP hierarchy. Unicode/ISO-10646 characters that
32           cannot be represented in the application's character set may be
33           specified as “%n;”, where n is a decimal Unicode value. Use “\/” to
34           specify a forward slash character in the folder name, “\\” to
35           specify a backslash character, and “\%” to specify the “%”
36           character.
37
38       mbox mail folders, and maildirs
39           folderPath is converted from application's character set to
40           modified UTF-7 encoding. The forward slash character, “/” separates
41           names of individual folders in the local mail folder hierarchy.
42           Unicode/ISO-10646 characters that cannot be represented in the
43           application's character set may be specified as “%n;”, where n is a
44           decimal Unicode value. Use “\\” to specify a backslash character,
45           and “\%” to specify the “%” character.
46

RETURN CODES AND CALLBACKS

48       This function returns the converted path string. An empty string is
49       returned if folderPath is not a valid folder path.
50

SEE ALSO

52       mail::account::findfolder(3x), mail::account::folderFromString(3x),
53       mail::setAppCharset(3x).
54

AUTHOR

56       Sam Varshavchik
57

NOTES

59        1. IMAP
60           http://www.rfc-editor.org/rfc/rfc3501.txt
61
62
63
64Cone©                             08/25/2016          MAIL::ACCOUNT::TRANS(3x)
Impressum