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.