mail::ACCOUNT::translatePath — Convert readable folder path to internal folder path
#include <libmail/sync.H>
mail::ACCOUNT *mail;
std::string path=mail->translatePath( |
std::string folderPath); |
This function converts a human-readable representation of
a folder's path to the internal folder path in the mail
account. For example, IMAP server mailboxes use names encoded
in a modified version of the UTF-7 character set, and this method
converts a folder path from the application's character set
to the modified UTF-7 character
set. Specifically:
folderPath
is converted from application's character set to the
modified UTF-7 character
set.
folderPath
is converted from application's character set to
UTF-8. The forward slash
character, “/” separates names
of individual folders in the SMAP hierarchy. Unicode/ISO-10646
characters that cannot be represented in the
application's character set may be specified as
“%n;”, where
n is a
decimal Unicode value. Use “\/” to specify a
forward slash character in the folder name,
“\\” to specify a
backslash character, and “\%” to specify the
“%” character.
folderPath
is converted from application's character set to
modified UTF-7 encoding.
The forward slash character, “/” separates names
of individual folders in the local mail folder
hierarchy. Unicode/ISO-10646 characters that cannot be
represented in the application's character set may be
specified as “%n;”, where
n is a
decimal Unicode value. Use “\\” to specify a
backslash character, and “\%” to specify the
“%” character.