Rechercher une page de manuel
mail::ACCOUNT::translatePath.3x
Langue: en
Version: 11/28/2008 (fedora - 01/12/10)
Section: 3 (Bibliothèques de fonctions)
NAME
mail::ACCOUNT::translatePath - Convert readable folder path to internal folder pathSYNOPSIS
-
#include <libmail/sync.H> mail::ACCOUNT *mail;
- std::string path=mail->translatePath(std::string folderPath);
USAGE
- 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:
IMAP[1]
folderPath is converted from application's character set to the modified UTF-7 character set.
SMAP
folderPath is converted from application's character set to UTF-8. The forward slash character, lq/rq 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 lq%n;rq, where n is a decimal Unicode value. Use lq\/rq to specify a forward slash character in the folder name, lq\\rq to specify a backslash character, and lq\%rq to specify the lq%rq character.
mbox mail folders, and maildirs
folderPath is converted from application's character set to modified UTF-7 encoding. The forward slash character, lq/rq 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 lq%n;rq, where n is a decimal Unicode value. Use lq\\rq to specify a backslash character, and lq\%rq to specify the lq%rq character.
RETURN CODES AND CALLBACKS
This function returns the converted path string. An empty string is returned if folderPath is not a valid folder path.
SEE ALSO
mail::ACCOUNT::getFolderFromPath(3x), mail::ACCOUNT::getFolderFromString(3x), mail::setAppCharset(3x).
NOTES
- 1.
- IMAP
- http://www.rfc-editor.org/rfc/rfc3501.txt
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre