IM::Folder - mail/news folder handler

       IM (Internet Message) is copyrighted by IM developing team.  You can redistribute it and/or modify it
       under the modified BSD license.  See the copyright file for more details.

IM153                                              2016-10-10                                    IM::Folder(3pm)

       The IM::Folder module handles mail/news message folders.

       This modules is provided by IM (Internet Message).

        &cur_folder();
            results "+inbox"

        &set_cur_folder("+inbox");

        ($a, $b, $c, $d) = &folder_info("+inbox");
            results (10, 3, 1, 3)

        &message_number("+inbox", "cur");
            results 3

        &message_range("+inbox", "1-3");
            results (1, 2, 3)

        &message_name("+inbox", "3");
            results "/usr/home/itojun/Mail/inbox/3"

       IM::Folder - mail/news folder handler

        use IM::Folder;

        $current_folder_name = &cur_folder();

        &set_cur_folder($new_current_folder_name);

        ($number_of_files,
         $number_of_message_files,
         $minimum_message_number,
         $maximum_message_number) = &folder_info($folder_name);

        $message_number = &message_number($message_number_or_name);

        @message_number_array = &message_range($message_range_string);

        $message_file_path = &message_name($folder_name, $message_number);