]> git.saurik.com Git - apt.git/blobdiff - apt-pkg/contrib/error.h
provide public interface to hold/unhold packages
[apt.git] / apt-pkg / contrib / error.h
index 21c51c1be9d7388b208cb3ea7404f2a3108f65df..1fb0ede4af6dfa1775292f8609dbefefbdfbc1aa 100644 (file)
@@ -46,6 +46,7 @@
 #include <list>
 #include <string>
 
+#include <stddef.h>
 #include <stdarg.h>
 
 class GlobalError                                                      /*{{{*/
@@ -73,7 +74,7 @@ public:                                                                       /*{{{*/
         *
         *  \return \b false
         */
-       bool FatalE(const char *Function,const char *Description,...) __like_printf(3) __cold;
+       bool FatalE(const char *Function,const char *Description,...) APT_PRINTF(3) APT_COLD;
 
        /** \brief add an Error message with errno to the list
         *
@@ -82,7 +83,7 @@ public:                                                                       /*{{{*/
         *
         *  \return \b false
         */
-       bool Errno(const char *Function,const char *Description,...) __like_printf(3) __cold;
+       bool Errno(const char *Function,const char *Description,...) APT_PRINTF(3) APT_COLD;
 
        /** \brief add a warning message with errno to the list
         *
@@ -94,7 +95,7 @@ public:                                                                       /*{{{*/
         *
         *  \return \b false
         */
-       bool WarningE(const char *Function,const char *Description,...) __like_printf(3) __cold;
+       bool WarningE(const char *Function,const char *Description,...) APT_PRINTF(3) APT_COLD;
 
        /** \brief add a notice message with errno to the list
         *
@@ -103,7 +104,7 @@ public:                                                                     /*{{{*/
         *
         *  \return \b false
         */
-       bool NoticeE(const char *Function,const char *Description,...) __like_printf(3) __cold;
+       bool NoticeE(const char *Function,const char *Description,...) APT_PRINTF(3) APT_COLD;
 
        /** \brief add a debug message with errno to the list
         *
@@ -112,7 +113,7 @@ public:                                                                     /*{{{*/
         *
         *  \return \b false
         */
-       bool DebugE(const char *Function,const char *Description,...) __like_printf(3) __cold;
+       bool DebugE(const char *Function,const char *Description,...) APT_PRINTF(3) APT_COLD;
 
        /** \brief adds an errno message with the given type
         *
@@ -121,7 +122,26 @@ public:                                                                    /*{{{*/
         * \param Description of the error
         */
        bool InsertErrno(MsgType const &type, const char* Function,
-                        const char* Description,...) __like_printf(4) __cold;
+                        const char* Description,...) APT_PRINTF(4) APT_COLD;
+
+       /** \brief adds an errno message with the given type
+        *
+        * args needs to be initialized with va_start and terminated
+        * with va_end by the caller. msgSize is also an out-parameter
+        * in case the msgSize was not enough to store the complete message.
+        *
+        * \param type of the error message
+        * \param Function which failed
+        * \param Description is the format string for args
+        * \param args list from a printf-like function
+        * \param errsv is the errno the error is for
+        * \param msgSize is the size of the char[] used to store message
+        * \return true if the message was added, false if not - the caller
+        * should call this method again in that case
+        */
+       bool InsertErrno(MsgType type, const char* Function,
+                        const char* Description, va_list &args,
+                        int const errsv, size_t &msgSize) APT_COLD;
 
        /** \brief add an fatal error message to the list
         *
@@ -136,7 +156,7 @@ public:                                                                     /*{{{*/
         *
         *  \return \b false
         */
-       bool Fatal(const char *Description,...) __like_printf(2) __cold;
+       bool Fatal(const char *Description,...) APT_PRINTF(2) APT_COLD;
 
        /** \brief add an Error message to the list
         *
@@ -144,7 +164,7 @@ public:                                                                     /*{{{*/
         *
         *  \return \b false
         */
