Class curl_multi

include/curl_multi.h:166–333

* As libcurl documentation says, the multi interface offers several abilities that * the easy interface doesn't. They are mainly: * 1. Enable a "pull" interface. The application that uses libcurl decides where and * when to ask libcurl to get/send data. * 2. Enable multiple simultaneous transfers in the same thread without making it * complicated for the application.

     *    file descriptors simultaneous easily.
    */
    class curl_multi : public curl_interface<CURLMcode> {
    public:
        /**
         * The multi interface gives users the opportunity to get information about
         * transfers. This information is wrapped in the following class. In this
         * way users can access this information in an easy and efficient way.
         * This class is nested because these messages are only sent when using the
         * multi interface.
         */
        class curl_message {
        public:
            /**
             * The attributes will be initialized with constructors parameters. With
             * this constructor we provide a fast way to build this kind of object.
             */
            explicit curl_message(const CURLMsg *, const curl_easy *);
            /**
             * Inline getter method used to return
             * the message for a single handler.
             */
            CURLMSG get_message() const;
            /**
             * Inline getter method used to return
             * the code for a single handler.
             */
            CURLcode get_code() const;
            /**
             * Inline getter method used to return
             * other data.
             */
            const void *get_other() const;
            /**
             * Returns the handler to the easy interface.
             */
            const curl_easy *get_handler() const;
        private:
            const CURLMSG message;
            const void *whatever;
            const CURLcode code;
            const curl_easy *handler;
        };

        /**
         * Simple default constructor. It is used to give a
         * default value to all the attributes and provide a
         * fast way to create an object of this type. It also
         * initializes the curl environment with the default
         * values.
         */
        curl_multi();
        /**
         * Overloaded constructor. Gives users the opportunity
         * to initialize the entire curl environment using custom
         * options.
         */
        explicit curl_multi(long globalOptions);
        /**
         * Move constructor which moves internal data to another object.