-       bool Error(const char *Description,...) __like_printf(2) __cold;
+       bool Error(const char *Description,...) APT_PRINTF(2) APT_COLD;
 
        /** \brief add a warning message to the list
         *
@@ -155,7 +175,7 @@ public:                                                                     /*{{{*/
         *
         *  \return \b false
         */
-       bool Warning(const char *Description,...) __like_printf(2) __cold;
+       bool Warning(const char *Description,...) APT_PRINTF(2) APT_COLD;
 
        /** \brief add a notice message to the list
         *
@@ -168,7 +188,7 @@ public:                                                                     /*{{{*/
         *
         *  \return \b false
         */
-       bool Notice(const char *Description,...) __like_printf(2) __cold;
+       bool Notice(const char *Description,...) APT_PRINTF(2) APT_COLD;
 
        /** \brief add a debug message to the list
         *
@@ -176,32 +196,48 @@ public:                                                                   /*{{{*/
         *
         *  \return \b false
         */
-       bool Debug(const char *Description,...) __like_printf(2) __cold;
+       bool Debug(const char *Description,...) APT_PRINTF(2) APT_COLD;
 
        /** \brief adds an error message with the given type
         *
         * \param type of the error message
         * \param Description of the error
         */
-       bool Insert(MsgType const &type, const char* Description,...) __like_printf(3) __cold;
+       bool Insert(MsgType const &type, const char* Description,...) APT_PRINTF(3) APT_COLD;
+
+       /** \brief adds an error message with the given type
+        *
+        * args needs to be initialized with va_start and terminated
+        * with va_end by the caller. msgSize is also an out-parameter
+        * in case the msgSize was not enough to store the complete message.
+        *
+        * \param type of the error message
+        * \param Description is the format string for args
+        * \param args list from a printf-like function
+        * \param msgSize is the size of the char[] used to store message
+        * \return true if the message was added, false if not - the caller
+        * should call this method again in that case
+        */
+       bool Insert(MsgType type, const char* Description,
+                        va_list &args, size_t &msgSize) APT_COLD;
 
        /** \brief is an error in the list?
         *
         *  \return \b true if an error is included in the list, \b false otherwise
         */
-       inline bool PendingError() const {return PendingFlag;};
+       inline bool PendingError() const APT_PURE {return PendingFlag;};
 
        /** \brief is the list empty?
         *
         *  The default checks if the list is empty or contains only notices,
-        *  if you want to check if also no notices happend set the parameter
+        *  if you want to check if also no notices happened set the parameter
         *  flag to \b false.
         *
-        *  \param WithoutNotice does notices count, default is \b true, so no
+        *  \param threshold minimim level considered
         *
         *  \return \b true if an the list is empty, \b false otherwise
         */
-       bool empty(MsgType const &trashhold = WARNING) const;
+       bool empty(MsgType const &threshold = WARNING) const APT_PURE;
 
        /** \brief returns and removes the first (or last) message in the list
         *
@@ -267,7 +303,7 @@ public:                                                                     /*{{{*/
        void MergeWithStack();
 
        /** \brief return the deep of the stack */
-       size_t StackCount() const {
+       size_t StackCount() const APT_PURE {
                return Stacks.size();
        }
 
@@ -297,7 +333,7 @@ private:                                                            /*{{{*/
        bool PendingFlag;
 
        struct MsgStack {
-               std::list<Item> const Messages;
+               std::list<Item> Messages;
                bool const PendingFlag;
 
                MsgStack(std::list<Item> const &Messages, bool const &Pending) :
@@ -305,12 +341,6 @@ private:                                                           /*{{{*/
        };
 
        std::list<MsgStack> Stacks;
-
-       bool InsertErrno(MsgType type, const char* Function,
-                        const char* Description, va_list &args,
-                        int const errsv, size_t &msgSize);
-       bool Insert(MsgType type, const char* Description,
-                        va_list &args, size_t &msgSize);
                                                                        /*}}}*/
 };
                                                                        /*}}}*/