diff --git a/libs/fftw/pifft_p.h b/libs/fftw/pifft_p.h index 2a2d1546..04c61169 100644 --- a/libs/fftw/pifft_p.h +++ b/libs/fftw/pifft_p.h @@ -1,5 +1,5 @@ -/*! @file pifft_p.h - * @brief Class for FFT, IFFT and Hilbert transformations +/*! \file pifft_p.h + * \brief Class for FFT, IFFT and Hilbert transformations */ /* PIP - Platform Independent Primitives diff --git a/libs/io_utils/pibroadcast.cpp b/libs/io_utils/pibroadcast.cpp index a59b1314..49a32f2e 100644 --- a/libs/io_utils/pibroadcast.cpp +++ b/libs/io_utils/pibroadcast.cpp @@ -20,7 +20,7 @@ #include "pibroadcast.h" /** \class PIBroadcast - * @brief Broadcast for all interfaces, including loopback + * \brief Broadcast for all interfaces, including loopback * * \section PIBroadcast_synopsis Synopsis * %PIBroadcast used as multichannel IO device. It can use diff --git a/libs/io_utils/piethutilbase.cpp b/libs/io_utils/piethutilbase.cpp index 46a2faa5..38301e2c 100644 --- a/libs/io_utils/piethutilbase.cpp +++ b/libs/io_utils/piethutilbase.cpp @@ -23,7 +23,7 @@ #endif /** \class PIEthUtilBase - * @brief Base class for ethernet utils + * \brief Base class for ethernet utils * * \section PIEthUtilBase_synopsis Synopsis * %PIEthUtilBase provides crypt layer for derived classes: diff --git a/libs/io_utils/pistreampacker.cpp b/libs/io_utils/pistreampacker.cpp index be4649dd..5f95a953 100644 --- a/libs/io_utils/pistreampacker.cpp +++ b/libs/io_utils/pistreampacker.cpp @@ -28,7 +28,7 @@ #endif /** \class PIStreamPacker - * @brief Simple packet wrap aroud any PIIODevice + * \brief Simple packet wrap aroud any PIIODevice * * \section PIStreamPacker_synopsis Synopsis * %PIStreamPacker provides simple pack/unpack logic for any data packets. diff --git a/libs/main/cloud/picloudbase.h b/libs/main/cloud/picloudbase.h index 674b0d7f..170a3d89 100644 --- a/libs/main/cloud/picloudbase.h +++ b/libs/main/cloud/picloudbase.h @@ -1,5 +1,5 @@ -/*! @file picloudbase.h - * @brief PICloud Base - Base class for PICloudClient and PICloud Server +/*! \file picloudbase.h + * \brief PICloud Base - Base class for PICloudClient and PICloud Server */ /* PIP - Platform Independent Primitives diff --git a/libs/main/cloud/picloudclient.h b/libs/main/cloud/picloudclient.h index cc944b2b..1fc4e4bb 100644 --- a/libs/main/cloud/picloudclient.h +++ b/libs/main/cloud/picloudclient.h @@ -1,5 +1,5 @@ -/*! @file picloudclient.h - * @brief PICloud Client +/*! \file picloudclient.h + * \brief PICloud Client */ /* PIP - Platform Independent Primitives @@ -27,7 +27,7 @@ #include "piconditionvar.h" -//! @brief PICloudClient +//! \brief PICloudClient class PIP_CLOUD_EXPORT PICloudClient: public PIIODevice, public PICloudBase { diff --git a/libs/main/cloud/picloudserver.h b/libs/main/cloud/picloudserver.h index 899ad326..4b614966 100644 --- a/libs/main/cloud/picloudserver.h +++ b/libs/main/cloud/picloudserver.h @@ -1,5 +1,5 @@ -/*! @file picloudserver.h - * @brief PICloud Server +/*! \file picloudserver.h + * \brief PICloud Server */ /* PIP - Platform Independent Primitives diff --git a/libs/main/cloud/picloudtcp.h b/libs/main/cloud/picloudtcp.h index cf9af60b..31ac9408 100644 --- a/libs/main/cloud/picloudtcp.h +++ b/libs/main/cloud/picloudtcp.h @@ -1,5 +1,5 @@ -/*! @file picloudtcp.h - * @brief PICloud TCP transport +/*! \file picloudtcp.h + * \brief PICloud TCP transport */ /* PIP - Platform Independent Primitives diff --git a/libs/main/code/picodeinfo.h b/libs/main/code/picodeinfo.h index 3a577305..75cd0309 100644 --- a/libs/main/code/picodeinfo.h +++ b/libs/main/code/picodeinfo.h @@ -1,5 +1,5 @@ -/*! @file picodeinfo.h - * @brief C++ code info structs +/*! \file picodeinfo.h + * \brief C++ code info structs */ /* PIP - Platform Independent Primitives diff --git a/libs/main/code/picodeparser.h b/libs/main/code/picodeparser.h index 34baadcb..716dda9a 100644 --- a/libs/main/code/picodeparser.h +++ b/libs/main/code/picodeparser.h @@ -1,5 +1,5 @@ -/*! @file picodeparser.h - * @brief C++ code parser +/*! \file picodeparser.h + * \brief C++ code parser */ /* PIP - Platform Independent Primitives diff --git a/libs/main/compress/picompress.h b/libs/main/compress/picompress.h index e159fc4c..e0ada4d0 100644 --- a/libs/main/compress/picompress.h +++ b/libs/main/compress/picompress.h @@ -1,5 +1,5 @@ -/*! @file picompress.h - * @brief Compress class using zlib +/*! \file picompress.h + * \brief Compress class using zlib */ /* PIP - Platform Independent Primitives diff --git a/libs/main/console/pikbdlistener.cpp b/libs/main/console/pikbdlistener.cpp index 6d7d6d3a..8de218d2 100644 --- a/libs/main/console/pikbdlistener.cpp +++ b/libs/main/console/pikbdlistener.cpp @@ -26,7 +26,7 @@ #endif /** \class PIKbdListener - * @brief Keyboard console input listener + * \brief Keyboard console input listener * \details This class provide listening of console keyboard input. * There is two ways to receive pressed key: * * external static function with format "void func(char key, void * data_)" diff --git a/libs/main/console/pikbdlistener.h b/libs/main/console/pikbdlistener.h index b257ed67..4bc1c4d0 100644 --- a/libs/main/console/pikbdlistener.h +++ b/libs/main/console/pikbdlistener.h @@ -1,5 +1,5 @@ -/*! @file pikbdlistener.h - * @brief Keyboard console input listener +/*! \file pikbdlistener.h + * \brief Keyboard console input listener */ /* PIP - Platform Independent Primitives @@ -181,20 +181,20 @@ public: //! \{ //! \fn void enableExitCapture(int key = 'Q') - //! @brief Enable exit key "key" awaiting + //! \brief Enable exit key "key" awaiting //! \fn void disableExitCapture() - //! @brief Disable exit key awaiting + //! \brief Disable exit key awaiting //! \fn void setActive(bool yes = true) - //! @brief Set keyboard listening is active or not + //! \brief Set keyboard listening is active or not //! \} //! \events //! \{ //! \fn void keyPressed(PIKbdListener::KeyEvent key, void * data) - //! @brief Raise on key "key" pressed, "data" is custom data + //! \brief Raise on key "key" pressed, "data" is custom data //! \} diff --git a/libs/main/console/piscreen.h b/libs/main/console/piscreen.h index e1e88112..34439e1b 100644 --- a/libs/main/console/piscreen.h +++ b/libs/main/console/piscreen.h @@ -1,5 +1,5 @@ -/*! @file piscreen.h - * @brief Console GUI class +/*! \file piscreen.h + * \brief Console GUI class */ /* PIP - Platform Independent Primitives @@ -80,23 +80,23 @@ public: //! \{ //! \fn void waitForFinish() - //! @brief block until finished (exit key will be pressed) + //! \brief block until finished (exit key will be pressed) //! \fn void start(bool wait = false) - //! @brief Start console output and if "wait" block until finished (exit key will be pressed) + //! \brief Start console output and if "wait" block until finished (exit key will be pressed) //! \fn void stop(bool clear = false) - //! @brief Stop console output and if "clear" clear the screen + //! \brief Stop console output and if "clear" clear the screen //! \} //! \events //! \{ //! \fn void keyPressed(PIKbdListener::KeyEvent key, void * data) - //! @brief Raise on key "key" pressed, "data" is pointer to %PIConsole object + //! \brief Raise on key "key" pressed, "data" is pointer to %PIConsole object //! \fn void tileEvent(PIScreenTile * tile, PIScreenTypes::TileEvent e) - //! @brief Raise on some event "e" from tile "tile" + //! \brief Raise on some event "e" from tile "tile" //! \} diff --git a/libs/main/console/piscreenconsole.h b/libs/main/console/piscreenconsole.h index b1d45725..cd45ba73 100644 --- a/libs/main/console/piscreenconsole.h +++ b/libs/main/console/piscreenconsole.h @@ -1,5 +1,5 @@ -/*! @file piscreenconsole.h - * @brief Tile for PIScreen with PIConsole API +/*! \file piscreenconsole.h + * \brief Tile for PIScreen with PIConsole API * * This file declares TileVars */ diff --git a/libs/main/console/piscreendrawer.h b/libs/main/console/piscreendrawer.h index 85791dba..6a118adb 100644 --- a/libs/main/console/piscreendrawer.h +++ b/libs/main/console/piscreendrawer.h @@ -1,5 +1,5 @@ -/*! @file piscreendrawer.h - * @brief Drawer for PIScreen +/*! \file piscreendrawer.h + * \brief Drawer for PIScreen */ /* PIP - Platform Independent Primitives diff --git a/libs/main/console/piscreentile.h b/libs/main/console/piscreentile.h index e09ca863..28e7dcd7 100644 --- a/libs/main/console/piscreentile.h +++ b/libs/main/console/piscreentile.h @@ -1,5 +1,5 @@ -/*! @file piscreentile.h - * @brief Basic PIScreen tile +/*! \file piscreentile.h + * \brief Basic PIScreen tile */ /* PIP - Platform Independent Primitives diff --git a/libs/main/console/piscreentiles.h b/libs/main/console/piscreentiles.h index 2b31fa09..34815d9f 100644 --- a/libs/main/console/piscreentiles.h +++ b/libs/main/console/piscreentiles.h @@ -1,5 +1,5 @@ -/*! @file piscreentiles.h - * @brief Various tiles for PIScreen +/*! \file piscreentiles.h + * \brief Various tiles for PIScreen */ /* PIP - Platform Independent Primitives diff --git a/libs/main/console/piscreentypes.h b/libs/main/console/piscreentypes.h index 22665333..0409cd0d 100644 --- a/libs/main/console/piscreentypes.h +++ b/libs/main/console/piscreentypes.h @@ -1,5 +1,5 @@ -/*! @file piscreentypes.h - * @brief Types for PIScreen +/*! \file piscreentypes.h + * \brief Types for PIScreen */ /* PIP - Platform Independent Primitives diff --git a/libs/main/console/piterminal.h b/libs/main/console/piterminal.h index 7e1615d2..b519d6bd 100644 --- a/libs/main/console/piterminal.h +++ b/libs/main/console/piterminal.h @@ -1,5 +1,5 @@ -/*! @file piterminal.h - * @brief Virtual terminal +/*! \file piterminal.h + * \brief Virtual terminal */ /* PIP - Platform Independent Primitives diff --git a/libs/main/containers/picontainers.h b/libs/main/containers/picontainers.h index 3aaeec08..71455a12 100644 --- a/libs/main/containers/picontainers.h +++ b/libs/main/containers/picontainers.h @@ -47,7 +47,7 @@ #if 0 -/*!@brief Macro for iterate any container +/*!\brief Macro for iterate any container * \details Use this macros instead of standard "for" * to get read/write access to each element of container. * Pass direction is direct \n @@ -55,7 +55,7 @@ */ # define piForeach(i,c) -/*!@brief Macro for iterate any container only for read +/*!\brief Macro for iterate any container only for read * \details Use this macros instead of standard "for" * to get read access to each element of container. * Pass direction is direct \n @@ -63,7 +63,7 @@ */ # define piForeachC(i,c) -/*!@brief Macro for iterate any container with reverse direction +/*!\brief Macro for iterate any container with reverse direction * \details Use this macros instead of standard "for" * to get read/write access to each element of container. * Pass direction is reverse \n @@ -71,7 +71,7 @@ */ # define piForeachR(i,c) -/*!@brief Macro for iterate any container only for read with reverse direction +/*!\brief Macro for iterate any container only for read with reverse direction * \details Use this macros instead of standard "for" * to get read access to each element of container. * Pass direction is reverse \n diff --git a/libs/main/containers/pideque.h b/libs/main/containers/pideque.h index 169e8614..53e86851 100644 --- a/libs/main/containers/pideque.h +++ b/libs/main/containers/pideque.h @@ -1,5 +1,5 @@ -/*! @file pideque.h - * @brief Dynamic array of any type +/*! \file pideque.h + * \brief Dynamic array of any type * * This file declares PIDeque */ diff --git a/libs/main/containers/pimap.cpp b/libs/main/containers/pimap.cpp index 51172471..3c0b0034 100644 --- a/libs/main/containers/pimap.cpp +++ b/libs/main/containers/pimap.cpp @@ -1,5 +1,5 @@ /** \class PIMap - * @brief Associative array + * \brief Associative array * \details This class used to store Key = Value array of any * type of data. \a value() returns value for key and leave map * unchaged in any case. \a operator [] create entry in map if @@ -9,97 +9,97 @@ * \a makeIterator() and \a makeReverseIterator(). * \fn PIMap::PIMap(); - * @brief Contructs an empty map + * \brief Contructs an empty map * \fn PIMap::PIMap(const PIMap & other); - * @brief Contructs a copy of "other" + * \brief Contructs a copy of "other" * \fn PIMap & PIMap::operator =(const PIMap & other); - * @brief Copy operator + * \brief Copy operator * \fn PIMap::PIMap(const PIMap & other); - * @brief Contructs a copy of "other" + * \brief Contructs a copy of "other" * \fn PIMapIterator PIMap::makeIterator() const -* @brief Returns PIMapIterator for this map +* \brief Returns PIMapIterator for this map * \fn PIMapIterator PIMap::makeReverseIterator() const -* @brief Returns reverse PIMapIterator for this map +* \brief Returns reverse PIMapIterator for this map * \fn size_t PIMap::size() const -* @brief Returns entries count +* \brief Returns entries count * \fn int PIMap::size_s() const -* @brief Returns entries count +* \brief Returns entries count * \fn size_t PIMap::length() const -* @brief Returns entries count +* \brief Returns entries count * \fn bool PIMap::isEmpty() const -* @brief Returns if map is empty +* \brief Returns if map is empty * \fn T & PIMap::operator [](const Key & key) -* @brief Returns value for key "key". If there is no key in map, create one. +* \brief Returns value for key "key". If there is no key in map, create one. * \fn const T PIMap::operator [](const Key & key) const -* @brief Returns value for key "key". If there is no key in map, returns default T(). +* \brief Returns value for key "key". If there is no key in map, returns default T(). * \fn T & PIMap::at(const Key & key) -* @brief Equivalent to operator [] +* \brief Equivalent to operator [] * \fn const T PIMap::at(const Key & key) const -* @brief Equivalent to operator [] +* \brief Equivalent to operator [] * \fn PIMap & PIMap::operator <<(const PIMap & other) -* @brief Insert all etries of "other" to this map. Override existing values. +* \brief Insert all etries of "other" to this map. Override existing values. * \fn bool PIMap::operator ==(const PIMap & t) const -* @brief Compare operator +* \brief Compare operator * \fn bool PIMap::operator !=(const PIMap & t) const -* @brief Compare operator +* \brief Compare operator * \fn bool PIMap::contains(const Key & key) const -* @brief Returns "true" if map contains entry with key "key" +* \brief Returns "true" if map contains entry with key "key" * \fn PIMap & PIMap::reserve(size_t new_size) -* @brief Reserve space for "new_size" entries +* \brief Reserve space for "new_size" entries * \fn PIMap & PIMap::removeOne(const Key & key) -* @brief Remove entry with key "key" +* \brief Remove entry with key "key" * \fn PIMap & PIMap::remove(const Key & key) -* @brief Equivalent \a removeOne(key) +* \brief Equivalent \a removeOne(key) * \fn PIMap & PIMap::erase(const Key & key) -* @brief Equivalent \a removeOne(key) +* \brief Equivalent \a removeOne(key) * \fn PIMap & PIMap::clear() -* @brief Clear map +* \brief Clear map * \fn void PIMap::swap(PIMap & other) -* @brief Swap map with "other" +* \brief Swap map with "other" * \fn PIMap & PIMap::insert(const Key & key, const T & value) -* @brief Insert or rewrite entry with key "key" and value "value" +* \brief Insert or rewrite entry with key "key" and value "value" * \fn const T PIMap::value(const Key & key, const T & default = T()) -* @brief Returns value for key "key". If there is no key in map, returns "default". +* \brief Returns value for key "key". If there is no key in map, returns "default". * \fn PIVector PIMap::values() const -* @brief Returns all values as PIVector +* \brief Returns all values as PIVector * \fn Key PIMap::key(const T & value, const Key & default = Key()) const -* @brief Returns key for first founded value "value". If there is no such value in map, returns "default". +* \brief Returns key for first founded value "value". If there is no such value in map, returns "default". * \fn PIVector PIMap::keys() const -* @brief Returns all keys as PIVector +* \brief Returns all keys as PIVector * */ @@ -107,7 +107,7 @@ /** \class PIMapIterator - * @brief Helper class to iterate over PIMap + * \brief Helper class to iterate over PIMap * \details This class used to access keys and values in PIMap. * You can use constructor to create iterator, or use \a PIMap::makeIterator() * and \a PIMap::makeReverseIterator() methods. @@ -164,24 +164,24 @@ * \endcode * \fn PIMapIterator(const PIMap & map, bool reverse = false) -* @brief Contructs iterator for "map". Current position is invalid. +* \brief Contructs iterator for "map". Current position is invalid. * \fn const Key & PIMapIterator::key() const -* @brief Returns current entry key +* \brief Returns current entry key * \fn const T & PIMapIterator::value() const -* @brief Returns current entry value +* \brief Returns current entry value * \fn T & PIMapIterator::valueRef() const -* @brief Returns reference to current entry value +* \brief Returns reference to current entry value * \fn bool PIMapIterator::hasNext() -* @brief Returns if iterator can jump to next entry +* \brief Returns if iterator can jump to next entry * \fn bool PIMapIterator::next() -* @brief Jump to next entry and return if new position is valid. +* \brief Jump to next entry and return if new position is valid. * \fn void PIMapIterator::reset() -* @brief Reset iterator to initial position. +* \brief Reset iterator to initial position. * */ diff --git a/libs/main/containers/pimap.h b/libs/main/containers/pimap.h index beb45106..0ceed77b 100644 --- a/libs/main/containers/pimap.h +++ b/libs/main/containers/pimap.h @@ -1,5 +1,5 @@ -/*! @file pimap.h - * @brief Associative array with custom types of key and value +/*! \file pimap.h + * \brief Associative array with custom types of key and value * * This file declares PIMap */ diff --git a/libs/main/containers/pipair.h b/libs/main/containers/pipair.h index e032960c..575838ef 100644 --- a/libs/main/containers/pipair.h +++ b/libs/main/containers/pipair.h @@ -1,5 +1,5 @@ -/*! @file pipair.h - * @brief pair +/*! \file pipair.h + * \brief pair * * This file declare PIPair */ diff --git a/libs/main/containers/piqueue.h b/libs/main/containers/piqueue.h index c7d41b57..5c56b1b0 100644 --- a/libs/main/containers/piqueue.h +++ b/libs/main/containers/piqueue.h @@ -1,5 +1,5 @@ -/*! @file pideque.h - * @brief Queue container +/*! \file pideque.h + * \brief Queue container * * This file declare PIQueue */ diff --git a/libs/main/containers/piset.h b/libs/main/containers/piset.h index 52721068..50603403 100644 --- a/libs/main/containers/piset.h +++ b/libs/main/containers/piset.h @@ -1,5 +1,5 @@ -/*! @file piset.h - * @brief Set container +/*! \file piset.h + * \brief Set container * * This file declare PISet */ @@ -27,7 +27,7 @@ #include "pimap.h" -/*! @brief Set of any type +/*! \brief Set of any type * \details This class used to store collection of unique elements * of any type. You can only add values to set with \a operator<< or * with function \a insert(). You can discover if value already in @@ -129,16 +129,16 @@ public: }; -//! \relatesalso PISet @brief Returns unite of two sets +//! \relatesalso PISet \brief Returns unite of two sets template PISet operator +(const PISet & v0, const PISet & v1) {PISet ret(v0); ret.unite(v1); return ret;} -//! \relatesalso PISet @brief Returns subtraction of two sets +//! \relatesalso PISet \brief Returns subtraction of two sets template PISet operator -(const PISet & v0, const PISet & v1) {PISet ret(v0); ret.subtract(v1); return ret;} -//! \relatesalso PISet @brief Returns unite of two sets +//! \relatesalso PISet \brief Returns unite of two sets template PISet operator |(const PISet & v0, const PISet & v1) {PISet ret(v0); ret.unite(v1); return ret;} -//! \relatesalso PISet @brief Returns intersetion of two sets +//! \relatesalso PISet \brief Returns intersetion of two sets template PISet operator &(const PISet & v0, const PISet & v1) {PISet ret(v0); ret.intersect(v1); return ret;} diff --git a/libs/main/containers/pistack.h b/libs/main/containers/pistack.h index 0341de29..5b65fa90 100644 --- a/libs/main/containers/pistack.h +++ b/libs/main/containers/pistack.h @@ -1,5 +1,5 @@ -/*! @file pistack.h - * @brief Stack container +/*! \file pistack.h + * \brief Stack container * * This file declare PIStack */ diff --git a/libs/main/containers/pivector.cpp b/libs/main/containers/pivector.cpp index ca6fe887..3c7a96fd 100644 --- a/libs/main/containers/pivector.cpp +++ b/libs/main/containers/pivector.cpp @@ -1,5 +1,5 @@ /** \class PIVector - * @brief Dynamic array of any type + * \brief Dynamic array of any type * \details This class used to store dynamic array of any * type of data. In memory data stored linear. You can insert * item in any place of remove some items from any place. @@ -9,162 +9,162 @@ * Contructs an empty vector * \fn PIVector::PIVector(size_t size, const T & value = T()); - * @brief Contructs vector with size "size" filled elements "value" + * \brief Contructs vector with size "size" filled elements "value" * \details Example: \snippet picontainers.cpp PIVector::PIVector * \fn PIVector::PIVector(std::initializer_list list); - * @brief Contructs vector from C++11 initializer list + * \brief Contructs vector from C++11 initializer list * \details Example: \snippet picontainers.cpp PIVector::PIVector * \fn const T & PIVector::at(size_t index) const; - * @brief Read-only access to element by index "index" + * \brief Read-only access to element by index "index" * \details Example: \snippet picontainers.cpp PIVector::at_c * \sa \a operator[] * \fn T & PIVector::at(size_t index); - * @brief Full access to element by index "index" + * \brief Full access to element by index "index" * \details Example: \snippet picontainers.cpp PIVector::at * \sa \a operator[] * \fn const T * PIVector::data(size_t index = 0) const; - * @brief Read-only pointer to element by index "index" + * \brief Read-only pointer to element by index "index" * \details Example: \snippet picontainers.cpp PIVector::data_c * \fn T * PIVector::data(size_t index = 0); - * @brief Pointer to element by index "index" + * \brief Pointer to element by index "index" * \details Example: \snippet picontainers.cpp PIVector::data * \fn size_t PIVector::size() const; - * @brief Elements count + * \brief Elements count * \fn ssize_t PIVector::size_s() const; - * @brief Elements count + * \brief Elements count * \fn bool PIVector::isEmpty() const; - * @brief Return \c "true" if vector is empty, i.e. size = 0 + * \brief Return \c "true" if vector is empty, i.e. size = 0 * \fn bool PIVector::has(const T & t) const; * \fn bool PIVector::contains(const T & v) const; - * @brief Return \c "true" if vector has at least one element equal "t" + * \brief Return \c "true" if vector has at least one element equal "t" * \fn int PIVector::etries(const T & t) const; - * @brief Return how many times element "t" appears in vector + * \brief Return how many times element "t" appears in vector * \fn ssize_t PIVector::indexOf(const T & t) const; - * @brief Return index of first element equal "t" or -1 if there is no such element + * \brief Return index of first element equal "t" or -1 if there is no such element * \fn ssize_t PIVector::lastIndexOf(const T & t) const; - * @brief Return index of last element equal "t" or -1 if there is no such element + * \brief Return index of last element equal "t" or -1 if there is no such element * \fn static int PIVector::compare_func(const T * t0, const T * t1); - * @brief Standard compare function for type "T". Return 0 if t0 = t1, -1 if t0 < t1 and 1 if t0 > t1. + * \brief Standard compare function for type "T". Return 0 if t0 = t1, -1 if t0 < t1 and 1 if t0 > t1. * \fn void PIVector::resize(size_t size, const T & new_type = T()); - * @brief Resize vector to size "size" + * \brief Resize vector to size "size" * \details Elements removed from end of vector if new size < old size, or added new elements = "new_type" if new size > old size.\n * Example: \snippet picontainers.cpp PIVector::resize * \sa \a size(), \a clear() * \fn PIVector & PIVector::enlarge(size_t size); - * @brief Increase vector size with "size" elements + * \brief Increase vector size with "size" elements * \fn void PIVector::clear(); - * @brief Clear vector. Equivalent to call "resize(0)" + * \brief Clear vector. Equivalent to call "resize(0)" * \fn PIVector & PIVector::sort(CompareFunc compare = compare_func); - * @brief Sort vector using quick sort algorithm and standard compare function + * \brief Sort vector using quick sort algorithm and standard compare function * \details Example: \snippet picontainers.cpp PIVector::sort_0 * With custom compare function: \snippet picontainers.cpp PIVector::sort_1 * \fn PIVector & PIVector::fill(const T & t); - * @brief Fill vector with elements "t" leave size is unchanged and return reference to vector + * \brief Fill vector with elements "t" leave size is unchanged and return reference to vector * \details Example: \snippet picontainers.cpp PIVector::fill * \fn PIVector & PIVector::assign(const T & t = T()); - * @brief Synonym of \a fill(t) + * \brief Synonym of \a fill(t) * \fn PIVector & PIVector::assign(size_t new_size, const T & t); - * @brief Resize to "new_size", then fill with "t" + * \brief Resize to "new_size", then fill with "t" * \fn T & PIVector::back(); - * @brief Last element of the vector + * \brief Last element of the vector * \fn const T & PIVector::back() const; - * @brief Last element of the vector + * \brief Last element of the vector * \fn T & PIVector::front(); - * @brief First element of the vector + * \brief First element of the vector * \fn const T & PIVector::front() const; - * @brief First element of the vector + * \brief First element of the vector * \fn PIVector & PIVector::push_back(const T & t); - * @brief Add new element "t" at the end of vector and return reference to vector + * \brief Add new element "t" at the end of vector and return reference to vector * \fn PIVector & PIVector::push_front(const T & t); - * @brief Add new element "t" at the beginning of vector and return reference to vector + * \brief Add new element "t" at the beginning of vector and return reference to vector * \fn PIVector & PIVector::pop_back(); - * @brief Remove one element from the end of vector and return reference to vector + * \brief Remove one element from the end of vector and return reference to vector * \fn PIVector & PIVector::pop_front(); - * @brief Remove one element from the beginning of vector and return reference to vector + * \brief Remove one element from the beginning of vector and return reference to vector * \fn T PIVector::take_back(); - * @brief Remove one element from the end of vector and return it + * \brief Remove one element from the end of vector and return it * \fn T PIVector::take_front(); - * @brief Remove one element from the beginning of vector and return it + * \brief Remove one element from the beginning of vector and return it * \fn PIVector & PIVector::remove(size_t index); - * @brief Remove one element by index "index" and return reference to vector + * \brief Remove one element by index "index" and return reference to vector * \details Example: \snippet picontainers.cpp PIVector::remove_0 * \sa \a removeOne(), \a removeAll() * \fn PIVector & PIVector::remove(size_t index, size_t count); - * @brief Remove "count" elements by first index "index" and return reference to vector + * \brief Remove "count" elements by first index "index" and return reference to vector * \details Example: \snippet picontainers.cpp PIVector::remove_1 * \sa \a removeOne(), \a removeAll() * \fn PIVector & PIVector::removeOne(const T & v); - * @brief Remove no more than one element equal "v" and return reference to vector + * \brief Remove no more than one element equal "v" and return reference to vector * \details Example: \snippet picontainers.cpp PIVector::removeOne * \sa \a remove(), \a removeAll() * \fn PIVector & PIVector::removeAll(const T & v); - * @brief Remove all elements equal "v" and return reference to vector + * \brief Remove all elements equal "v" and return reference to vector * \details Example: \snippet picontainers.cpp PIVector::removeAll * \sa \a remove(), \a removeOne() * \fn PIVector & PIVector::insert(size_t pos, const T & t); - * @brief Insert element "t" after index "pos" and return reference to vector + * \brief Insert element "t" after index "pos" and return reference to vector * \details Example: \snippet picontainers.cpp PIVector::insert_0 * \fn PIVector & PIVector::insert(size_t pos, const PIVector & t); - * @brief Insert other vector "t" after index "pos" and return reference to vector + * \brief Insert other vector "t" after index "pos" and return reference to vector * \details Example: \snippet picontainers.cpp PIVector::insert_1 * \fn T & PIVector::operator [](size_t index); - * @brief Full access to element by index "index" + * \brief Full access to element by index "index" * \details Example: \snippet picontainers.cpp PIVector::() * \sa \a at() * \fn const T & PIVector::operator [](size_t index) const; - * @brief Read-only access to element by index "index" + * \brief Read-only access to element by index "index" * \details Example: \snippet picontainers.cpp PIVector::()_c * \sa \a at() * \fn PIVector & PIVector::operator <<(const T & t); - * @brief Add new element "t" at the end of vector and return reference to vector + * \brief Add new element "t" at the end of vector and return reference to vector * \fn PIVector & PIVector::operator <<(const PIVector & t); - * @brief Add vector "t" at the end of vector and return reference to vector + * \brief Add vector "t" at the end of vector and return reference to vector * \fn bool PIVector::operator ==(const PIVector & t); - * @brief Compare with vector "t" + * \brief Compare with vector "t" * \fn bool PIVector::operator !=(const PIVector & t); - * @brief Compare with vector "t" + * \brief Compare with vector "t" * */ diff --git a/libs/main/containers/pivector.h b/libs/main/containers/pivector.h index 6d9a664a..52ca2e49 100644 --- a/libs/main/containers/pivector.h +++ b/libs/main/containers/pivector.h @@ -1,5 +1,5 @@ -/*! @file pivector.h - * @brief Dynamic array of any type +/*! \file pivector.h + * \brief Dynamic array of any type * * This file declares PIVector */ diff --git a/libs/main/containers/pivector2d.h b/libs/main/containers/pivector2d.h index 004cdb5e..9f8a7957 100644 --- a/libs/main/containers/pivector2d.h +++ b/libs/main/containers/pivector2d.h @@ -1,5 +1,5 @@ -/*! @file pivector2d.h - * @brief 2D wrapper around PIVector +/*! \file pivector2d.h + * \brief 2D wrapper around PIVector * * This file declares PIVector */ @@ -27,7 +27,7 @@ #include "pivector.h" -/*! @brief 2D array, +/*! \brief 2D array, * \details This class used to store 2D array of any type elements as plain vector. * You can read/write any element via operators [][], first dimension - row, second - column. * The first dimension is Row, and you can operate with Row as PIVector: modify any element, assign to another Row and etc. diff --git a/libs/main/core/pibase.h b/libs/main/core/pibase.h index 5167f049..90085709 100644 --- a/libs/main/core/pibase.h +++ b/libs/main/core/pibase.h @@ -1,9 +1,9 @@ /*! \file pibase.h - * \brief + * \~\brief * \~english Base types and functions * \~russian Базовые типы и методы * - * \details + * \~\details * \~english * This file implements first layer above the system and * declares some basic useful functions @@ -52,142 +52,142 @@ #ifdef DOXYGEN -//! \brief +//! \~\brief //! \~english Major value of PIP version //! \~russian Мажорная версия PIP # define PIP_VERSION_MAJOR -//! \brief +//! \~\brief //! \~english Minor value of PIP version //! \~russian Минорная версия PIP # define PIP_VERSION_MINOR -//! \brief +//! \~\brief //! \~english Revision value of PIP version //! \~russian Ревизия версии PIP # define PIP_VERSION_REVISION -//! \brief +//! \~\brief //! \~english Suffix of PIP version //! \~russian Суффикс версии PIP # define PIP_VERSION_SUFFIX -//! \brief +//! \~\brief //! \~english Version of PIP in hex - 0x##(Major)##(Minor)##(Revision) //! \~russian Версия PIP в hex - 0x##(Major)##(Minor)##(Revision) # define PIP_VERSION -//! \brief +//! \~\brief //! \~english Macro is defined when compile-time debug is enabled //! \~russian Макрос объявлен когда включена compile-time отладка # define PIP_DEBUG -//! \brief +//! \~\brief //! \~english Macro is defined when operation system is any Windows //! \~russian Макрос объявлен когда операционная система Windows # define WINDOWS -//! \brief +//! \~\brief //! \~english Macro is defined when operation system is QNX or Blackberry //! \~russian Макрос объявлен когда операционная система QNX или Blackberry # define QNX -//! \brief +//! \~\brief //! \~english Macro is defined when operation system is Blackberry //! \~russian Макрос объявлен когда операционная система Blackberry # define BLACKBERRY -//! \brief +//! \~\brief //! \~english Macro is defined when operation system is FreeBSD //! \~russian Макрос объявлен когда операционная система FreeBSD # define FREE_BSD -//! \brief +//! \~\brief //! \~english Macro is defined when operation system is Mac OS //! \~russian Макрос объявлен когда операционная система Mac OS # define MAC_OS -//! \brief +//! \~\brief //! \~english Macro is defined when operation system is Android //! \~russian Макрос объявлен когда операционная система Android # define ANDROID -//! \brief +//! \~\brief //! \~english Macro is defined when operation system is any Linux //! \~russian Макрос объявлен когда операционная система Linux # define LINUX -//! \brief +//! \~\brief //! \~english Macro is defined when operation system is FreeRTOS //! \~russian Макрос объявлен когда операционная система FreeRTOS # define FREERTOS -//! \brief +//! \~\brief //! \~english Macro is defined when compiler is GCC or MinGW //! \~russian Макрос объявлен когда компилятор GCC или MinGW # define CC_GCC -//! \brief +//! \~\brief //! \~english Macro is defined when PIP is decided that host is support language //! \~russian Макрос объявлен когда PIP решил что система поддерживает локализацию # define HAS_LOCALE -//! \brief +//! \~\brief //! \~english Macro is defined when PIP is building for embedded systems //! \~russian Макрос объявлен когда PIP собирается для встраиваемых систем # define MICRO_PIP -//! \brief +//! \~\brief //! \~english Macro is defined when compiler is Visual Studio //! \~russian Макрос объявлен когда компилятор Visual Studio # define CC_VC -//! \brief +//! \~\brief //! \~english Macro is defined when compiler is AVR GCC //! \~russian Макрос объявлен когда компилятор AVR GCC # define CC_AVR_GCC -//! \brief +//! \~\brief //! \~english Macro is defined when compiler is unknown //! \~russian Макрос объявлен когда компилятор неизвестен # define CC_OTHER -//! \brief +//! \~\brief //! \~english Macro is defined when PIP can use "rt" library for \a PITimer::ThreadRT timers implementation //! \~russian Макрос объявлен когда PIP может использовать библиотеку "rt" для \a PITimer::ThreadRT реализации таймера # define PIP_TIMER_RT -//! \brief +//! \~\brief //! \~english Macro to declare private section, "export" is optional //! \~russian Макрос для объявления частной секции, "export" необязателен # define PRIVATE_DECLARATION(export) -//! \brief +//! \~\brief //! \~english Macro to start definition of private section //! \~russian Макрос для начала реализации частной секции # define PRIVATE_DEFINITION_START(Class) -//! \brief +//! \~\brief //! \~english Macro to end definition of private section //! \~russian Макрос для окончания реализации частной секции # define PRIVATE_DEFINITION_END(Class) -//! \brief +//! \~\brief //! \~english Macro to access private section by pointer //! \~russian Макрос для доступа к частной секции # define PRIVATE -//! \brief +//! \~\brief //! \~english Macro to access private section by pointer without brakes () //! \~russian Макрос для доступа к частной секции без обрамляющих скобок () # define PRIVATEWB -//! \brief +//! \~\brief //! \~english Macro to start static initializer //! \~russian Макрос для начала статической инициализации # define STATIC_INITIALIZER_BEGIN -//! \brief +//! \~\brief //! \~english Macro to end static initializer //! \~russian Макрос для окончания статической инициализации # define STATIC_INITIALIZER_END @@ -359,10 +359,10 @@ } _PIP_ADD_COUNTER(_pip_initializer_); -//! \brief +//! \~\brief //! \~english Minimal sleep in milliseconds for internal PIP using //! \~russian Минимальное значание задержки в милисекундах для внутреннего использования в библиотеке PIP -//! \details +//! \~\details //! \~english Using in \a piMinSleep(), \a PIThread, \a PITimer::Pool. By default 1ms. //! \~russian Используется в \a piMinSleep(), \a PIThread, \a PITimer::Pool. По умолчанию равна 1мс. #ifndef PIP_MIN_MSLEEP @@ -374,28 +374,28 @@ #endif -//! \brief +//! \~\brief //! \~english Macro used for infinite loop //! \~russian Макрос для бесконечного цикла #define FOREVER for (;;) -//! \brief +//! \~\brief //! \~english Macro used for infinite wait //! \~russian Макрос для бесконечного ожидания #define FOREVER_WAIT FOREVER piMinSleep; -//! \brief +//! \~\brief //! \~english Macro used for infinite wait //! \~russian Макрос для бесконечного ожидания #define WAIT_FOREVER FOREVER piMinSleep; -//! \brief +//! \~\brief //! \~english Global variable enabling output to piCout, default is true //! \~russian Глобальная переменная, включающая вывод в piCout, при старте true extern PIP_EXPORT bool piDebug; -//! \brief +//! \~\brief //! \~english Global variable that set minimum real update interval //! for function PIInit::mountInfo(), default is 10000 ms //! \~russian Глобальная переменная минимального ожидания между реальным обновлением @@ -410,18 +410,18 @@ typedef unsigned long long ullong; typedef long long llong; typedef long double ldouble; -//! \brief +//! \~\brief //! \~english Templated function for swap two values //! \~russian Шаблонный метод для перестановки двух значений -//! \details +//! \~\details //! \~english Example:\n \snippet piincludes.cpp swap //! \~russian Пример:\n \snippet piincludes.cpp swap template inline void piSwap(T & f, T & s) {T t(std::move(f)); f = std::move(s); s = std::move(t);} -//! \brief +//! \~\brief //! \~english Templated function for swap two values without "=" //! \~russian Шаблонный метод для перестановки двух значений без использования "=" -//! \details +//! \~\details //! \~english Example:\n \snippet piincludes.cpp swapBinary //! \~russian Пример:\n \snippet piincludes.cpp swapBinary template inline void piSwapBinary(T & f, T & s) { @@ -458,10 +458,10 @@ template<> inline void piSwapBinary(const void *& f, const void *& s) { } -//! \brief +//! \~\brief //! \~english Function for compare two values without "==" by raw content //! \~russian Метод для сравнения двух значений без использования "==" (по сырому содержимому) -//! \details +//! \~\details //! \~english Example:\n \snippet piincludes.cpp compareBinary //! \~russian Пример:\n \snippet piincludes.cpp compareBinary inline bool piCompareBinary(const void * f, const void * s, size_t size) { @@ -471,10 +471,10 @@ inline bool piCompareBinary(const void * f, const void * s, size_t size) { return true; } -//! \brief +//! \~\brief //! \~english Templated function return round of float falue //! \~russian Шаблонный метод, возвращающий округленное значение -//! \details +//! \~\details //! \~english //! Round is the nearest integer value \n //! There are some macros: @@ -493,10 +493,10 @@ inline bool piCompareBinary(const void * f, const void * s, size_t size) { //! \snippet piincludes.cpp round template inline constexpr int piRound(const T & v) {return int(v >= T(0.) ? v + T(0.5) : v - T(0.5));} -//! \brief +//! \~\brief //! \~english Templated function return floor of float falue //! \~russian Шаблонный метод, возвращающий floor значение -//! \details +//! \~\details //! \~english //! Floor is the largest integer that is not greater than "v" \n //! There are some macros: @@ -515,10 +515,10 @@ template inline constexpr int piRound(const T & v) {return int(v >= //! \snippet piincludes.cpp floor template inline constexpr int piFloor(const T & v) {return v < T(0) ? int(v) - 1 : int(v);} -//! \brief +//! \~\brief //! \~english Templated function return ceil of float falue //! \~russian Шаблонный метод, возвращающий ceil значение -//! \details +//! \~\details //! \~english //! Ceil is the smallest integer that is not less than "v" \n //! There are some macros: @@ -537,10 +537,10 @@ template inline constexpr int piFloor(const T & v) {return v < T(0) //! \snippet piincludes.cpp ceil template inline constexpr int piCeil(const T & v) {return v < T(0) ? int(v) : int(v) + 1;} -//! \brief +//! \~\brief //! \~english Templated function return absolute of numeric falue //! \~russian Шаблонный метод, возвращающий модуль числового значения -//! \details +//! \~\details //! \~english //! Absolute is the positive or equal 0 value \n //! There are some macros: @@ -567,10 +567,10 @@ template inline constexpr int piCeil(const T & v) {return v < T(0) ? //! \snippet piincludes.cpp abs template inline constexpr T piAbs(const T & v) {return (v >= T(0) ? v : -v);} -//! \brief +//! \~\brief //! \~english Templated function return minimum of two values //! \~russian Шаблонный метод, возвращающий минимум из двух значений -//! \details +//! \~\details //! \~english //! There are some macros: //! - \c piMins for "short" @@ -595,10 +595,10 @@ template inline constexpr T piAbs(const T & v) {return (v >= T(0) ? //! \snippet piincludes.cpp min2 template inline constexpr T piMin(const T & f, const T & s) {return ((f > s) ? s : f);} -//! \brief +//! \~\brief //! \~english Templated function return minimum of tree values //! \~russian Шаблонный метод, возвращающий минимум из трех значений -//! \details +//! \~\details //! \~english //! There are some macros: //! - \c piMins for "short" @@ -623,10 +623,10 @@ template inline constexpr T piMin(const T & f, const T & s) {return //! \snippet piincludes.cpp min3 template inline constexpr T piMin(const T & f, const T & s, const T & t) {return ((f < s && f < t) ? f : ((s < t) ? s : t));} -//! \brief +//! \~\brief //! \~english Templated function return maximum of two values //! \~russian Шаблонный метод, возвращающий максимум из двух значений -//! \details +//! \~\details //! \~english //! There are some macros: //! - \c piMaxs for "short" @@ -651,10 +651,10 @@ template inline constexpr T piMin(const T & f, const T & s, const T //! \snippet piincludes.cpp max2 template inline constexpr T piMax(const T & f, const T & s) {return ((f < s) ? s : f);} -//! \brief +//! \~\brief //! \~english Templated function return maximum of tree values //! \~russian Шаблонный метод, возвращающий максимум из трех значений -//! \details +//! \~\details //! \~english //! There are some macros: //! - \c piMaxs for "short" @@ -679,10 +679,10 @@ template inline constexpr T piMax(const T & f, const T & s) {return //! \snippet piincludes.cpp max3 template inline constexpr T piMax(const T & f, const T & s, const T & t) {return ((f > s && f > t) ? f : ((s > t) ? s : t));} -//! \brief +//! \~\brief //! \~english Templated function return clamped value //! \~russian Шаблонный метод, возвращающий ограниченное значение -//! \details +//! \~\details //! \~english //! Clamped is the not greater than "max" and not lesser than "min" value \n //! There are some macros: @@ -709,7 +709,7 @@ template inline constexpr T piMax(const T & f, const T & s, const T //! \snippet piincludes.cpp clamp template inline constexpr T piClamp(const T & v, const T & min, const T & max) {return (v > max ? max : (v < min ? min : v));} -//! \brief +//! \~\brief //! \~english Function inverse byte order in memory block ([1..N] -> [N..1]) //! \~russian Метод для смены порядка байт в блоке памяти ([1..N] -> [N..1]) inline void piLetobe(void * data, int size) { @@ -717,10 +717,10 @@ inline void piLetobe(void * data, int size) { piSwap(((uchar*)data)[size - i - 1], ((uchar*)data)[i]); } -//! \brief +//! \~\brief //! \~english Function for compare two numeric values with epsilon //! \~russian Метод для сравнения двух чисел с порогом -//! \details +//! \~\details //! \~english //! There are some macros: //! - \c piComparef for "float" @@ -740,15 +740,15 @@ inline bool piCompare(const T & a, const T & b, const T & epsilon = std::numeric return piAbs(a - b) <= epsilon; } -//! \brief +//! \~\brief //! \~english Templated function that inverse byte order of value "v" //! \~russian Шаблонный метод, меняющий порядок байт в переменной "v" template inline void piLetobe(T * v) {piLetobe(v, sizeof(T));} -//! \brief +//! \~\brief //! \~english Templated function that returns "v" with inversed byte order //! \~russian Шаблонный метод, возвращающий переменную "v" с измененным порядком байт -//! \details +//! \~\details //! \~english //! This function used to convert values between little and big endian \n //! There are some macros: @@ -785,7 +785,7 @@ template<> inline float piLetobe(const float & v) { return a.f; } -//! \brief +//! \~\brief //! \~english Generic hash function, implements murmur3/32 algorithm //! \~russian Хэш-функция общего назначения, по алгоритму murmur3/32 inline uint piHashData(const uchar * data, uint len, uint seed = 0) { diff --git a/libs/main/core/pibitarray.h b/libs/main/core/pibitarray.h index 4492bde1..2e68a2e8 100644 --- a/libs/main/core/pibitarray.h +++ b/libs/main/core/pibitarray.h @@ -1,5 +1,5 @@ -/*! @file pibitarray.h - * @brief Bit array +/*! \file pibitarray.h + * \brief Bit array */ /* PIP - Platform Independent Primitives diff --git a/libs/main/core/pibytearray.h b/libs/main/core/pibytearray.h index 9887337a..c182271e 100644 --- a/libs/main/core/pibytearray.h +++ b/libs/main/core/pibytearray.h @@ -1,5 +1,5 @@ -/*! @file pibytearray.h - * @brief Byte array +/*! \file pibytearray.h + * \brief Byte array */ /* PIP - Platform Independent Primitives @@ -39,16 +39,16 @@ class PIString; class PIByteArray; -/*! @class PIByteArray - * @brief The PIByteArray class provides an array of bytes - * @details PIByteArray used to store raw bytes. +/*! \class PIByteArray + * \brief The PIByteArray class provides an array of bytes + * \details PIByteArray used to store raw bytes. * It can be constructed from any data and size. * You can use PIByteArray as binary stream * to serialize/deserialize any objects and data. * This class based on PIDeque and provide some handle function * to manipulate it. * - * @section PIByteArray_sec0 Usage + * \section PIByteArray_sec0 Usage * %PIByteArray can be used to store custom data and manipulate it. There are many * stream operators to store/restore common types to byte array. Store operators * places data at the end of array, restore operators takes data from the beginning @@ -57,22 +57,22 @@ class PIByteArray; * * One of the major usage of %PIByteArray is stream functions. You can form binary * packet from many types (also dynamic types, e.g. PIVector) with one line: - * @snippet pibytearray.cpp 0 + * \snippet pibytearray.cpp 0 * * Or you can descibe stream operator of your own type and store/restore vectors of * your type: - * @snippet pibytearray.cpp 1 + * \snippet pibytearray.cpp 1 * * For store/restore custom data blocks there is PIByteArray::RawData class. Stream * operators of this class simply store/restore data block to/from byte array. - * @snippet pibytearray.cpp 2 + * \snippet pibytearray.cpp 2 * - * @section PIByteArray_sec1 Attention + * \section PIByteArray_sec1 Attention * Stream operator of %PIByteArray store byte array as vector, not simply append * content of byte array. This operators useful to transmit custom data as %PIByteArray * packed into parent byte array, e.g. to form packet from %PIByteArray. * To append one byte array to another use funtion \a append(). - * @snippet pibytearray.cpp 3 + * \snippet pibytearray.cpp 3 * * */ @@ -196,7 +196,7 @@ public: }; -//! \relatesalso PIByteArray @brief Byte arrays compare operator +//! \relatesalso PIByteArray \brief Byte arrays compare operator inline bool operator <(const PIByteArray & v0, const PIByteArray & v1) { if (v0.size() == v1.size()) { if (v0.isEmpty()) return false; @@ -205,7 +205,7 @@ inline bool operator <(const PIByteArray & v0, const PIByteArray & v1) { return v0.size() < v1.size(); } -//! \relatesalso PIByteArray @brief Byte arrays compare operator +//! \relatesalso PIByteArray \brief Byte arrays compare operator inline bool operator >(const PIByteArray & v0, const PIByteArray & v1) { if (v0.size() == v1.size()) { if (v0.isEmpty()) return false; @@ -214,7 +214,7 @@ inline bool operator >(const PIByteArray & v0, const PIByteArray & v1) { return v0.size() > v1.size(); } -//! \relatesalso PIByteArray @brief Byte arrays compare operator +//! \relatesalso PIByteArray \brief Byte arrays compare operator inline bool operator ==(const PIByteArray & v0, const PIByteArray & v1) { if (v0.size() == v1.size()) { if (v0.isEmpty()) return true; @@ -223,7 +223,7 @@ inline bool operator ==(const PIByteArray & v0, const PIByteArray & v1) { return false; } -//! \relatesalso PIByteArray @brief Byte arrays compare operator +//! \relatesalso PIByteArray \brief Byte arrays compare operator inline bool operator !=(const PIByteArray & v0, const PIByteArray & v1) { if (v0.size() == v1.size()) { if (v0.isEmpty()) return false; @@ -233,11 +233,11 @@ inline bool operator !=(const PIByteArray & v0, const PIByteArray & v1) { } #ifdef PIP_STD_IOSTREAM -//! \relatesalso PIByteArray @brief Output to std::ostream operator +//! \relatesalso PIByteArray \brief Output to std::ostream operator inline std::ostream & operator <<(std::ostream & s, const PIByteArray & ba); #endif -//! \relatesalso PIByteArray @brief Output to PICout operator +//! \relatesalso PIByteArray \brief Output to PICout operator PIP_EXPORT PICout operator <<(PICout s, const PIByteArray & ba); @@ -246,16 +246,16 @@ PIP_EXPORT PICout operator <<(PICout s, const PIByteArray & ba); // store operators for basic types -//! \relatesalso PIByteArray @brief Store operator +//! \relatesalso PIByteArray \brief Store operator inline PIByteArray & operator <<(PIByteArray & s, const bool v) {s.push_back(v); return s;} -//! \relatesalso PIByteArray @brief Store operator +//! \relatesalso PIByteArray \brief Store operator inline PIByteArray & operator <<(PIByteArray & s, const char v) {s.push_back(v); return s;} -//! \relatesalso PIByteArray @brief Store operator +//! \relatesalso PIByteArray \brief Store operator inline PIByteArray & operator <<(PIByteArray & s, const uchar v) {s.push_back(v); return s;} -//! \relatesalso PIByteArray @brief Store operator for any trivial copyable type +//! \relatesalso PIByteArray \brief Store operator for any trivial copyable type template::value, int>::type = 0> inline PIByteArray::StreamRef operator <<(PIByteArray & s, const T & v) { int os = s.size_s(); @@ -264,10 +264,10 @@ inline PIByteArray::StreamRef operator <<(PIByteArray & s, const T & v) { return s; } -//! \relatesalso PIByteArray @brief Store operator, see \ref PIByteArray_sec1 for details +//! \relatesalso PIByteArray \brief Store operator, see \ref PIByteArray_sec1 for details PIP_EXPORT PIByteArray & operator <<(PIByteArray & s, const PIByteArray & v); -//! \relatesalso PIByteArray @brief Store operator, see \ref PIByteArray_sec1 for details +//! \relatesalso PIByteArray \brief Store operator, see \ref PIByteArray_sec1 for details inline PIByteArray & operator <<(PIByteArray & s, const PIByteArray::RawData & v) { int os = s.size_s(); if (v.s > 0) { @@ -277,7 +277,7 @@ inline PIByteArray & operator <<(PIByteArray & s, const PIByteArray::RawData & v return s; } -//! \relatesalso PIByteArray @brief Store operator for PIVector of any trivial copyable type +//! \relatesalso PIByteArray \brief Store operator for PIVector of any trivial copyable type template::value, int>::type = 0, typename std::enable_if< std::is_same() << std::declval()), PIByteArray::StreamRef>::value, int>::type = 0> @@ -299,7 +299,7 @@ inline PIByteArray & operator <<(PIByteArray & s, const PIVector & v) { return s; } -//! \relatesalso PIByteArray @brief Store operator for PIDeque of any trivial copyable type +//! \relatesalso PIByteArray \brief Store operator for PIDeque of any trivial copyable type template::value, int>::type = 0, typename std::enable_if< std::is_same() << std::declval()), PIByteArray::StreamRef>::value, int>::type = 0> @@ -321,7 +321,7 @@ inline PIByteArray & operator <<(PIByteArray & s, const PIDeque & v) { return s; } -//! \relatesalso PIByteArray @brief Store operator for PIVector2D of any trivial copyable type +//! \relatesalso PIByteArray \brief Store operator for PIVector2D of any trivial copyable type template::value, int>::type = 0, typename std::enable_if< std::is_same() << std::declval()), PIByteArray::StreamRef>::value, int>::type = 0> @@ -342,10 +342,10 @@ inline PIByteArray & operator <<(PIByteArray & s, const PIVector2D & v) { return s; } -//! \relatesalso PIByteArray @brief Store operator +//! \relatesalso PIByteArray \brief Store operator inline PIByteArray & operator <<(PIByteArray & s, const PIBitArray & v) {s << v.size_ << v.data_; return s;} -//! \relatesalso PIPair @brief Store operator +//! \relatesalso PIPair \brief Store operator template inline PIByteArray & operator <<(PIByteArray & s, const PIPair & v) {s << v.first << v.second; return s;} @@ -355,16 +355,16 @@ inline PIByteArray & operator <<(PIByteArray & s, const PIPair & v // restore operators for basic types -//! \relatesalso PIByteArray @brief Restore operator +//! \relatesalso PIByteArray \brief Restore operator inline PIByteArray & operator >>(PIByteArray & s, bool & v) {assert(s.size() >= 1u); v = s.take_front(); return s;} -//! \relatesalso PIByteArray @brief Restore operator +//! \relatesalso PIByteArray \brief Restore operator inline PIByteArray & operator >>(PIByteArray & s, char & v) {assert(s.size() >= 1u); v = s.take_front(); return s;} -//! \relatesalso PIByteArray @brief Restore operator +//! \relatesalso PIByteArray \brief Restore operator inline PIByteArray & operator >>(PIByteArray & s, uchar & v) {assert(s.size() >= 1u); v = s.take_front(); return s;} -//! \relatesalso PIByteArray @brief Restore operator for any trivial copyable type +//! \relatesalso PIByteArray \brief Restore operator for any trivial copyable type template::value, int>::type = 0> inline PIByteArray::StreamRef operator >>(PIByteArray & s, T & v) { if (s.size() < sizeof(v)) { @@ -376,10 +376,10 @@ inline PIByteArray::StreamRef operator >>(PIByteArray & s, T & v) { return s; } -//! \relatesalso PIByteArray @brief Restore operator, see \ref PIByteArray_sec1 for details +//! \relatesalso PIByteArray \brief Restore operator, see \ref PIByteArray_sec1 for details PIP_EXPORT PIByteArray & operator >>(PIByteArray & s, PIByteArray & v); -//! \relatesalso PIByteArray @brief Restore operator, see \ref PIByteArray_sec1 for details +//! \relatesalso PIByteArray \brief Restore operator, see \ref PIByteArray_sec1 for details inline PIByteArray & operator >>(PIByteArray & s, PIByteArray::RawData v) { if (s.size_s() < v.s) { printf("error with RawData %d < %d\n", (int)s.size_s(), v.s); @@ -392,7 +392,7 @@ inline PIByteArray & operator >>(PIByteArray & s, PIByteArray::RawData v) { return s; } -//! \relatesalso PIByteArray @brief Restore operator for PIVector of any trivial copyable type +//! \relatesalso PIByteArray \brief Restore operator for PIVector of any trivial copyable type template::value, int>::type = 0, typename std::enable_if< std::is_same() << std::declval()), PIByteArray::StreamRef>::value, int>::type = 0> @@ -423,7 +423,7 @@ inline PIByteArray & operator >>(PIByteArray & s, PIVector & v) { return s; } -//! \relatesalso PIByteArray @brief Restore operator for PIDeque of any trivial copyable type +//! \relatesalso PIByteArray \brief Restore operator for PIDeque of any trivial copyable type template::value, int>::type = 0, typename std::enable_if< std::is_same() << std::declval()), PIByteArray::StreamRef>::value, int>::type = 0> @@ -454,7 +454,7 @@ inline PIByteArray & operator >>(PIByteArray & s, PIDeque & v) { return s; } -//! \relatesalso PIByteArray @brief Restore operator for PIVector2D of any trivial copyable type +//! \relatesalso PIByteArray \brief Restore operator for PIVector2D of any trivial copyable type template::value, int>::type = 0, typename std::enable_if< std::is_same() << std::declval()), PIByteArray::StreamRef>::value, int>::type = 0> @@ -487,10 +487,10 @@ inline PIByteArray & operator >>(PIByteArray & s, PIVector2D & v) { return s; } -//! \relatesalso PIByteArray @brief Restore operator +//! \relatesalso PIByteArray \brief Restore operator inline PIByteArray & operator >>(PIByteArray & s, PIBitArray & v) {assert(s.size_s() >= 8); s >> v.size_ >> v.data_; return s;} -//! \relatesalso PIPair @brief Restore operator +//! \relatesalso PIPair \brief Restore operator template inline PIByteArray & operator >>(PIByteArray & s, PIPair & v) {s >> v.first >> v.second; return s;} @@ -500,7 +500,7 @@ inline PIByteArray & operator >>(PIByteArray & s, PIPair & v) {s > // store operators for complex types -//! \relatesalso PIByteArray @brief Store operator for PIVector of any compound type +//! \relatesalso PIByteArray \brief Store operator for PIVector of any compound type template::value, int>::type = 0> inline PIByteArray & operator <<(PIByteArray & s, const PIVector & v) { s << int(v.size_s()); @@ -508,7 +508,7 @@ inline PIByteArray & operator <<(PIByteArray & s, const PIVector & v) { return s; } -//! \relatesalso PIByteArray @brief Store operator for PIDeque of any compound type +//! \relatesalso PIByteArray \brief Store operator for PIDeque of any compound type template::value, int>::type = 0> inline PIByteArray & operator <<(PIByteArray & s, const PIDeque & v) { s << int(v.size_s()); @@ -516,7 +516,7 @@ inline PIByteArray & operator <<(PIByteArray & s, const PIDeque & v) { return s; } -//! \relatesalso PIByteArray @brief Store operator for PIVector2D of any compound type +//! \relatesalso PIByteArray \brief Store operator for PIVector2D of any compound type template::value, int>::type = 0> inline PIByteArray & operator <<(PIByteArray & s, const PIVector2D & v) { s << int(v.rows()) << int(v.cols()) << v.toPlainVector(); @@ -529,7 +529,7 @@ inline PIByteArray & operator <<(PIByteArray & s, const PIVector2D & v) { // restore operators for complex types -//! \relatesalso PIByteArray @brief Restore operator for PIVector of any compound type +//! \relatesalso PIByteArray \brief Restore operator for PIVector of any compound type template::value, int>::type = 0> inline PIByteArray & operator >>(PIByteArray & s, PIVector & v) { if (s.size_s() < 4) { @@ -542,7 +542,7 @@ inline PIByteArray & operator >>(PIByteArray & s, PIVector & v) { return s; } -//! \relatesalso PIByteArray @brief Restore operator for PIDeque of any compound type +//! \relatesalso PIByteArray \brief Restore operator for PIDeque of any compound type template::value, int>::type = 0> inline PIByteArray & operator >>(PIByteArray & s, PIDeque & v) { if (s.size_s() < 4) { @@ -555,7 +555,7 @@ inline PIByteArray & operator >>(PIByteArray & s, PIDeque & v) { return s; } -//! \relatesalso PIByteArray @brief Restore operator for PIVector2D of any compound type +//! \relatesalso PIByteArray \brief Restore operator for PIVector2D of any compound type template::value, int>::type = 0> inline PIByteArray & operator >>(PIByteArray & s, PIVector2D & v) { if (s.size_s() < 8) { diff --git a/libs/main/core/pichar.cpp b/libs/main/core/pichar.cpp index 836caf17..c51417b1 100644 --- a/libs/main/core/pichar.cpp +++ b/libs/main/core/pichar.cpp @@ -1,5 +1,5 @@ -/*! @file pichar.h - * @brief Unicode char +/*! \file pichar.h + * \brief Unicode char */ /* PIP - Platform Independent Primitives @@ -46,7 +46,7 @@ char * __utf8name__ = 0; #endif /*! \class PIChar - * @brief Unicode char + * \brief Unicode char * \details This class is wrapper around \c "uint". * There are many contructors and information functions */ diff --git a/libs/main/core/pichar.h b/libs/main/core/pichar.h index 9e123989..a2b5dad2 100644 --- a/libs/main/core/pichar.h +++ b/libs/main/core/pichar.h @@ -1,5 +1,5 @@ -/*! @file pichar.h - * @brief Unicode char +/*! \file pichar.h + * \brief Unicode char */ /* PIP - Platform Independent Primitives diff --git a/libs/main/core/pichunkstream.cpp b/libs/main/core/pichunkstream.cpp index 9fc0a8a5..c5a69664 100644 --- a/libs/main/core/pichunkstream.cpp +++ b/libs/main/core/pichunkstream.cpp @@ -20,7 +20,7 @@ #include "pichunkstream.h" /*! \class PIChunkStream - * @brief Class for binary serialization + * \brief Class for binary serialization * * \section PIChunkStream_sec0 Synopsis * This class provides very handly mechanism to store and restore values to and from diff --git a/libs/main/core/pichunkstream.h b/libs/main/core/pichunkstream.h index edfd0591..16f96824 100644 --- a/libs/main/core/pichunkstream.h +++ b/libs/main/core/pichunkstream.h @@ -1,5 +1,5 @@ -/*! @file pichunkstream.h - * @brief Binary markup serializator +/*! \file pichunkstream.h + * \brief Binary markup serializator */ /* PIP - Platform Independent Primitives diff --git a/libs/main/core/picli.cpp b/libs/main/core/picli.cpp index 67b15d38..cb58e5e4 100644 --- a/libs/main/core/picli.cpp +++ b/libs/main/core/picli.cpp @@ -22,7 +22,7 @@ /*! \class PICLI - * @brief Command-line arguments parser + * \brief Command-line arguments parser * * \section PICLI_sec0 Synopsis * This class provide handy parsing of command-line arguments. First you should add diff --git a/libs/main/core/picli.h b/libs/main/core/picli.h index 0908be78..43d8e01c 100644 --- a/libs/main/core/picli.h +++ b/libs/main/core/picli.h @@ -1,5 +1,5 @@ -/*! @file picli.h - * @brief Command-Line parser +/*! \file picli.h + * \brief Command-Line parser */ /* PIP - Platform Independent Primitives diff --git a/libs/main/core/picollection.cpp b/libs/main/core/picollection.cpp index 13790c95..7b94cf47 100644 --- a/libs/main/core/picollection.cpp +++ b/libs/main/core/picollection.cpp @@ -21,7 +21,7 @@ /** \class PICollection - * @brief Interface to discover element groups + * \brief Interface to discover element groups * \details * \section PICollection_sec0 Synopsis * This class has only static functions so no need to create instance of the diff --git a/libs/main/core/picollection.h b/libs/main/core/picollection.h index 33058185..7f2c36f1 100644 --- a/libs/main/core/picollection.h +++ b/libs/main/core/picollection.h @@ -1,5 +1,5 @@ -/*! @file picollection.h - * @brief Custom elements collection +/*! \file picollection.h + * \brief Custom elements collection */ /* PIP - Platform Independent Primitives @@ -27,7 +27,7 @@ #ifdef DOXYGEN -/** @brief Add existing element "object" in group with name "group" +/** \brief Add existing element "object" in group with name "group" * \relatesalso PICollection * \details If there is no group with name "group" it will be created. * Only one element of the class "object" can be in group "group". If @@ -35,7 +35,7 @@ * be pointer to object based on PIObject. */ # define ADD_TO_COLLECTION(group, object) -/** @brief Add new element of class "class" in group with name "group" +/** \brief Add new element of class "class" in group with name "group" * \relatesalso PICollection * \details If there is no group with name "group" it will be created. * Only one element of the class "class" can be in group "group". If @@ -65,10 +65,10 @@ class PIP_EXPORT PICollection public: PICollection() {;} - //! @brief Returns all existing groups by their names + //! \brief Returns all existing groups by their names static PIStringList groups(); - //! @brief Returns all elements of group "group" + //! \brief Returns all elements of group "group" static PIVector groupElements(const PIString & group); static bool addToGroup(const PIString & group, const PIObject * element); diff --git a/libs/main/core/picout.h b/libs/main/core/picout.h index 12ede0eb..34fe5c5f 100644 --- a/libs/main/core/picout.h +++ b/libs/main/core/picout.h @@ -1,5 +1,5 @@ -/*! @file picout.h - * @brief Universal output to console class +/*! \file picout.h + * \brief Universal output to console class */ /* PIP - Platform Independent Primitives @@ -27,10 +27,10 @@ #ifdef DOXYGEN -//! @brief Macro used for conditional (piDebug) output to PICout +//! \brief Macro used for conditional (piDebug) output to PICout # define piCout -//! \relatesalso PIObject @brief Macro used for conditional (piDebug and PIObject::debug()) output to PICout for subclasses of PIObject +//! \relatesalso PIObject \brief Macro used for conditional (piDebug and PIObject::debug()) output to PICout for subclasses of PIObject # define piCoutObj #else @@ -42,10 +42,10 @@ class PIObject; -//! @brief Namespace contains enums controlled PICout +//! \brief Namespace contains enums controlled PICout namespace PICoutManipulators { - //! @brief Enum contains special characters + //! \brief Enum contains special characters enum PICoutSpecialChar { Null /*! Null-character, '\\0' */, NewLine /*! New line character, '\\n' */, @@ -54,7 +54,7 @@ namespace PICoutManipulators { Quote /*! Quote character, '"' */ }; - //! @brief Enum contains immediate action + //! \brief Enum contains immediate action enum PICoutAction { Flush /*! Flush the output */, Backspace /*! Remove last symbol */, @@ -66,7 +66,7 @@ namespace PICoutManipulators { RestoreControl /*! Restore control flags, equivalent to \a restoreControl() */ }; - //! @brief Enum contains control of PICout + //! \brief Enum contains control of PICout enum PICoutControl { AddNone /*! No controls */ = 0x0, AddSpaces /*! Spaces will be appear after each output */ = 0x1, @@ -77,7 +77,7 @@ namespace PICoutManipulators { NoLock /*! Don`t use mutex for output */ = 0x100, }; - //! @brief Enum contains output format + //! \brief Enum contains output format enum PICoutFormat { Bin /*! Binary representation of integers */ = 0x01, Oct /*! Octal representation of integers */ = 0x02, @@ -112,7 +112,7 @@ namespace PICoutManipulators { /*! \class PICout - * @brief Class for formatted output similar std::cout + * \brief Class for formatted output similar std::cout * * \section PICout_sec0 Synopsis * This class provide many stream operators for output with some features. @@ -150,7 +150,7 @@ public: /*! \class PICout::Notifier - * @brief Class for emit notifications of PICout + * \brief Class for emit notifications of PICout * * \section PICout_sec0 Synopsis * This class used as PICout events emitter. When @@ -170,7 +170,7 @@ public: PIObject * o; }; - //! @brief Enum contains output devices of PICout + //! \brief Enum contains output devices of PICout enum OutputDevice { NoDevices /** PICout is disabled */ = 0x0, StdOut /** Standard console output */ = 0x1, @@ -292,17 +292,17 @@ public: //! Restore control flags from internal stack \sa \a saveControl() PICout & restoreControl(); - /*! @brief Conditional put space character to output + /*! \brief Conditional put space character to output * \details If it is not a first output and control \a AddSpaces is set * space character is put \sa \a quote(), \a newLine() */ PICout & space(); - /*! @brief Conditional put quote character to output + /*! \brief Conditional put quote character to output * \details If control \a AddQuotes is set * quote character is put \sa \a space(), \a newLine() */ PICout & quote(); - /*! @brief Conditional put new line character to output + /*! \brief Conditional put new line character to output * \details If control \a AddNewLine is set * new line character is put \sa \a space(), \a quote() */ PICout & newLine(); diff --git a/libs/main/core/piflags.h b/libs/main/core/piflags.h index 91ba874e..6d824826 100644 --- a/libs/main/core/piflags.h +++ b/libs/main/core/piflags.h @@ -1,5 +1,5 @@ -/*! @file piflags.h - * @brief General flags class +/*! \file piflags.h + * \brief General flags class */ /* PIP - Platform Independent Primitives @@ -25,7 +25,7 @@ #include "pip_export.h" -/*! @brief This class used as container for bit flags +/*! \brief This class used as container for bit flags * \details PIFlags is wrapper around \c "int". There are many * bit-wise operators, native conversion to int and function * to test flag. \n Example: diff --git a/libs/main/core/piinit.h b/libs/main/core/piinit.h index 2ea2936a..23e8f852 100644 --- a/libs/main/core/piinit.h +++ b/libs/main/core/piinit.h @@ -1,5 +1,5 @@ -/*! @file piinit.h - * @brief Initialization +/*! \file piinit.h + * \brief Initialization */ /* PIP - Platform Independent Primitives @@ -51,7 +51,7 @@ class PIP_EXPORT PIInit { public: ~PIInit(); - //! @brief Build options which PIP library was built + //! \brief Build options which PIP library was built enum BuildOption { boICU /*! Unicode support */ = 0x01, boUSB /*! USB support */ = 0x02, diff --git a/libs/main/core/piobject.cpp b/libs/main/core/piobject.cpp index ab051a78..11e66231 100644 --- a/libs/main/core/piobject.cpp +++ b/libs/main/core/piobject.cpp @@ -26,7 +26,7 @@ #endif /** \class PIObject - * @brief This is base class for any classes which use events -> handlers mechanism. + * \brief This is base class for any classes which use events -> handlers mechanism. * \details * \section PIObject_sec0 Events and Event handlers * %PIObject provide notification mechanism similar Qt but implemented diff --git a/libs/main/core/piobject.h b/libs/main/core/piobject.h index c6c6451a..0d44d77c 100644 --- a/libs/main/core/piobject.h +++ b/libs/main/core/piobject.h @@ -1,5 +1,5 @@ -/*! @file piobject.h - * @brief Base object +/*! \file piobject.h + * \brief Base object * * This file declare PIObject class */ @@ -445,15 +445,15 @@ public: }; typedef PIPair __EHPair; - //! @brief Execute all posted events from CONNECTU_QUEUED connections + //! \brief Execute all posted events from CONNECTU_QUEUED connections void callQueuedEvents(); - //! @brief Check if any CONNECTU_QUEUED connections to this object and execute them + //! \brief Check if any CONNECTU_QUEUED connections to this object and execute them //! \details This function is more optimized than \a callQueuedEvents() for objects that doesn`t //! appears as \"performer\" target at CONNECTU_QUEUED bool maybeCallQueuedEvents() {if (proc_event_queue) callQueuedEvents(); return proc_event_queue;} - //! @brief Mark object to delete + //! \brief Mark object to delete //! \details On first call background thread started to delete objects. //! Each object deletes when it`s outside from any events and hadlers. void deleteLater(); @@ -475,7 +475,7 @@ protected: //! \{ /** \fn void deleted(PIObject * o) - * @brief Raise before object delete + * \brief Raise before object delete * \note This event raised from destructor, so use only "o" value, * don`t try to cast deleted object to some subclass! */ diff --git a/libs/main/core/piobject_macros.h b/libs/main/core/piobject_macros.h index cff78bca..00291656 100644 --- a/libs/main/core/piobject_macros.h +++ b/libs/main/core/piobject_macros.h @@ -1,5 +1,5 @@ -/*! @file piobject_macros.h - * @brief Base object +/*! \file piobject_macros.h + * \brief Base object * * This file declare macros for PIObject */ @@ -29,67 +29,67 @@ #ifdef DOXYGEN -/// \relatesalso PIObject @brief you should use this macro after class declaration to use EVENT and EVENT_HANDLER and correct piCoutObj output +/// \relatesalso PIObject \brief you should use this macro after class declaration to use EVENT and EVENT_HANDLER and correct piCoutObj output #define PIOBJECT(name) -/// \relatesalso PIObject @brief you should use this macro after class declaration to use EVENT and EVENT_HANDLER of parent class, and \a scopeList() +/// \relatesalso PIObject \brief you should use this macro after class declaration to use EVENT and EVENT_HANDLER of parent class, and \a scopeList() #define PIOBJECT_SUBCLASS(name, parent) -/// \relatesalso PIObject @brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name() +/// \relatesalso PIObject \brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name() #define EVENT_HANDLER0(ret, name) ret name() -/// \relatesalso PIObject @brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name(type0 var0) +/// \relatesalso PIObject \brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name(type0 var0) #define EVENT_HANDLER1(ret, name, type0, var0) ret name(type0 var0) -/// \relatesalso PIObject @brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name(type0 var0, type1 var1) +/// \relatesalso PIObject \brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name(type0 var0, type1 var1) #define EVENT_HANDLER2(ret, name, type0, var0, type1, var1) ret name(type0 var0, type1 var1) -/// \relatesalso PIObject @brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name(type0 var0, type1 var1, type2 var2) +/// \relatesalso PIObject \brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name(type0 var0, type1 var1, type2 var2) #define EVENT_HANDLER3(ret, name, type0, var0, type1, var1, type2, var2) ret name(type0 var0, type1 var1, type2 var2) -/// \relatesalso PIObject @brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name(type0 var0, type1 var1, type2 var2, type3 var3) +/// \relatesalso PIObject \brief declare event handler \"event\" with name \"name\" and return type \"ret\", ret name(type0 var0, type1 var1, type2 var2, type3 var3) #define EVENT_HANDLER4(ret, name, type0, var0, type1, var1, type2, var2, type3, var3) ret name(type0 var0, type1 var1, type2 var2, type3 var3) -/// \relatesalso PIObject @brief EVENT_HANDLER is synonym of EVENT_HANDLER0 +/// \relatesalso PIObject \brief EVENT_HANDLER is synonym of EVENT_HANDLER0 #define EVENT_HANDLER EVENT_HANDLER0 -/// \relatesalso PIObject @brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name() +/// \relatesalso PIObject \brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name() #define EVENT_VHANDLER0(ret, name) virtual ret name() -/// \relatesalso PIObject @brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name(type0 var0) +/// \relatesalso PIObject \brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name(type0 var0) #define EVENT_VHANDLER1(ret, name, type0, var0) virtual ret name(type0 var0) -/// \relatesalso PIObject @brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name(type0 var0, type1 var1) +/// \relatesalso PIObject \brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name(type0 var0, type1 var1) #define EVENT_VHANDLER2(ret, name, type0, var0, type1, var1) virtual ret name(type0 var0, type1 var1) -/// \relatesalso PIObject @brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name(type0 var0, type1 var1, type2 var2) +/// \relatesalso PIObject \brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name(type0 var0, type1 var1, type2 var2) #define EVENT_VHANDLER3(ret, name, type0, var0, type1, var1, type2, var2) virtual ret name(type0 var0, type1 var1, type2 var2) -/// \relatesalso PIObject @brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name(type0 var0, type1 var1, type2 var2, type3 var3) +/// \relatesalso PIObject \brief declare virtual event handler \"event\" with name \"name\" and return type \"ret\", virtual ret name(type0 var0, type1 var1, type2 var2, type3 var3) #define EVENT_VHANDLER4(ret, name, type0, var0, type1, var1, type2, var2, type3, var3) virtual ret name(type0 var0, type1 var1, type2 var2, type3 var3) -/// \relatesalso PIObject @brief EVENT_VHANDLER is synonym of EVENT_VHANDLER0 +/// \relatesalso PIObject \brief EVENT_VHANDLER is synonym of EVENT_VHANDLER0 #define EVENT_VHANDLER EVENT_VHANDLER0 -/// \relatesalso PIObject @brief declare event \"event\" with name \"name\", void name(); +/// \relatesalso PIObject \brief declare event \"event\" with name \"name\", void name(); #define EVENT0(name) void name(); -/// \relatesalso PIObject @brief declare event \"event\" with name \"name\", void name(type0 var0); +/// \relatesalso PIObject \brief declare event \"event\" with name \"name\", void name(type0 var0); #define EVENT1(name, type0, var0) void name(type0 var0); -/// \relatesalso PIObject @brief declare event \"event\" with name \"name\", void name(type0 var0, type1 var1); +/// \relatesalso PIObject \brief declare event \"event\" with name \"name\", void name(type0 var0, type1 var1); #define EVENT2(name, type0, var0, type1, var1) void name(type0 var0, type1 var1); -/// \relatesalso PIObject @brief declare event \"event\" with name \"name\", void name(type0 var0, type1 var1, type2 var2); +/// \relatesalso PIObject \brief declare event \"event\" with name \"name\", void name(type0 var0, type1 var1, type2 var2); #define EVENT3(name, type0, var0, type1, var1, type2, var2) void name(type0 var0, type1 var1, type2 var2); -/// \relatesalso PIObject @brief declare event \"event\" with name \"name\", void name(type0 var0, type1 var1, type2 var2, type3 var3); +/// \relatesalso PIObject \brief declare event \"event\" with name \"name\", void name(type0 var0, type1 var1, type2 var2, type3 var3); #define EVENT4(name, type0, var0, type1, var1, type2, var2, type3, var3) void name(type0 var0, type1 var1, type2 var2, type3 var3); -/// \relatesalso PIObject @brief EVENT is synonym of EVENT0 +/// \relatesalso PIObject \brief EVENT is synonym of EVENT0 #define EVENT EVENT0 @@ -101,82 +101,82 @@ #define RAISE_EVENT RAISE_EVENT0 -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\". \"Event\" and \"handler\" must has equal argument lists. +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\". \"Event\" and \"handler\" must has equal argument lists. /// Returns PIObject::Connection #define CONNECTU(src, event, dest, handler) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\". +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\". /// Event handler will be executed by \"performer\". \"Event\" and \"handler\" must has equal argument lists. /// Returns PIObject::Connection #define CONNECTU_QUEUED(src, event, dest, handler, performer) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to lambda-expression \"functor\". \"Event\" and \"functor\" must has equal argument lists. +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to lambda-expression \"functor\". \"Event\" and \"functor\" must has equal argument lists. /// Returns PIObject::Connection #define CONNECTL(src, event, functor) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists /// Returns PIObject::Connection #define CONNECT0(ret, src, event, dest, handler) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists /// Returns PIObject::Connection #define CONNECT1(ret, type0, src, event, dest, handler) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists /// Returns PIObject::Connection #define CONNECT2(ret, type0, type1, src, event, dest, handler) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists /// Returns PIObject::Connection #define CONNECT3(ret, type0, type1, type2, src, event, dest, handler) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists. +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" with check of event and handler exists. /// Returns PIObject::Connection #define CONNECT4(ret, type0, type1, type2, type3, src, event, dest, handler) -/// \relatesalso PIObject @brief CONNECT is synonym of CONNECT0 +/// \relatesalso PIObject \brief CONNECT is synonym of CONNECT0 #define CONNECT CONNECT0 -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists #define WEAK_CONNECT0(ret, src, event, dest, handler) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists #define WEAK_CONNECT1(ret, type0, src, event, dest, handler) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists #define WEAK_CONNECT2(ret, type0, type1, src, event, dest, handler) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists #define WEAK_CONNECT3(ret, type0, type1, type2, src, event, dest, handler) -/// \relatesalso PIObject @brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists +/// \relatesalso PIObject \brief connect event \"event\" from object \"src\" to event handler \"handler\" with return type \"ret\" from object \"dest\" without check of event exists #define WEAK_CONNECT4(ret, type0, type1, type2, type3, src, event, dest, handler) -/// \relatesalso PIObject @brief WEAK_CONNECT is synonym of WEAK_CONNECT0 +/// \relatesalso PIObject \brief WEAK_CONNECT is synonym of WEAK_CONNECT0 #define WEAK_CONNECT WEAK_CONNECT0 -/// \relatesalso PIObject @brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" +/// \relatesalso PIObject \brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" #define DISCONNECT0(ret, src, event, dest, handler) -/// \relatesalso PIObject @brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" +/// \relatesalso PIObject \brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" #define DISCONNECT1(ret, type0, src, event, dest, handler) -/// \relatesalso PIObject @brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" +/// \relatesalso PIObject \brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" #define DISCONNECT2(ret, type0, type1, src, event, dest, handler) -/// \relatesalso PIObject @brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" +/// \relatesalso PIObject \brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" #define DISCONNECT3(ret, type0, type1, type2, src, event, dest, handler) -/// \relatesalso PIObject @brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" +/// \relatesalso PIObject \brief piDisconnect event \"event\" from object \"src\" from event handler \"handler\" with return type \"ret\" from object \"dest\" #define DISCONNECT4(ret, type0, type1, type2, type3, src, event, dest, handler) -/// \relatesalso PIObject @brief DISCONNECT is synonym of DISCONNECT0 +/// \relatesalso PIObject \brief DISCONNECT is synonym of DISCONNECT0 #define DISCONNECT DISCONNECT0 -/// \relatesalso PIObject @brief Returns pointer to events handler \"handler\" +/// \relatesalso PIObject \brief Returns pointer to events handler \"handler\" #define HANDLER(handler) diff --git a/libs/main/core/pipropertystorage.h b/libs/main/core/pipropertystorage.h index bc678279..3dc3ded3 100644 --- a/libs/main/core/pipropertystorage.h +++ b/libs/main/core/pipropertystorage.h @@ -1,5 +1,5 @@ -/*! @file pipropertystorage.h - * @brief Storage of properties for GUI usage +/*! \file pipropertystorage.h + * \brief Storage of properties for GUI usage * * This file declare PIPropertyStorage */ @@ -28,7 +28,7 @@ #include "pivariant.h" /** - * @brief Key-value storage, based on PIVector with PIPropertyStorage::Property elements. Each element in vector + * \brief Key-value storage, based on PIVector with PIPropertyStorage::Property elements. Each element in vector * contains unique name and you can identify property by name with propertyValueByName(), propertyByName(). * You can add property using addProperty(const Property&), addProperty(const PIString&, const PIVariant&, const PIString&, int). */ @@ -37,7 +37,7 @@ public: PIPropertyStorage() {} /** - * @brief PIPropertyStorage element. + * \brief PIPropertyStorage element. */ struct PIP_EXPORT Property { Property(const PIString & n = PIString(), const PIString & c = PIString(), const PIVariant & v = PIVariant(), int f = 0): @@ -112,18 +112,18 @@ public: const PIPropertyStorage & propertyStorage() const {return *this;} /** - * @brief Check if property with \a name exists + * \brief Check if property with \a name exists * @return "true" if property exists */ bool isPropertyExists(const PIString & _name) const; /** - * @brief Remove all properties + * \brief Remove all properties */ void clearProperties() {props.clear();} /** - * @brief Add property if name isn't present in storage, otherwrise update existing property with same name. + * \brief Add property if name isn't present in storage, otherwrise update existing property with same name. * @return "true" if new property added, else if update existing property return "false" * @param p to copy in storage */ @@ -131,32 +131,32 @@ public: bool addProperty(Property && p); /** - * @brief First of all construct Property with method params. After then add property if name isn't present + * \brief First of all construct Property with method params. After then add property if name isn't present * in storage, otherwrise update existing property with same name. * @return "true" if new property added, else if update existing property return "false" */ bool addProperty(const PIString & _name, const PIVariant & _def_value, const PIString & _comment = PIString(), int _flags = 0); /** - * @brief Remove property with \a name + * \brief Remove property with \a name * @return "true" if property exists and removed */ bool removeProperty(const PIString & _name); /** - * @brief Remove properties wich has \a flag set + * \brief Remove properties wich has \a flag set * @return removed properties count */ int removePropertiesByFlag(int flag); /** - * @brief Merge other \a properties_ into this + * \brief Merge other \a properties_ into this * @param flag_ignore - properties wich has this flag set will be ignored in merge */ void updateProperties(const PIVector & properties_, int flag_ignore = 0); /** - * @brief Search property by name and return it. + * \brief Search property by name and return it. * * @param name of property * @return property value or default constructed Property @@ -164,7 +164,7 @@ public: Property propertyByName(const PIString & name) const; /** - * @brief Search property by name and return property value. + * \brief Search property by name and return property value. * * @param name of property * @return property value or invalid PIVariant if name unknown @@ -172,7 +172,7 @@ public: PIVariant propertyValueByName(const PIString & name) const; /** - * @brief Set value of property with specific name if name is present in storage. + * \brief Set value of property with specific name if name is present in storage. * * @param name of property to set value * @param value to set @@ -181,7 +181,7 @@ public: bool setPropertyValue(const PIString & name, const PIVariant & value); /** - * @brief Set comment of property with specific name if name is present in storage. + * \brief Set comment of property with specific name if name is present in storage. * * @param name of property to set comment * @param comment to set @@ -190,7 +190,7 @@ public: bool setPropertyComment(const PIString & name, const PIString & comment); /** - * @brief Set flags of property with specific name if name is present in storage. + * \brief Set flags of property with specific name if name is present in storage. * * @param name of property to set flags * @param flags to set diff --git a/libs/main/core/pistring.cpp b/libs/main/core/pistring.cpp index 104f506d..578d949a 100644 --- a/libs/main/core/pistring.cpp +++ b/libs/main/core/pistring.cpp @@ -36,7 +36,7 @@ #endif /*! \class PIString - * @brief String class + * \brief String class * \details PIP use this class for use string information. * * \section PIString_sec0 Synopsis @@ -72,7 +72,7 @@ /*! \fn int versionCompare(const PIString & v0, const PIString & v1, int components = 6) * \relatesalso PIString - * @brief Compare two version strings in free notation and returns 0, -1 or 1 + * \brief Compare two version strings in free notation and returns 0, -1 or 1 * \details This function parse version to number codes and labels. Then it * compare no more than "components" codes. If there is no difference, compare * labels. Each label has corresponding integer value, so @@ -95,7 +95,7 @@ * * \fn PIString versionNormalize(const PIString & v) * \relatesalso PIString - * @brief Converts version string in free notation to classic view + * \brief Converts version string in free notation to classic view * \details Parse version as described in \a versionCompare() and * returns classic view of codes and labels: major.minor.revision[-build][_label]. * Example: diff --git a/libs/main/core/pistring.h b/libs/main/core/pistring.h index be55ae1a..9a4d1d6d 100644 --- a/libs/main/core/pistring.h +++ b/libs/main/core/pistring.h @@ -1,5 +1,5 @@ -/*! @file pistring.h - * @brief String +/*! \file pistring.h + * \brief String * * This file declare string and string list classes */ @@ -59,12 +59,12 @@ public: PIString(const PIChar c): PIDeque() {*this += c;} PIString(const char c): PIDeque() {*this += PIChar(c);} - /*! @brief Contructs string from c-string "str" + /*! \brief Contructs string from c-string "str" * \details "str" should be null-terminated\n * Example: \snippet pistring.cpp PIString(char * ) */ PIString(const char * str): PIDeque() {*this += str;} - /*! @brief Contructs string from \c wchar_t c-string "str" + /*! \brief Contructs string from \c wchar_t c-string "str" * \details "str" should be null-terminated\n * Example: \snippet pistring.cpp PIString(wchar_t * ) */ PIString(const wchar_t * str): PIDeque() {*this += str;} @@ -72,18 +72,18 @@ public: //! Contructs string from byte array "ba" PIString(const PIByteArray & ba): PIDeque() {*this += ba;} - //! @brief Contructs string from "len" characters of buffer "str" + //! \brief Contructs string from "len" characters of buffer "str" PIString(const PIChar * str, const int len): PIDeque(str, size_t(len)) {} - /*! @brief Contructs string from "len" characters of buffer "str" + /*! \brief Contructs string from "len" characters of buffer "str" * \details Example: \snippet pistring.cpp PIString(char * , int) */ PIString(const char * str, const int len): PIDeque() {appendFromChars(str, len);} - /*! @brief Contructs string as sequence of characters "c" of buffer with length "len" + /*! \brief Contructs string as sequence of characters "c" of buffer with length "len" * \details Example: \snippet pistring.cpp PIString(int, char) */ PIString(const int len, const char c): PIDeque() {for (int i = 0; i < len; ++i) push_back(c);} - /*! @brief Contructs string as sequence of symbols "c" of buffer with length "len" + /*! \brief Contructs string as sequence of symbols "c" of buffer with length "len" * \details Example: \snippet pistring.cpp PIString(int, PIChar) */ PIString(const int len, const PIChar c): PIDeque() {for (int i = 0; i < len; ++i) push_back(c);} @@ -148,32 +148,32 @@ public: //! Compare operator bool operator >=(const char * str) const {return *this >= PIString(str);} - /*! @brief Append string "str" at the end of string + /*! \brief Append string "str" at the end of string * \details Example: \snippet pistring.cpp PIString::<<(PIString) */ PIString & operator <<(const PIString & str) {*this += str; return *this;} - /*! @brief Append symbol "c" at the end of string + /*! \brief Append symbol "c" at the end of string * \details Example: \snippet pistring.cpp PIString::<<(PIChar) */ PIString & operator <<(const PIChar c) {*this += c; return *this;} - /*! @brief Append symbol "c" at the end of string + /*! \brief Append symbol "c" at the end of string * \details Example: \snippet pistring.cpp PIString::<<(PIChar) */ PIString & operator <<(const char c) {*this += PIChar(c); return *this;} - /*! @brief Append c-string "str" at the end of string + /*! \brief Append c-string "str" at the end of string * \details Example: \snippet pistring.cpp PIString::<<(char * ) */ PIString & operator <<(const char * str) {*this += str; return *this;} - /*! @brief Append \c wchar_t c-string "str" at the end of string + /*! \brief Append \c wchar_t c-string "str" at the end of string * \details Example: \snippet pistring.cpp PIString::<<(wchar_t * ) */ PIString & operator <<(const wchar_t * str) {*this += str; return *this;} - /*! @brief Append string representation of "num" at the end of string + /*! \brief Append string representation of "num" at the end of string * \details Example: \snippet pistring.cpp PIString::<<(int) */ PIString & operator <<(const int & num) {*this += PIString::fromNumber(num); return *this;} PIString & operator <<(const uint & num) {*this += PIString::fromNumber(num); return *this;} - /*! @brief Append string representation of "num" at the end of string + /*! \brief Append string representation of "num" at the end of string * \details Example: \snippet pistring.cpp PIString::<<(int) */ PIString & operator <<(const long & num) {*this += PIString::fromNumber(num); return *this;} PIString & operator <<(const ulong & num) {*this += PIString::fromNumber(num); return *this;} @@ -181,101 +181,101 @@ public: PIString & operator <<(const llong & num) {*this += PIString::fromNumber(num); return *this;} PIString & operator <<(const ullong & num) {*this += PIString::fromNumber(num); return *this;} - /*! @brief Append string representation of "num" at the end of string + /*! \brief Append string representation of "num" at the end of string * \details Example: \snippet pistring.cpp PIString::<<(int) */ PIString & operator <<(const float & num) {*this += PIString::fromNumber(num); return *this;} - /*! @brief Append string representation of "num" at the end of string + /*! \brief Append string representation of "num" at the end of string * \details Example: \snippet pistring.cpp PIString::<<(int) */ PIString & operator <<(const double & num) {*this += PIString::fromNumber(num); return *this;} - //! @brief Insert string "str" at the begin of string + //! \brief Insert string "str" at the begin of string PIString & prepend(const PIString & str) {insert(0, str); return *this;} - //! @brief Insert string "str" at the end of string + //! \brief Insert string "str" at the end of string PIString & append(const PIString & str) {*this += str; return *this;} - /*! @brief Return part of string from symbol at index "start" and maximum length "len" + /*! \brief Return part of string from symbol at index "start" and maximum length "len" * \details All variants demonstrated in example: \snippet pistring.cpp PIString::mid * \sa \a left(), \a right() */ PIString mid(const int start, const int len = -1) const; - /*! @brief Return sub-string of string from symbol at index "start" and maximum length "len" */ + /*! \brief Return sub-string of string from symbol at index "start" and maximum length "len" */ PIString subString(const int start, const int len = -1) const {return mid(start, len);} - /*! @brief Return part of string from left and maximum length "len" + /*! \brief Return part of string from left and maximum length "len" * \details Example: \snippet pistring.cpp PIString::left * \sa \a mid(), \a right() */ PIString left(const int len) const {return len <= 0 ? PIString() : mid(0, len);} - /*! @brief Return part of string from right and maximum length "len" + /*! \brief Return part of string from right and maximum length "len" * \details Example: \snippet pistring.cpp PIString::right * \sa \a mid(), \a left() */ PIString right(const int len) const {return len <= 0 ? PIString() : mid(size() - len, len);} - /*! @brief Remove part of string from symbol as index "start" and maximum length "len" + /*! \brief Remove part of string from symbol as index "start" and maximum length "len" * and return this string * \details All variants demonstrated in example: \snippet pistring.cpp PIString::cutMid * \sa \a cutLeft(), \a cutRight() */ PIString & cutMid(const int start, const int len); - /*! @brief Remove part of string from left and maximum length "len" and return this string + /*! \brief Remove part of string from left and maximum length "len" and return this string * \details Example: \snippet pistring.cpp PIString::cutLeft * \sa \a cutMid(), \a cutRight() */ PIString & cutLeft(const int len) {return len <= 0 ? *this : cutMid(0, len);} - /*! @brief Remove part of string from right and maximum length "len" and return this string + /*! \brief Remove part of string from right and maximum length "len" and return this string * \details Example: \snippet pistring.cpp PIString::cutRight * \sa \a cutMid(), \a cutLeft() */ PIString & cutRight(const int len) {return len <= 0 ? *this : cutMid(size() - len, len);} - /*! @brief Remove spaces at the start and at the end of string and return this string + /*! \brief Remove spaces at the start and at the end of string and return this string * \details Example: \snippet pistring.cpp PIString::trim * \sa \a trimmed() */ PIString & trim(); - /*! @brief Return copy of this string without spaces at the start and at the end + /*! \brief Return copy of this string without spaces at the start and at the end * \details Example: \snippet pistring.cpp PIString::trimmed * \sa \a trim() */ PIString trimmed() const; - /*! @brief Replace part of string from index "from" and maximum length "len" + /*! \brief Replace part of string from index "from" and maximum length "len" * with string "with" and return this string * \details Example: \snippet pistring.cpp PIString::replace_0 * \sa \a replaced(), \a replaceAll() */ PIString & replace(const int from, const int count, const PIString & with); - /*! @brief Replace part copy of this string from index "from" and maximum length "len" + /*! \brief Replace part copy of this string from index "from" and maximum length "len" * with string "with" and return copied string * \details Example: \snippet pistring.cpp PIString::replaced_0 * \sa \a replace(), \a replaceAll() */ PIString replaced(const int from, const int count, const PIString & with) const {PIString str(*this); str.replace(from, count, with); return str;} - /*! @brief Replace first founded substring "what" with string "with" and return this string + /*! \brief Replace first founded substring "what" with string "with" and return this string * \details If "ok" is not null, it set to "true" if something was replaced\n * Example: \snippet pistring.cpp PIString::replace_1 * \sa \a replaced(), \a replaceAll() */ PIString & replace(const PIString & what, const PIString & with, bool * ok = 0); - /*! @brief Replace first founded substring "what" with string "with" and return copied string + /*! \brief Replace first founded substring "what" with string "with" and return copied string * \details If "ok" is not null, it set to "true" if something was replaced\n * Example: \snippet pistring.cpp PIString::replaced_1 * \sa \a replaced(), \a replaceAll() */ PIString replaced(const PIString & what, const PIString & with, bool * ok = 0) const {PIString str(*this); str.replace(what, with, ok); return str;} - /*! @brief Replace all founded substrings "what" with strings "with" and return this string + /*! \brief Replace all founded substrings "what" with strings "with" and return this string * \details Example: \snippet pistring.cpp PIString::replaceAll * \sa \a replace(), \a replaced() */ PIString & replaceAll(const PIString & what, const PIString & with); - /*! @brief Replace all founded substrings "what" with symbol "with" and return this string + /*! \brief Replace all founded substrings "what" with symbol "with" and return this string * \details Example: \snippet pistring.cpp PIString::replaceAll * \sa \a replace(), \a replaced() */ PIString & replaceAll(const PIString & what, const char with); - /*! @brief Replace all founded symbols "what" with symbol "with" and return this string + /*! \brief Replace all founded symbols "what" with symbol "with" and return this string * \details Example: \snippet pistring.cpp PIString::replaceAll * \sa \a replace(), \a replaced() */ PIString & replaceAll(const char what, const char with); @@ -288,119 +288,119 @@ public: PIString & removeAll(char c) {PIDeque::removeAll(PIChar(c)); return *this;} - /*! @brief Repeat content of string "times" times and return this string + /*! \brief Repeat content of string "times" times and return this string * \details Example: \snippet pistring.cpp PIString::repeat */ PIString & repeat(int times) {PIString ss(*this); times--; piForTimes (times) *this += ss; return *this;} - /*! @brief Returns repeated "times" times string + /*! \brief Returns repeated "times" times string * \details Example: \snippet pistring.cpp PIString::repeated */ PIString repeated(int times) const {PIString ss(*this); return ss.repeat(times);} - /*! @brief Insert symbol "c" after index "index" and return this string + /*! \brief Insert symbol "c" after index "index" and return this string * \details Example: \snippet pistring.cpp PIString::insert_0 */ PIString & insert(const int index, const PIChar c) {PIDeque::insert(index, c); return *this;} - /*! @brief Insert symbol "c" after index "index" and return this string + /*! \brief Insert symbol "c" after index "index" and return this string * \details Example: \snippet pistring.cpp PIString::insert_1 */ PIString & insert(const int index, const char c) {return insert(index, PIChar(c));} - /*! @brief Insert string "str" after index "index" and return this string + /*! \brief Insert string "str" after index "index" and return this string * \details Example: \snippet pistring.cpp PIString::insert_2 */ PIString & insert(const int index, const PIString & str); - /*! @brief Insert string "str" after index "index" and return this string + /*! \brief Insert string "str" after index "index" and return this string * \details Example: \snippet pistring.cpp PIString::insert_2 */ PIString & insert(const int index, const char * c) {return insert(index, PIString(c));} - /*! @brief Enlarge string to length "len" by addition sequence of symbols + /*! \brief Enlarge string to length "len" by addition sequence of symbols * "c" at the end of string, and return this string * \details Example: \snippet pistring.cpp PIString::expandRightTo * \sa \a expandLeftTo() */ PIString & expandRightTo(const int len, const PIChar c) {if (len > length()) resize(len, c); return *this;} - /*! @brief Enlarge string to length "len" by addition sequence of symbols + /*! \brief Enlarge string to length "len" by addition sequence of symbols * "c" at the beginning of string, and return this string * \details Example: \snippet pistring.cpp PIString::expandLeftTo * \sa \a expandRightTo() */ PIString & expandLeftTo(const int len, const PIChar c) {if (len > length()) insert(0, PIString(len - length(), c)); return *this;} - /*! @brief Enlarge and returns copy of this string to length "len" + /*! \brief Enlarge and returns copy of this string to length "len" * by addition sequence of symbols "c" at the end of string * \sa \a expandRightTo() */ PIString expandedRightTo(const int len, const PIChar c) const {return PIString(*this).expandRightTo(len, c);} - /*! @brief Enlarge and returns copy of this string to length "len" + /*! \brief Enlarge and returns copy of this string to length "len" * by addition sequence of symbols "c" at the beginning of string * \sa \a expandLeftTo() */ PIString expandedLeftTo(const int len, const PIChar c) const {return PIString(*this).expandLeftTo(len, c);} - /*! @brief Add "c" symbols at the beginning and end of the string, and return this string + /*! \brief Add "c" symbols at the beginning and end of the string, and return this string * \sa \a quoted() */ PIString & quote(PIChar c = PIChar('"')) {insert(0, c); *this += c; return *this;} - /*! @brief Return quoted copy of this string + /*! \brief Return quoted copy of this string * \sa \a quote() */ PIString quoted(PIChar c = PIChar('"')) {return PIString(*this).quote(c);} - /*! @brief Reverse string and return this string + /*! \brief Reverse string and return this string * \details Example: \snippet pistring.cpp PIString::reverse * \sa \a reversed() */ PIString & reverse() {PIString str(*this); clear(); piForeachCR (PIChar c, str) push_back(c); return *this;} - /*! @brief Reverse copy of this string and return it + /*! \brief Reverse copy of this string and return it * \details Example: \snippet pistring.cpp PIString::reversed * \sa \a reverse() */ PIString reversed() const {PIString str(*this); str.reverse(); return str;} - /*! @brief Elide string to maximum size \"size\" and return this string + /*! \brief Elide string to maximum size \"size\" and return this string * \sa \a elided() */ PIString & elide(int size, float pos = ElideCenter); - /*! @brief Elide copy of this string to maximum size \"size\" and return it + /*! \brief Elide copy of this string to maximum size \"size\" and return it * \details Example: \snippet pistring.cpp PIString::elided * \sa \a elide() */ PIString elided(int size, float pos = ElideCenter) const {PIString str(*this); str.elide(size, pos); return str;} - /*! @brief Take a part of string from symbol at index "start" and maximum length "len" and return it + /*! \brief Take a part of string from symbol at index "start" and maximum length "len" and return it * \sa \a takeLeft, \a takeRight() */ PIString takeMid(const int start, const int len = -1) {PIString ret(mid(start, len)); cutMid(start, len); return ret;} - /*! @brief Take a part from the begin of string with maximum length "len" and return it + /*! \brief Take a part from the begin of string with maximum length "len" and return it * \sa \a takeMid(), \a takeRight() */ PIString takeLeft(const int len) {PIString ret(left(len)); cutLeft(len); return ret;} - /*! @brief Take a part from the end of string with maximum length "len" and return it + /*! \brief Take a part from the end of string with maximum length "len" and return it * \sa \a takeMid(), \a takeLeft() */ PIString takeRight(const int len) {PIString ret(right(len)); cutRight(len); return ret;} - /*! @brief Take a symbol from the begin of this string and return it + /*! \brief Take a symbol from the begin of this string and return it * \details Example: \snippet pistring.cpp PIString::takeSymbol * \sa \a takeWord(), \a takeCWord(), \a takeLine(), \a takeNumber(), \a takeRange() */ PIString takeSymbol(); - /*! @brief Take a word from the begin of this string and return it + /*! \brief Take a word from the begin of this string and return it * \details Example: \snippet pistring.cpp PIString::takeWord * \sa \a takeSymbol(), \a takeCWord(), \a takeLine(), \a takeNumber(), \a takeRange() */ PIString takeWord(); - /*! @brief Take a word with letters, numbers and '_' symbols from the + /*! \brief Take a word with letters, numbers and '_' symbols from the * begin of this string and return it * \details Example: \snippet pistring.cpp PIString::takeCWord * \sa \a takeSymbol(), \a takeWord(), \a takeLine(), \a takeNumber(), \a takeRange() */ PIString takeCWord(); - /*! @brief Take a line from the begin of this string and return it + /*! \brief Take a line from the begin of this string and return it * \details Example: \snippet pistring.cpp PIString::takeLine * \sa \a takeSymbol(), \a takeWord(), \a takeCWord(), \a takeNumber(), \a takeRange() */ PIString takeLine(); - /*! @brief Take a number with C-format from the begin of this string and return it + /*! \brief Take a number with C-format from the begin of this string and return it * \details Example: \snippet pistring.cpp PIString::takeNumber * \sa \a takeSymbol(), \a takeWord(), \a takeCWord(), \a takeLine(), \a takeRange() */ PIString takeNumber(); - /*! @brief Take a range between "start" and "end" symbols from the begin of this + /*! \brief Take a range between "start" and "end" symbols from the begin of this * string and return it. * \details "Shield" symbol prevent analysis of the next symbol. * Example: \snippet pistring.cpp PIString::takeRange @@ -408,19 +408,19 @@ public: PIString takeRange(const PIChar start, const PIChar end, const PIChar shield = '\\'); - /*! @brief Return a string in brackets "start" and "end" symbols from the begin of this + /*! \brief Return a string in brackets "start" and "end" symbols from the begin of this * string and return it. * \details Example: string = "a(b(c)d)e"; inBrackets('(', ')') = "b(c)d"; */ PIString inBrackets(const PIChar start, const PIChar end) const; - /*! @brief Return real bytes count of this string + /*! \brief Return real bytes count of this string * \details It`s equivalent length of char sequence * returned by function \a data() - 1, without terminating null-char \n * Example: \snippet pistring.cpp PIString::lengthAscii * \sa \a data() */ int lengthAscii() const {buildData(__syslocname__); return data_.size_s() - 1;} - /*! @brief Return \c char * representation of this string in system codepage + /*! \brief Return \c char * representation of this string in system codepage * \details This function fill buffer by sequence * of chars. Minimum length of this buffer is count * of symbols. Returned \c char * is valid until next @@ -429,7 +429,7 @@ public: * \sa \a dataConsole(), \a dataUTF8() */ const char * data() const {buildData(__syslocname__); return (const char *)(data_.data());} - /*! @brief Return \c char * representation of this string in terminal codepage + /*! \brief Return \c char * representation of this string in terminal codepage * \details This function fill buffer by sequence * of chars. Minimum length of this buffer is count * of symbols. Returned \c char * is valid until next @@ -437,7 +437,7 @@ public: * \sa \a data(), \a dataUTF8() */ const char * dataConsole() const; - /*! @brief Return \c char * representation of this string in UTF-8 + /*! \brief Return \c char * representation of this string in UTF-8 * \details This function fill buffer by sequence * of chars. Minimum length of this buffer is count * of symbols. Returned \c char * is valid until next @@ -445,7 +445,7 @@ public: * \sa \a data(), \a dataConsole() */ const char * dataUTF8() const; - /*! @brief Return \c char * representation of this string in ASCII + /*! \brief Return \c char * representation of this string in ASCII * \details This function fill buffer by sequence * of chars. Minimum length of this buffer is count * of symbols. Returned \c char * is valid until next @@ -455,277 +455,277 @@ public: //! Returns hash uint hash() const; - //! @brief Return \a PIByteArray contains \a data() of this string without terminating null-char + //! \brief Return \a PIByteArray contains \a data() of this string without terminating null-char PIByteArray toByteArray() const {buildData(__utf8name__); return data_.resized(data_.size_s() - 1);} - //! @brief Return \a PIByteArray contains UTF-8 \a data() of this string without terminating null-char + //! \brief Return \a PIByteArray contains UTF-8 \a data() of this string without terminating null-char PIByteArray toUTF8() const; - //! @brief Return \a PIByteArray contains custom charset representation of this string without terminating null-char + //! \brief Return \a PIByteArray contains custom charset representation of this string without terminating null-char PIByteArray toCharset(const char * c) const; - /*! @brief Split string with delimiter "delim" to \a PIStringList and return it + /*! \brief Split string with delimiter "delim" to \a PIStringList and return it * \details Example: \snippet pistring.cpp PIString::split */ PIStringList split(const PIString & delim) const; - //! @brief Convert each symbol in copyed string to upper case and return it + //! \brief Convert each symbol in copyed string to upper case and return it PIString toUpperCase() const; - //! @brief Convert each symbol in copyed string to lower case and return it + //! \brief Convert each symbol in copyed string to lower case and return it PIString toLowerCase() const; PIString toNativeDecimalPoints() const; - //! @brief Returns if string contains "c" + //! \brief Returns if string contains "c" bool contains(const char c) const {return PIDeque::contains(PIChar(c));} - //! @brief Returns if string contains "str" + //! \brief Returns if string contains "str" bool contains(const char * str) const {return contains(PIString(str));} - //! @brief Returns if string contains "str" + //! \brief Returns if string contains "str" bool contains(const PIString & str) const {return find(str) >= 0;} - //! @brief Search symbol "c" from symbol at index "start" and return first occur position + //! \brief Search symbol "c" from symbol at index "start" and return first occur position //! \details Example: \snippet pistring.cpp PIString::find int find(const char c, const int start = 0) const; - //! @brief Search substring "str" from symbol at index "start" and return first occur position + //! \brief Search substring "str" from symbol at index "start" and return first occur position //! \details Example: \snippet pistring.cpp PIString::find int find(const PIString & str, const int start = 0) const; - //! @brief Search substring "str" from symbol at index "start" and return first occur position + //! \brief Search substring "str" from symbol at index "start" and return first occur position //! \details Example: \snippet pistring.cpp PIString::find int find(const char * str, const int start = 0) const {return find(PIString(str), start);} - //! @brief Search symbol "c" from symbol at index "start" and return last occur position + //! \brief Search symbol "c" from symbol at index "start" and return last occur position //! \details Example: \snippet pistring.cpp PIString::findLast int findLast(const char c, const int start = 0) const; - //! @brief Search substring "str" from symbol at index "start" and return last occur position + //! \brief Search substring "str" from symbol at index "start" and return last occur position //! \details Example: \snippet pistring.cpp PIString::findLast int findLast(const PIString & str, const int start = 0) const; - //! @brief Search substring "str" from symbol at index "start" and return last occur position + //! \brief Search substring "str" from symbol at index "start" and return last occur position //! \details Example: \snippet pistring.cpp PIString::findLast int findLast(const char * str, const int start = 0) const {return findLast(PIString(str), start);} - //! @brief Search word "word" from symbol at index "start" and return first occur position. + //! \brief Search word "word" from symbol at index "start" and return first occur position. //! \details Example: \snippet pistring.cpp PIString::findWord int findWord(const PIString & word, const int start = 0) const; - //! @brief Search C-style word "word" from symbol at index "start" and return first occur position. + //! \brief Search C-style word "word" from symbol at index "start" and return first occur position. //! \details Example: \snippet pistring.cpp PIString::findCWord int findCWord(const PIString & word, const int start = 0) const; - //! @brief Search range between "start" and "end" symbols at index "start_index" and return first occur position. + //! \brief Search range between "start" and "end" symbols at index "start_index" and return first occur position. //! \details Example: \snippet pistring.cpp PIString::findRange int findRange(const PIChar start, const PIChar end, const PIChar shield = '\\', const int start_index = 0, int * len = 0) const; - //! @brief Search any symbol of "str" from symbol at index "start" and return first occur position + //! \brief Search any symbol of "str" from symbol at index "start" and return first occur position //! \details Example: \snippet pistring.cpp PIString::findAny int findAny(const PIString & str, const int start = 0) const; - //! @brief Search any symbol of "str" from symbol at index "start" and return first occur position + //! \brief Search any symbol of "str" from symbol at index "start" and return first occur position //! \details Example: \snippet pistring.cpp PIString::findAny int findAny(const char * str, const int start = 0) const {return findAny(PIString(str), start);} - //! @brief Search any symbol of "str" from symbol at index "start" and return last occur position + //! \brief Search any symbol of "str" from symbol at index "start" and return last occur position //! \details Example: \snippet pistring.cpp PIString::findAnyLast int findAnyLast(const PIString & str, const int start = 0) const; - //! @brief Search any symbol of "str" from symbol at index "start" and return last occur position + //! \brief Search any symbol of "str" from symbol at index "start" and return last occur position //! \details Example: \snippet pistring.cpp PIString::findAnyLast int findAnyLast(const char * str, const int start = 0) const {return findAnyLast(PIString(str), start);} - //! @brief Returns number of occurrences of symbol "c" + //! \brief Returns number of occurrences of symbol "c" int entries(const PIChar c) const; - //! @brief Returns number of occurrences of symbol "c" + //! \brief Returns number of occurrences of symbol "c" int entries(char c) const {return entries(PIChar(c));} - //! @brief Return if string starts with "str" + //! \brief Return if string starts with "str" bool startsWith(const PIString & str) const; - //! @brief Return if string ends with "str" + //! \brief Return if string ends with "str" bool endsWith(const PIString & str) const; - //! @brief Return symbols length of string + //! \brief Return symbols length of string int length() const {return size();} - //! @brief Return \c true if string is empty, i.e. length = 0 + //! \brief Return \c true if string is empty, i.e. length = 0 bool isEmpty() const {return (size() == 0 || *this == "");} - //! @brief Return \c true if string equal "true", "yes", "on" or positive not null numeric value + //! \brief Return \c true if string equal "true", "yes", "on" or positive not null numeric value bool toBool() const; - //! @brief Return \c char numeric value of string + //! \brief Return \c char numeric value of string char toChar() const; - //! @brief Return \c short numeric value of string in base "base" + //! \brief Return \c short numeric value of string in base "base" //! \details Example: \snippet pistring.cpp PIString::toNumber short toShort(int base = -1, bool * ok = 0) const {return short(toNumberBase(*this, base, ok));} - //! @brief Return \c ushort numeric value of string in base "base" + //! \brief Return \c ushort numeric value of string in base "base" //! \details Example: \snippet pistring.cpp PIString::toNumber ushort toUShort(int base = -1, bool * ok = 0) const {return ushort(toNumberBase(*this, base, ok));} - //! @brief Return \c int numeric value of string in base "base" + //! \brief Return \c int numeric value of string in base "base" //! \details Example: \snippet pistring.cpp PIString::toNumber int toInt(int base = -1, bool * ok = 0) const {return int(toNumberBase(*this, base, ok));} - //! @brief Return \c uint numeric value of string in base "base" + //! \brief Return \c uint numeric value of string in base "base" //! \details Example: \snippet pistring.cpp PIString::toNumber uint toUInt(int base = -1, bool * ok = 0) const {return uint(toNumberBase(*this, base, ok));} - //! @brief Return \c long numeric value of string in base "base" + //! \brief Return \c long numeric value of string in base "base" //! \details Example: \snippet pistring.cpp PIString::toNumber long toLong(int base = -1, bool * ok = 0) const {return long(toNumberBase(*this, base, ok));} - //! @brief Return \c ulong numeric value of string in base "base" + //! \brief Return \c ulong numeric value of string in base "base" //! \details Example: \snippet pistring.cpp PIString::toNumber ulong toULong(int base = -1, bool * ok = 0) const {return ulong(toNumberBase(*this, base, ok));} - //! @brief Return \c llong numeric value of string in base "base" + //! \brief Return \c llong numeric value of string in base "base" //! \details Example: \snippet pistring.cpp PIString::toNumber llong toLLong(int base = -1, bool * ok = 0) const {return toNumberBase(*this, base, ok);} - //! @brief Return \c ullong numeric value of string in base "base" + //! \brief Return \c ullong numeric value of string in base "base" //! \details Example: \snippet pistring.cpp PIString::toNumber ullong toULLong(int base = -1, bool * ok = 0) const {return ullong(toNumberBase(*this, base, ok));} - //! @brief Return \c float numeric value of string + //! \brief Return \c float numeric value of string //! \details Example: \snippet pistring.cpp PIString::toFloat float toFloat() const; - //! @brief Return \c double numeric value of string + //! \brief Return \c double numeric value of string //! \details Example: \snippet pistring.cpp PIString::toFloat double toDouble() const; - //! @brief Return \c ldouble numeric value of string + //! \brief Return \c ldouble numeric value of string //! \details Example: \snippet pistring.cpp PIString::toFloat ldouble toLDouble() const; - //! @brief Set string content to numeric representation of "value" in base "base" + //! \brief Set string content to numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::setNumber PIString & setNumber(const short value, int base = 10, bool * ok = 0) {clear(); *this += PIString::fromNumber(value, base, ok); return *this;} - //! @brief Set string content to numeric representation of "value" in base "base" + //! \brief Set string content to numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::setNumber PIString & setNumber(const ushort value, int base = 10, bool * ok = 0) {clear(); *this += PIString::fromNumber(value, base, ok); return *this;} - //! @brief Set string content to numeric representation of "value" in base "base" + //! \brief Set string content to numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::setNumber PIString & setNumber(const int value, int base = 10, bool * ok = 0) {clear(); *this += PIString::fromNumber(value, base, ok); return *this;} - //! @brief Set string content to numeric representation of "value" in base "base" + //! \brief Set string content to numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::setNumber PIString & setNumber(const uint value, int base = 10, bool * ok = 0) {clear(); *this += PIString::fromNumber(value, base, ok); return *this;} - //! @brief Set string content to numeric representation of "value" in base "base" + //! \brief Set string content to numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::setNumber PIString & setNumber(const long value, int base = 10, bool * ok = 0) {clear(); *this += PIString::fromNumber(value, base, ok); return *this;} - //! @brief Set string content to numeric representation of "value" in base "base" + //! \brief Set string content to numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::setNumber PIString & setNumber(const ulong value, int base = 10, bool * ok = 0) {clear(); *this += PIString::fromNumber(value, base, ok); return *this;} - //! @brief Set string content to numeric representation of "value" in base "base" + //! \brief Set string content to numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::setNumber PIString & setNumber(const llong & value, int base = 10, bool * ok = 0) {clear(); *this += PIString::fromNumber(value, base, ok); return *this;} - //! @brief Set string content to numeric representation of "value" in base "base" + //! \brief Set string content to numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::setNumber PIString & setNumber(const ullong & value, int base = 10, bool * ok = 0) {clear(); *this += PIString::fromNumber(value, base, ok); return *this;} - //! @brief Set string content to numeric representation of "value" + //! \brief Set string content to numeric representation of "value" //! \details Example: \snippet pistring.cpp PIString::setFloat PIString & setNumber(const float value, char format = 'f', int precision = 8) {clear(); *this += PIString::fromNumber(value, format, precision); return *this;} - //! @brief Set string content to numeric representation of "value" + //! \brief Set string content to numeric representation of "value" //! \details Example: \snippet pistring.cpp PIString::setFloat PIString & setNumber(const double & value, char format = 'f', int precision = 8) {clear(); *this += PIString::fromNumber(value, format, precision); return *this;} - //! @brief Set string content to numeric representation of "value" + //! \brief Set string content to numeric representation of "value" //! \details Example: \snippet pistring.cpp PIString::setFloat PIString & setNumber(const ldouble & value, char format = 'f', int precision = 8) {clear(); *this += PIString::fromNumber(value, format, precision); return *this;} - //! @brief Set string content to human readable size in B/kB/MB/GB/TB + //! \brief Set string content to human readable size in B/kB/MB/GB/TB //! \details Example: \snippet pistring.cpp PIString::setReadableSize PIString & setReadableSize(llong bytes); - //! @brief Return string contains numeric representation of "value" in base "base" + //! \brief Return string contains numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::fromNumber static PIString fromNumber(const short value, int base = 10, bool * ok = 0) {return fromNumberBaseS(llong(value), base, ok);} - //! @brief Return string contains numeric representation of "value" in base "base" + //! \brief Return string contains numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::fromNumber static PIString fromNumber(const ushort value, int base = 10, bool * ok = 0) {return fromNumberBaseU(ullong(value), base, ok);} - //! @brief Return string contains numeric representation of "value" in base "base" + //! \brief Return string contains numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::fromNumber static PIString fromNumber(const int value, int base = 10, bool * ok = 0) {return fromNumberBaseS(llong(value), base, ok);} - //! @brief Return string contains numeric representation of "value" in base "base" + //! \brief Return string contains numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::fromNumber static PIString fromNumber(const uint value, int base = 10, bool * ok = 0) {return fromNumberBaseU(ullong(value), base, ok);} - //! @brief Return string contains numeric representation of "value" in base "base" + //! \brief Return string contains numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::fromNumber static PIString fromNumber(const long value, int base = 10, bool * ok = 0) {return fromNumberBaseS(llong(value), base, ok);} - //! @brief Return string contains numeric representation of "value" in base "base" + //! \brief Return string contains numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::fromNumber static PIString fromNumber(const ulong value, int base = 10, bool * ok = 0) {return fromNumberBaseU(ullong(value), base, ok);} - //! @brief Return string contains numeric representation of "value" in base "base" + //! \brief Return string contains numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::fromNumber static PIString fromNumber(const llong & value, int base = 10, bool * ok = 0) {return fromNumberBaseS(value, base, ok);} - //! @brief Return string contains numeric representation of "value" in base "base" + //! \brief Return string contains numeric representation of "value" in base "base" //! \details Example: \snippet pistring.cpp PIString::fromNumber static PIString fromNumber(const ullong & value, int base = 10, bool * ok = 0) {return fromNumberBaseU(value, base, ok);} - //! @brief Return string contains numeric representation of "value" + //! \brief Return string contains numeric representation of "value" //! \details Example: \snippet pistring.cpp PIString::fromFloat static PIString fromNumber(const float value, char format = 'f', int precision = 8) {return ftos(value, format, precision);} - //! @brief Return string contains numeric representation of "value" + //! \brief Return string contains numeric representation of "value" //! \details Example: \snippet pistring.cpp PIString::fromFloat static PIString fromNumber(const double & value, char format = 'f', int precision = 8) {return dtos(value, format, precision);} - //! @brief Return string contains numeric representation of "value" + //! \brief Return string contains numeric representation of "value" //! \details Example: \snippet pistring.cpp PIString::fromFloat static PIString fromNumber(const ldouble & value, char format = 'f', int precision = 8) {return dtos(value, format, precision);} - //! @brief Return "true" or "false" + //! \brief Return "true" or "false" static PIString fromBool(const bool value) {return PIString(value ? "true" : "false");} - //! @brief Return string constructed from terminal codepage + //! \brief Return string constructed from terminal codepage static PIString fromConsole(const char * s); - //! @brief Return string constructed from system codepage + //! \brief Return string constructed from system codepage static PIString fromSystem(const char * s); - //! @brief Return string constructed from UTF-8 + //! \brief Return string constructed from UTF-8 static PIString fromUTF8(const char * s); - //! @brief Return string constructed from UTF-8 + //! \brief Return string constructed from UTF-8 static PIString fromUTF8(const PIByteArray &ba); - //! @brief Return string constructed from ASCII + //! \brief Return string constructed from ASCII static PIString fromAscii(const char * s); - //! @brief Return string constructed from "len" chars ASCII + //! \brief Return string constructed from "len" chars ASCII static PIString fromAscii(const char * s, int len); - //! @brief Return string constructed from "c" codepage + //! \brief Return string constructed from "c" codepage static PIString fromCodepage(const char * s, const char * c); - //! @brief Return string contains human readable size in B/kB/MB/GB/TB + //! \brief Return string contains human readable size in B/kB/MB/GB/TB //! \details Example: \snippet pistring.cpp PIString::readableSize static PIString readableSize(llong bytes); @@ -751,30 +751,30 @@ private: }; -//! \relatesalso PICout @brief Output operator to PICout +//! \relatesalso PICout \brief Output operator to PICout PIP_EXPORT PICout operator <<(PICout s, const PIString & v); -//! \relatesalso PIByteArray @brief Output operator to PIByteArray +//! \relatesalso PIByteArray \brief Output operator to PIByteArray inline PIByteArray & operator <<(PIByteArray & s, const PIString & v) {s << *(PIDeque*)&v; return s;} -//! \relatesalso PIByteArray @brief Input operator from PIByteArray +//! \relatesalso PIByteArray \brief Input operator from PIByteArray inline PIByteArray & operator >>(PIByteArray & s, PIString & v) {v.clear(); s >> *(PIDeque*)&v; return s;} -//! @brief Return concatenated string +//! \brief Return concatenated string inline PIString operator +(const PIString & str, const PIString & f) {PIString s(str); s += f; return s;} -//! @brief Return concatenated string +//! \brief Return concatenated string inline PIString operator +(const PIString & f, const char * str) {PIString s(f); s += str; return s;} -//! @brief Return concatenated string +//! \brief Return concatenated string inline PIString operator +(const char * str, const PIString & f) {return PIString(str) + f;} -//! \relatesalso PIString @brief Return concatenated string +//! \relatesalso PIString \brief Return concatenated string inline PIString operator +(const char c, const PIString & f) {return PIChar(c) + f;} -//! @brief Return concatenated string +//! \brief Return concatenated string inline PIString operator +(const PIString & f, const char c) {return f + PIChar(c);} diff --git a/libs/main/core/pistring_std.h b/libs/main/core/pistring_std.h index 42ec80cf..909c5348 100644 --- a/libs/main/core/pistring_std.h +++ b/libs/main/core/pistring_std.h @@ -1,5 +1,5 @@ -/*! @file pistring_std.h - * @brief STD for PIString +/*! \file pistring_std.h + * \brief STD for PIString * * This file declare std operators and string conversions */ @@ -70,24 +70,24 @@ inline PIString StdWString2PIString(const std::wstring & v) { -//! \relatesalso PIChar @brief Output operator to \c std::ostream +//! \relatesalso PIChar \brief Output operator to \c std::ostream inline std::ostream & operator <<(std::ostream & s, const PIChar & v) {s << v.toCharPtr(); return s;} -//! \relatesalso PIString @brief Return concatenated string +//! \relatesalso PIString \brief Return concatenated string inline PIString operator +(const PIString & f, const std::string & str) {PIString s(f); s += StdString2PIString(str); return s;} -//! \relatesalso PIString @brief Return concatenated string +//! \relatesalso PIString \brief Return concatenated string inline PIString operator +(const std::string & str, const PIString & f) {return StdString2PIString(str) + f;} -//! \relatesalso PIString @brief Output operator to std::ostream (cout) +//! \relatesalso PIString \brief Output operator to std::ostream (cout) inline std::ostream & operator <<(std::ostream & s, const PIString & v) {for (int i = 0; i < v.length(); ++i) s << v[i]; return s;} -//! \relatesalso PIString @brief Input operator from std::istream (cin) +//! \relatesalso PIString \brief Input operator from std::istream (cin) inline std::istream & operator >>(std::istream & s, PIString & v) {std::string ss; s >> ss; v = StdString2PIString(ss); return s;} -//! \relatesalso PIStringList @brief Output operator to std::ostream (cout) +//! \relatesalso PIStringList \brief Output operator to std::ostream (cout) inline std::ostream & operator <<(std::ostream & s, const PIStringList & v) { s << PIChar("{"); for (uint i = 0; i < v.size(); ++i) { diff --git a/libs/main/core/pistringlist.h b/libs/main/core/pistringlist.h index 5b9d1a67..0c63f2e8 100644 --- a/libs/main/core/pistringlist.h +++ b/libs/main/core/pistringlist.h @@ -1,4 +1,4 @@ -/*! @brief Strings array class +/*! \brief Strings array class * \details This class is based on \a PIDeque and * expand it functionality. */ /* @@ -60,22 +60,22 @@ public: PIStringList(std::initializer_list init_list): PIDeque(init_list) {} - //! @brief Join all strings in one with delimiter "delim" and return it + //! \brief Join all strings in one with delimiter "delim" and return it //! \details Example: \snippet pistring.cpp PIStringList::join PIString join(const PIString & delim) const {PIString s; for (uint i = 0; i < size(); ++i) {s += at(i); if (i < size() - 1) s += delim;} return s;} - //! @brief Remove all strings equal "value" and return this + //! \brief Remove all strings equal "value" and return this //! \details Example: \snippet pistring.cpp PIStringList::removeStrings PIStringList & removeStrings(const PIString & value) {for (uint i = 0; i < size(); ++i) {if (at(i) == value) {remove(i); --i;}} return *this;} PIStringList & remove(uint num) {PIDeque::remove(num); return *this;} PIStringList & remove(uint num, uint count) {PIDeque::remove(num, count); return *this;} - //! @brief Remove duplicated strings and return this + //! \brief Remove duplicated strings and return this //! \details Example: \snippet pistring.cpp PIStringList::removeDuplicates PIStringList & removeDuplicates(); - //! @brief Trim all strings + //! \brief Trim all strings //! \details Example: \snippet pistring.cpp PIString::trim PIStringList & trim() {for (uint i = 0; i < size(); ++i) (*this)[i].trim(); return *this;} @@ -97,13 +97,13 @@ public: }; -//! \relatesalso PIByteArray @brief Output operator to PIByteArray +//! \relatesalso PIByteArray \brief Output operator to PIByteArray inline PIByteArray & operator <<(PIByteArray & s, const PIStringList & v) {s << int(v.size_s()); for (int i = 0; i < v.size_s(); ++i) s << v[i]; return s;} -//! relatesalso PIByteArray @brief Input operator from PIByteArray +//! relatesalso PIByteArray \brief Input operator from PIByteArray inline PIByteArray & operator >>(PIByteArray & s, PIStringList & v) {int sz; s >> sz; v.resize(sz); for (int i = 0; i < sz; ++i) s >> v[i]; return s;} -//! \relatesalso PICout @brief Output operator to PICout +//! \relatesalso PICout \brief Output operator to PICout inline PICout operator <<(PICout s, const PIStringList & v) {s.space(); s.setControl(0, true); s << "{"; for (uint i = 0; i < v.size(); ++i) {s << "\"" << v[i] << "\""; if (i < v.size() - 1) s << ", ";} s << "}"; s.restoreControl(); return s;} #endif // PISTRINGLIST_H diff --git a/libs/main/core/pitime.cpp b/libs/main/core/pitime.cpp index 7cc9123c..fd7ad116 100644 --- a/libs/main/core/pitime.cpp +++ b/libs/main/core/pitime.cpp @@ -40,7 +40,7 @@ #endif /*! \class PISystemTime - * @brief System time + * \brief System time * * \section PISystemTime_sec0 Synopsis * This class provide arithmetic functions for POSIX system time. @@ -54,7 +54,7 @@ /*! \class PITimeMeasurer - * @brief Time measurements + * \brief Time measurements * * \section PITimeMeasurer_sec0 Synopsis * Function \a reset() set time mark to current diff --git a/libs/main/core/pitime.h b/libs/main/core/pitime.h index 316811ed..0979e5f1 100644 --- a/libs/main/core/pitime.h +++ b/libs/main/core/pitime.h @@ -1,5 +1,5 @@ -/*! @file pitime.h - * @brief Time structs +/*! \file pitime.h + * \brief Time structs */ /* PIP - Platform Independent Primitives @@ -30,7 +30,7 @@ # include #endif -/*! @brief Precise sleep for "usecs" microseconds +/*! \brief Precise sleep for "usecs" microseconds * \details This function consider \c "usleep" offset * on QNX/Linux/Mac, which is calculated with * \a pip_sys_test program. If there is correct @@ -38,11 +38,11 @@ * wait \b exactly "usecs" microseconds. */ PIP_EXPORT void piUSleep(int usecs); // on !Windows consider constant "usleep" offset -/*! @brief Precise sleep for "msecs" milliseconds +/*! \brief Precise sleep for "msecs" milliseconds * \details This function exec \a piUSleep (msecs * 1000). */ inline void piMSleep(double msecs) {piUSleep(int(msecs * 1000.));} // on !Windows consider constant "usleep" offset -/*! @brief Precise sleep for "secs" seconds +/*! \brief Precise sleep for "secs" seconds * \details This function exec \a piUSleep (msecs * 1000000). */ inline void piSleep(double secs) {piUSleep(int(secs * 1000000.));} // on !Windows consider constant "usleep" offset @@ -167,7 +167,7 @@ private: }; -//! \relatesalso PICout @brief Output operator to PICout +//! \relatesalso PICout \brief Output operator to PICout inline PICout operator <<(PICout s, const PISystemTime & v) {s.space(); s.setControl(0, true); s << "(" << v.seconds << " s, " << v.nanoseconds << " ns)"; s.restoreControl(); return s;} @@ -191,7 +191,7 @@ inline bool operator !=(const PITime & t0, const PITime & t1) {return !(t0 == t1 inline bool operator <=(const PITime & t0, const PITime & t1) {return !(t0 > t1);} inline bool operator >=(const PITime & t0, const PITime & t1) {return !(t0 < t1);} -//! \relatesalso PICout @brief Output operator to PICout +//! \relatesalso PICout \brief Output operator to PICout PIP_EXPORT PICout operator <<(PICout s, const PITime & v); @@ -213,7 +213,7 @@ inline bool operator !=(const PIDate & t0, const PIDate & t1) {return !(t0 == t1 inline bool operator <=(const PIDate & t0, const PIDate & t1) {return !(t0 > t1);} inline bool operator >=(const PIDate & t0, const PIDate & t1) {return !(t0 < t1);} -//! \relatesalso PICout @brief Output operator to PICout +//! \relatesalso PICout \brief Output operator to PICout PIP_EXPORT PICout operator <<(PICout s, const PIDate & v); @@ -258,7 +258,7 @@ inline bool operator >=(const PIDateTime & t0, const PIDateTime & t1) {return !( inline PIByteArray & operator <<(PIByteArray & s, const PIDateTime & v) {s << v.year << v.month << v.day << v.hours << v.minutes << v.seconds << v.milliseconds; return s;} inline PIByteArray & operator >>(PIByteArray & s, PIDateTime & v) {s >> v.year >> v.month >> v.day >> v.hours >> v.minutes >> v.seconds >> v.milliseconds; return s;} -//! \relatesalso PICout @brief Output operator to PICout +//! \relatesalso PICout \brief Output operator to PICout PIP_EXPORT PICout operator <<(PICout s, const PIDateTime & v); @@ -268,7 +268,7 @@ class PIP_EXPORT PITimeMeasurer { public: PITimeMeasurer(); - /** @brief Set internal time mark to current system time + /** \brief Set internal time mark to current system time * \details This function used for set start time mark. Later * you can find out elapsed time from this time mark to any * moment of time with \a elapsed_s(), \a elapsed_m(), @@ -276,19 +276,19 @@ public: * \sa \a elapsed_s(), \a elapsed_m(), \a elapsed_u(), \a elapsed_n() */ void reset() {t_st = PISystemTime::current(true);} - //! @brief Returns nanoseconds elapsed from last \a reset() execution or from timer measurer creation. + //! \brief Returns nanoseconds elapsed from last \a reset() execution or from timer measurer creation. double elapsed_n() const; - //! @brief Returns microseconds elapsed from last \a reset() execution or from timer measurer creation. + //! \brief Returns microseconds elapsed from last \a reset() execution or from timer measurer creation. double elapsed_u() const; - //! @brief Returns milliseconds elapsed from last \a reset() execution or from timer measurer creation. + //! \brief Returns milliseconds elapsed from last \a reset() execution or from timer measurer creation. double elapsed_m() const; - //! @brief Returns seconds elapsed from last \a reset() execution or from timer measurer creation. + //! \brief Returns seconds elapsed from last \a reset() execution or from timer measurer creation. double elapsed_s() const; - //! @brief Returns PISystemTime elapsed from last \a reset() execution or from timer measurer creation. + //! \brief Returns PISystemTime elapsed from last \a reset() execution or from timer measurer creation. PISystemTime elapsed() const; double reset_time_n() const {return t_st.toNanoseconds();} @@ -296,22 +296,22 @@ public: double reset_time_m() const {return t_st.toMilliseconds();} double reset_time_s() const {return t_st.toSeconds();} - //! @brief Returns time mark of last \a reset() execution or timer measurer creation. + //! \brief Returns time mark of last \a reset() execution or timer measurer creation. PISystemTime reset_time() {return t_st;} - //! @brief Returns nanoseconds representation of current system time. + //! \brief Returns nanoseconds representation of current system time. static double elapsed_system_n() {return PISystemTime::current(true).toNanoseconds();} - //! @brief Returns microseconds representation of current system time. + //! \brief Returns microseconds representation of current system time. static double elapsed_system_u() {return PISystemTime::current(true).toMicroseconds();} - //! @brief Returns milliseconds representation of current system time. + //! \brief Returns milliseconds representation of current system time. static double elapsed_system_m() {return PISystemTime::current(true).toMilliseconds();} - //! @brief Returns seconds representation of current system time. + //! \brief Returns seconds representation of current system time. static double elapsed_system_s() {return PISystemTime::current(true).toSeconds();} - //! @brief Returns time mark of current system time. + //! \brief Returns time mark of current system time. static PISystemTime elapsed_system() {return PISystemTime::current(true);} private: diff --git a/libs/main/core/pitime_win.h b/libs/main/core/pitime_win.h index 907bc458..053e727b 100644 --- a/libs/main/core/pitime_win.h +++ b/libs/main/core/pitime_win.h @@ -1,5 +1,5 @@ -/*! @file pitime_win.h - * @brief PITime conversions for Windows +/*! \file pitime_win.h + * \brief PITime conversions for Windows * * This file declare time conversions for Windows */ diff --git a/libs/main/core/pivariant.cpp b/libs/main/core/pivariant.cpp index 3eda416f..9e9da078 100644 --- a/libs/main/core/pivariant.cpp +++ b/libs/main/core/pivariant.cpp @@ -21,7 +21,7 @@ /** \class PIVariant - * @brief Variant type + * \brief Variant type * \details * \section PIVariant_sec0 Synopsis * This class provides general type that can contains all standard types, some @@ -220,7 +220,7 @@ PIString PIVariant::typeName(PIVariant::Type type) { } -/** @brief Returns variant content as boolean +/** \brief Returns variant content as boolean * \details In case of numeric types returns \b true if value != 0. \n * In case of String type returns \a PIString::toBool(). \n * In case of StringList type returns \b false if string list is empty, @@ -251,7 +251,7 @@ bool PIVariant::toBool() const { -/** @brief Returns variant content as int +/** \brief Returns variant content as int * \details In case of numeric types returns integer value. \n * In case of String type returns \a PIString::toInt(). \n * In case of StringList type returns \b 0 if string list is empty, @@ -283,7 +283,7 @@ int PIVariant::toInt() const { } -/** @brief Returns variant content as long long +/** \brief Returns variant content as long long * \details In case of numeric types returns integer value. \n * In case of String type returns \a PIString::toLLong(). \n * In case of StringList type returns \b 0L if string list is empty, @@ -314,7 +314,7 @@ llong PIVariant::toLLong() const { } -/** @brief Returns variant content as float +/** \brief Returns variant content as float * \details In case of numeric types returns float value. \n * In case of String type returns \a PIString::toFloat(). \n * In case of StringList type returns \b 0.f if string list is empty, @@ -345,7 +345,7 @@ float PIVariant::toFloat() const { } -/** @brief Returns variant content as double +/** \brief Returns variant content as double * \details In case of numeric types returns double value. \n * In case of String type returns \a PIString::toDouble(). \n * In case of StringList type returns \b 0. if string list is empty, @@ -376,7 +376,7 @@ double PIVariant::toDouble() const { } -/** @brief Returns variant content as long double +/** \brief Returns variant content as long double * \details In case of numeric types returns long double value. \n * In case of String type returns \a PIString::toLDouble(). \n * In case of StringList type returns \b 0. if string list is empty, @@ -407,7 +407,7 @@ ldouble PIVariant::toLDouble() const { } -/** @brief Returns variant content as time +/** \brief Returns variant content as time * \details In case of Time type returns time value. \n * In case of DateTime type returns time part of value. \n * In case of other types returns \a PITime(). */ @@ -420,7 +420,7 @@ PITime PIVariant::toTime() const { } -/** @brief Returns variant content as date +/** \brief Returns variant content as date * \details In case of Date type returns date value. \n * In case of DateTime type returns date part of value. \n * In case of other types returns \a PIDate(). */ @@ -433,7 +433,7 @@ PIDate PIVariant::toDate() const { } -/** @brief Returns variant content as date and time +/** \brief Returns variant content as date and time * \details In case of Time type returns time value with null date. \n * In case of Date type returns date value with null time. \n * In case of DateTime type returns date and time. \n @@ -448,7 +448,7 @@ PIDateTime PIVariant::toDateTime() const { } -/** @brief Returns variant content as system time +/** \brief Returns variant content as system time * \details In case of SystemTime type returns system time. \n * In case of other types returns \a PISystemTime::fromSeconds() from * double value of variant content. */ @@ -460,7 +460,7 @@ PISystemTime PIVariant::toSystemTime() const { } -/** @brief Returns variant content as string +/** \brief Returns variant content as string * \details In case of numeric types returns \a PIString::fromNumber(). \n * In case of String type returns string value. \n * In case of StringList type returns joined string ("(" + PIStringList::join("; ") + ")"). \n @@ -501,7 +501,7 @@ PIString PIVariant::toString() const { } -/** @brief Returns variant content as strings list +/** \brief Returns variant content as strings list * \details In case of StringList type returns strings list value. \n * In case of other types returns \a PIStringList with one string value of variant content. */ PIStringList PIVariant::toStringList() const { @@ -513,7 +513,7 @@ PIStringList PIVariant::toStringList() const { } -/** @brief Returns variant content as bit array +/** \brief Returns variant content as bit array * \details In case of BitArray type returns bit array value. \n * In case of other types returns \a PIBitArray from \a toLLong() value. */ PIBitArray PIVariant::toBitArray() const { @@ -524,7 +524,7 @@ PIBitArray PIVariant::toBitArray() const { } -/** @brief Returns variant content as byte array +/** \brief Returns variant content as byte array * \details In case of ByteArray type returns byte array value. \n * In case of other types returns empty \a PIByteArray. */ PIByteArray PIVariant::toByteArray() const { @@ -535,7 +535,7 @@ PIByteArray PIVariant::toByteArray() const { } -/** @brief Returns variant content as enum +/** \brief Returns variant content as enum * \details In case of Enum type returns enum value. \n * In case of String returns Enum with one member. \n * In case of StringList returns Enum with corresponding members. \n @@ -550,7 +550,7 @@ PIVariantTypes::Enum PIVariant::toEnum() const { } -/** @brief Returns variant content as file +/** \brief Returns variant content as file * \details In case of File type returns file value. \n * In case of String returns File with string value path. \n * In case of other types returns empty File. */ @@ -563,7 +563,7 @@ PIVariantTypes::File PIVariant::toFile() const { } -/** @brief Returns variant content as dir +/** \brief Returns variant content as dir * \details In case of Dir type returns dir value. \n * In case of String returns Dir with string value path. \n * In case of other types returns empty Dir. */ @@ -576,7 +576,7 @@ PIVariantTypes::Dir PIVariant::toDir() const { } -/** @brief Returns variant content as color +/** \brief Returns variant content as color * \details In case of Color type returns color value. \n * In case of int returns color with int value. \n * In case of other types returns empty Color. */ @@ -589,7 +589,7 @@ PIVariantTypes::Color PIVariant::toColor() const { } -/** @brief Returns variant content as IODevice +/** \brief Returns variant content as IODevice * \details In case of IODevice type returns IODevice value. \n * In case of other types returns empty IODevice. */ PIVariantTypes::IODevice PIVariant::toIODevice() const { @@ -599,7 +599,7 @@ PIVariantTypes::IODevice PIVariant::toIODevice() const { } -/** @brief Returns variant content as point +/** \brief Returns variant content as point * \details In case of PIPointd type returns point value. \n * In case of other types returns empty PIPointd. */ PIPointd PIVariant::toPoint() const { @@ -609,7 +609,7 @@ PIPointd PIVariant::toPoint() const { } -/** @brief Returns variant content as rect +/** \brief Returns variant content as rect * \details In case of PIRectd type returns rect value. \n * In case of other types returns empty PIRectd. */ PIRectd PIVariant::toRect() const { @@ -619,7 +619,7 @@ PIRectd PIVariant::toRect() const { } -/** @brief Returns variant content as math vector +/** \brief Returns variant content as math vector * \details In case of PIMathVectord type returns rect value. \n * In case of other types returns empty PIMathVectord. */ PIMathVectord PIVariant::toMathVector() const { @@ -629,7 +629,7 @@ PIMathVectord PIVariant::toMathVector() const { } -/** @brief Returns variant content as math matrix +/** \brief Returns variant content as math matrix * \details In case of PIMathMatrixd type returns rect value. \n * In case of other types returns empty PIMathMatrixd. */ PIMathMatrixd PIVariant::toMathMatrix() const { diff --git a/libs/main/core/pivariant.h b/libs/main/core/pivariant.h index fe155eef..77313cf4 100644 --- a/libs/main/core/pivariant.h +++ b/libs/main/core/pivariant.h @@ -1,5 +1,5 @@ -/*! @file pivariant.h - * @brief Variant type +/*! \file pivariant.h + * \brief Variant type * * This file declares PIVariant */ @@ -460,7 +460,7 @@ public: PIMathMatrixd toMathMatrix() const; - /** @brief Returns variant content as custom type + /** \brief Returns variant content as custom type * \details In case of known types this function equivalent \a to function. \n * Otherwise returns content as type T. */ template @@ -551,7 +551,7 @@ public: void swap(PIVariant & v); - /** @brief Returns new variant from custom type + /** \brief Returns new variant from custom type * \details In case of known types this function equivalent \a PIVariant(T) constructors. \n * Otherwise returns variant with content \a v and type Custom. */ template diff --git a/libs/main/core/pivariantsimple.h b/libs/main/core/pivariantsimple.h index dd6067e9..70a79f29 100644 --- a/libs/main/core/pivariantsimple.h +++ b/libs/main/core/pivariantsimple.h @@ -1,5 +1,5 @@ -/*! @file pivariantsimple.h - * @brief Variant simple type +/*! \file pivariantsimple.h + * \brief Variant simple type * * This file declares PIVariantSimple */ diff --git a/libs/main/core/pivarianttypes.h b/libs/main/core/pivarianttypes.h index 8c2eb4e2..6bafe682 100644 --- a/libs/main/core/pivarianttypes.h +++ b/libs/main/core/pivarianttypes.h @@ -1,5 +1,5 @@ -/*! @file pivarianttypes.h - * @brief Variant type +/*! \file pivarianttypes.h + * \brief Variant type * * This file declares PIVariant */ @@ -34,7 +34,7 @@ class PIPropertyStorage; namespace PIVariantTypes { /** - * @brief name-value pair + * \brief name-value pair */ struct PIP_EXPORT Enumerator { Enumerator(int v = 0, const PIString & n = PIString()): value(v), name(n) {} @@ -43,26 +43,26 @@ struct PIP_EXPORT Enumerator { }; /** - * @brief Collection of PIVariantTypes::Enumerator. It's replace classic c-style enum. + * \brief Collection of PIVariantTypes::Enumerator. It's replace classic c-style enum. * Contains elements with unique name and not uniqueue values. */ struct PIP_EXPORT Enum { Enum(const PIString & n = PIString()): enum_name(n) {} /** - * @brief Find selected value. + * \brief Find selected value. * @return selected value, otherwrise 0 */ int selectedValue() const; /** - * @brief Get selected name + * \brief Get selected name * @return selected name, otherwrise empty PIString */ PIString selectedName() const {return selected;} /** - * @brief Select value if exists in Enum. If Enum contains several PIVariantTypes::Enumerator with same values, + * \brief Select value if exists in Enum. If Enum contains several PIVariantTypes::Enumerator with same values, * first PIVariantTypes::Enumerator will selected * @param v value for selection * @return true if value exists in Enum, false otherwrise @@ -70,55 +70,55 @@ struct PIP_EXPORT Enum { bool selectValue(int v); /** - * @brief Select name if exists in enum + * \brief Select name if exists in enum * @param n name for selection * @return true if name exists in Enum, false otherwrise */ bool selectName(const PIString & n); /** - * @brief Find PIVariantTypes::Enumerator with specific name and return it value + * \brief Find PIVariantTypes::Enumerator with specific name and return it value * @param n name for search * @return value of founded PIVariantTypes::Enumerator, 0 otherwrise */ int value(const PIString & n) const; /** - * @brief Find first PIVariantTypes::Enumerator with specific value and return it name + * \brief Find first PIVariantTypes::Enumerator with specific value and return it name * @param v value for search * @return name of founded PIVariantTypes::Enumerator, empty string otherwrise */ PIString name(int v) const; /** - * @brief Make vector of Enum values + * \brief Make vector of Enum values */ PIVector values() const; /** - * @brief Make vector of Enum names + * \brief Make vector of Enum names */ PIStringList names() const; /** - * @brief Add PIVariantTypes::Enumerator to Enum + * \brief Add PIVariantTypes::Enumerator to Enum */ Enum & operator <<(const Enumerator & v); /** - * @brief Add PIVariantTypes::Enumerator element to Enum. Element contains specific name and value more per + * \brief Add PIVariantTypes::Enumerator element to Enum. Element contains specific name and value more per * unit then last element. If the is no elements, contains zero value. * @param v name for new PIVariantTypes::Enumerator element */ Enum & operator <<(const PIString & v); /** - * @brief Add PIVariantTypes::Enumerator element for each name in vector + * \brief Add PIVariantTypes::Enumerator element for each name in vector */ Enum & operator <<(const PIStringList & v); /** - * @brief Return true if Enum is empty + * \brief Return true if Enum is empty */ bool isEmpty() const {return enum_list.isEmpty();} diff --git a/libs/main/crypt/piauth.h b/libs/main/crypt/piauth.h index f65bea81..427b9dad 100644 --- a/libs/main/crypt/piauth.h +++ b/libs/main/crypt/piauth.h @@ -1,5 +1,5 @@ -/*! @file piauth.h - * @brief PIP Authentication API +/*! \file piauth.h + * \brief PIP Authentication API */ /* PIP - Platform Independent Primitives diff --git a/libs/main/crypt/picrypt.h b/libs/main/crypt/picrypt.h index bee2b810..32846a09 100644 --- a/libs/main/crypt/picrypt.h +++ b/libs/main/crypt/picrypt.h @@ -1,5 +1,5 @@ -/*! @file picrypt.h - * @brief Cryptographic class using lib Sodium +/*! \file picrypt.h + * \brief Cryptographic class using lib Sodium */ /* PIP - Platform Independent Primitives diff --git a/libs/main/geo/piellipsoidmodel.h b/libs/main/geo/piellipsoidmodel.h index 296e8b51..c9c2f621 100644 --- a/libs/main/geo/piellipsoidmodel.h +++ b/libs/main/geo/piellipsoidmodel.h @@ -1,5 +1,5 @@ -/*! @file piellipsoidmodel.h - * @brief Contains geo ellipsoid models +/*! \file piellipsoidmodel.h + * \brief Contains geo ellipsoid models */ /* PIP - Platform Independent Primitives diff --git a/libs/main/geo/pigeoposition.h b/libs/main/geo/pigeoposition.h index 75dd6f27..bb301198 100644 --- a/libs/main/geo/pigeoposition.h +++ b/libs/main/geo/pigeoposition.h @@ -1,5 +1,5 @@ -/*! @file pigeoposition.h - * @brief Class for geo position storage and conversions +/*! \file pigeoposition.h + * \brief Class for geo position storage and conversions */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_devices/pibinarylog.cpp b/libs/main/io_devices/pibinarylog.cpp index bc593ed9..df1404d5 100644 --- a/libs/main/io_devices/pibinarylog.cpp +++ b/libs/main/io_devices/pibinarylog.cpp @@ -24,7 +24,7 @@ #define PIBINARYLOG_VERSION_OLD 0x31 /*! \class PIBinaryLog - * @brief Class for read and write binary data to logfile, and playback this data in realtime, or custom speed + * \brief Class for read and write binary data to logfile, and playback this data in realtime, or custom speed * * \section PIBinaryLog_sec0 Synopsis * Binary Log is a file with simple header, where you can read and write some binary data. diff --git a/libs/main/io_devices/pibinarylog.h b/libs/main/io_devices/pibinarylog.h index 1c9bee81..e3adea53 100644 --- a/libs/main/io_devices/pibinarylog.h +++ b/libs/main/io_devices/pibinarylog.h @@ -1,5 +1,5 @@ -/*! @file pibinarylog.h - * @brief Binary log +/*! \file pibinarylog.h + * \brief Binary log */ /* PIP - Platform Independent Primitives @@ -33,14 +33,14 @@ public: explicit PIBinaryLog(); virtual ~PIBinaryLog(); - //! @brief Play modes for \a PIBinaryLog + //! \brief Play modes for \a PIBinaryLog enum PlayMode { PlayRealTime /*! Play in system realtime, default mode */ , PlayVariableSpeed /*! Play in software realtime with speed, set by \a setSpeed */ , PlayStaticDelay /*! Play with custom static delay, ignoring timestamp */ }; - //! @brief Different split modes for writing \a PIBinaryLog, which can separate files by size, by time or by records count + //! \brief Different split modes for writing \a PIBinaryLog, which can separate files by size, by time or by records count enum SplitMode { SplitNone /*! Without separate, default mode */ , SplitTime /*! Separate files by record time */ , @@ -48,7 +48,7 @@ public: SplitCount /*! Separate files by records count */ }; - //! @brief Struct contains information about all records with same ID + //! \brief Struct contains information about all records with same ID struct PIP_EXPORT BinLogRecordInfo { BinLogRecordInfo() { id = count = 0; @@ -62,7 +62,7 @@ public: PISystemTime end_time; }; - //! @brief Struct contains full information about Binary Log file and about all Records using map of \a BinLogRecordInfo + //! \brief Struct contains full information about Binary Log file and about all Records using map of \a BinLogRecordInfo struct PIP_EXPORT BinLogInfo { PIString path; int records_count; @@ -73,7 +73,7 @@ public: PIByteArray user_header; }; - //! @brief Struct contains position, ID and timestamp of record in file + //! \brief Struct contains position, ID and timestamp of record in file struct PIP_EXPORT BinLogIndex { int id; int data_size; @@ -256,7 +256,7 @@ public: //! \{ //! \fn PIString createNewFile() - //! @brief Create new binlog file in \a logDir, if successful returns filename, else returns empty string. + //! \brief Create new binlog file in \a logDir, if successful returns filename, else returns empty string. //! Filename is like \a filePrefix + "yyyy_MM_dd__hh_mm_ss.binlog" //! \} @@ -264,13 +264,13 @@ public: //! \{ //! \fn void fileEnd() - //! @brief Raise on file end while reading + //! \brief Raise on file end while reading //! \fn void fileError() - //! @brief Raise on file creation error + //! \brief Raise on file creation error //! \fn void newFile(const PIString & filename) - //! @brief Raise on new file created + //! \brief Raise on new file created //! \} @@ -331,7 +331,7 @@ private: PIByteArray user_header; }; -//! \relatesalso PICout @brief Output operator PIBinaryLog::BinLogInfo to PICout +//! \relatesalso PICout \brief Output operator PIBinaryLog::BinLogInfo to PICout inline PICout operator <<(PICout s, const PIBinaryLog::BinLogInfo & bi) { s.space(); s.setControl(0, true); diff --git a/libs/main/io_devices/pican.h b/libs/main/io_devices/pican.h index ba2b4592..11f2bb06 100644 --- a/libs/main/io_devices/pican.h +++ b/libs/main/io_devices/pican.h @@ -1,5 +1,5 @@ -/*! @file pican.h - * @brief CAN device +/*! \file pican.h + * \brief CAN device */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_devices/piconfig.cpp b/libs/main/io_devices/piconfig.cpp index 318dfac9..816207ff 100644 --- a/libs/main/io_devices/piconfig.cpp +++ b/libs/main/io_devices/piconfig.cpp @@ -26,7 +26,7 @@ # include #endif /*! \class PIConfig - * @brief Configuration file + * \brief Configuration file * \details This class provide handle access to configuration file. * * \section PIConfig_sec0 Synopsis @@ -67,7 +67,7 @@ */ /*! \class PIConfig::Entry - * @brief %Entry of configuration file + * \brief %Entry of configuration file * \details This class is node of internal PIConfig tree. * %Entry provide access to elements of PIConfig. Each entry has * children or next properties: @@ -91,7 +91,7 @@ */ /*! \class PIConfig::Branch - * @brief %Branch is a list of entries of configuration file + * \brief %Branch is a list of entries of configuration file * \details %Branch provides some features to get entries lists. * \snippet piconfig.cpp PIConfig::Branch * diff --git a/libs/main/io_devices/piconfig.h b/libs/main/io_devices/piconfig.h index 5bee75ab..c6027ffc 100644 --- a/libs/main/io_devices/piconfig.h +++ b/libs/main/io_devices/piconfig.h @@ -1,5 +1,5 @@ -/*! @file piconfig.h - * @brief Configuration parser and writer +/*! \file piconfig.h + * \brief Configuration parser and writer */ /* PIP - Platform Independent Primitives @@ -148,7 +148,7 @@ public: //! Returns comment const PIString & comment() const {return _comment;} - /** @brief Returns full name, i.e. name as it looks in file + /** \brief Returns full name, i.e. name as it looks in file * \details In case of default entry full name always is empty * \snippet piconfig.cpp fullName */ const PIString & fullName() const {return _full_name;} @@ -205,7 +205,7 @@ public: Entry & setValue(const double value) {setValue(PIString::fromNumber(value)); setType("f"); return *this;} - /** @brief Returns entry with name "vname" and default value "def" + /** \brief Returns entry with name "vname" and default value "def" * \details If there is no suitable entry found, reference to default internal entry with * value = "def" will be returned, and if "exists" not null it will be set to \b false */ Entry & getValue(const PIString & vname, const PIString & def = PIString(), bool * exists = 0); @@ -213,43 +213,43 @@ public: PICONFIG_GET_VALUE //! \fn Entry & getValue(const PIString & vname, const char * def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const char * def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const PIStringList & def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const bool def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const short def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const int def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const long def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const uchar def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const ushort def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const uint def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const ulong def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const float def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const double def, bool * exists = 0) - //! @brief Returns entry with name "vname" and default value "def" + //! \brief Returns entry with name "vname" and default value "def" //! Find all entries with names with substrings "vname" and returns them as \a PIConfig::Branch @@ -341,43 +341,43 @@ public: PICONFIG_GET_VALUE //! \fn Entry & getValue(const PIString & vname, const char * def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const char * def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const PIStringList & def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const bool def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const short def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const int def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const long def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const uchar def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const ushort def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const uint def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const ulong def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const float def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! \fn Entry & getValue(const PIString & vname, const double def, bool * exists = 0) - //! @brief Returns top-level entry with name "vname" and default value "def" + //! \brief Returns top-level entry with name "vname" and default value "def" //! Returns top-level entries with names with substrings "vname" @@ -517,7 +517,7 @@ inline PICout operator <<(PICout s, const PIConfig::Entry & v) { /** \relatesalso PIConfig \relatesalso PIIODevice - * @brief Service function. useful for configuring devices + * \brief Service function. useful for configuring devices * \details Function takes entry name "name", default value "def" and two * \a PIConfig::Entry sections: "em" and their parent "ep". If there is no * parent ep = 0. If "ep" is not null and entry "name" exists in "ep" function diff --git a/libs/main/io_devices/pidir.cpp b/libs/main/io_devices/pidir.cpp index fa7c4bf4..c4db1962 100644 --- a/libs/main/io_devices/pidir.cpp +++ b/libs/main/io_devices/pidir.cpp @@ -46,7 +46,7 @@ extern "C" { #endif /*! \class PIDir - * @brief Local directory + * \brief Local directory * * \section PIDir_sec0 Synopsis * This class provide access to local file. You can manipulate diff --git a/libs/main/io_devices/pidir.h b/libs/main/io_devices/pidir.h index 2c4e6448..4873b252 100644 --- a/libs/main/io_devices/pidir.h +++ b/libs/main/io_devices/pidir.h @@ -1,5 +1,5 @@ -/*! @file pidir.h - * @brief Local directory +/*! \file pidir.h + * \brief Local directory */ /* PIP - Platform Independent Primitives @@ -57,7 +57,7 @@ public: //! Returns absolute path of this directory PIString absolutePath() const; - /** @brief Simplify path of this directory + /** \brief Simplify path of this directory * \details This function remove repeatedly separators and * resolve ".." in path. E.g. "/home/.//peri4/src/../.." will * become "/home" \n This function returns reference to this %PIDir */ @@ -76,7 +76,7 @@ public: bool setCurrent() {return PIDir::setCurrent(path());} - /** @brief Returns this directory content + /** \brief Returns this directory content * \details Scan this directory and returns all directories * and files in one list, sorted alphabetically. This list * contains also "." and ".." members. There are absolute @@ -85,7 +85,7 @@ public: * directories! */ PIVector entries(); - /** @brief Returns all this directory content + /** \brief Returns all this directory content * \details Scan this directory recursively and returns all * directories and files in one list, sorted alphabetically. * This list doesn`t contains "." and ".." members. There diff --git a/libs/main/io_devices/piethernet.cpp b/libs/main/io_devices/piethernet.cpp index dd9f5b25..315927ad 100644 --- a/libs/main/io_devices/piethernet.cpp +++ b/libs/main/io_devices/piethernet.cpp @@ -70,7 +70,7 @@ /** \class PIEthernet - * @brief Ethernet device + * \brief Ethernet device * \details * \section PIEthernet_sec0 Synopsis * %PIEthernet designed to work with IPv4 network via two protocols: diff --git a/libs/main/io_devices/piethernet.h b/libs/main/io_devices/piethernet.h index ac977fb1..ebacf5be 100644 --- a/libs/main/io_devices/piethernet.h +++ b/libs/main/io_devices/piethernet.h @@ -1,5 +1,5 @@ -/*! @file piethernet.h - * @brief Ethernet device +/*! \file piethernet.h + * \brief Ethernet device */ /* PIP - Platform Independent Primitives @@ -42,7 +42,7 @@ public: //! Contructs UDP %PIEthernet with empty read address explicit PIEthernet(); - //! @brief Type of %PIEthernet + //! \brief Type of %PIEthernet enum Type { UDP /** UDP - User Datagram Protocol */ , TCP_Client /** TCP client - allow connection to TCP server */ , @@ -50,7 +50,7 @@ public: TCP_SingleTCP /** TCP client single mode - connect & send & disconnect, on each packet */ }; - //! @brief Parameters of %PIEthernet + //! \brief Parameters of %PIEthernet enum Parameters { ReuseAddress /** Rebind address if there is already binded. Enabled by default */ = 0x1, Broadcast /** Broadcast send. Disabled by default */ = 0x2, @@ -62,7 +62,7 @@ public: }; - //! @brief IPv4 network address, IP and port + //! \brief IPv4 network address, IP and port class PIP_EXPORT Address { friend class PIEthernet; public: @@ -421,37 +421,37 @@ public: //! \{ //! \fn void newConnection(PIEthernet * client) - //! @brief Raise on new TCP connection received + //! \brief Raise on new TCP connection received //! \fn void connected() - //! @brief Raise if succesfull TCP connection + //! \brief Raise if succesfull TCP connection //! \fn void disconnected(bool withError) - //! @brief Raise if TCP connection was closed + //! \brief Raise if TCP connection was closed //! \} //! \ioparams //! \{ #ifdef DOXYGEN - //! @brief read ip, default "" + //! \brief read ip, default "" string ip; - //! @brief read port, default 0 + //! \brief read port, default 0 int port; - //! @brief ethernet parameters + //! \brief ethernet parameters int parameters; - //! @brief read timeout, default 1000 ms + //! \brief read timeout, default 1000 ms double readTimeout; - //! @brief write timeout, default 1000 ms + //! \brief write timeout, default 1000 ms double writeTimeout; - //! @brief time-to-live, default 64 + //! \brief time-to-live, default 64 int TTL; - //! @brief time-to-live for multicast, default 1 + //! \brief time-to-live for multicast, default 1 int multicastTTL; #endif //! \} diff --git a/libs/main/io_devices/pifile.cpp b/libs/main/io_devices/pifile.cpp index 813818b1..05fd459d 100644 --- a/libs/main/io_devices/pifile.cpp +++ b/libs/main/io_devices/pifile.cpp @@ -70,7 +70,7 @@ #endif /*! \class PIFile - * @brief Local file + * \brief Local file * * \section PIFile_sec0 Synopsis * This class provide access to local file. You can manipulate diff --git a/libs/main/io_devices/pifile.h b/libs/main/io_devices/pifile.h index 2cb9c036..67317959 100644 --- a/libs/main/io_devices/pifile.h +++ b/libs/main/io_devices/pifile.h @@ -1,5 +1,5 @@ -/*! @file pifile.h - * @brief Local file +/*! \file pifile.h + * \brief Local file */ /* PIP - Platform Independent Primitives @@ -267,16 +267,16 @@ public: //! \{ //! \fn void clear() - //! @brief Clear content of file + //! \brief Clear content of file //! \fn void resize(llong new_size) - //! @brief Resize file to "new_size" with "fill" filling + //! \brief Resize file to "new_size" with "fill" filling //! \fn void resize(llong new_size, uchar fill) - //! @brief Resize file to "new_size" with "fill" filling + //! \brief Resize file to "new_size" with "fill" filling //! \fn void remove() - //! @brief Remove file + //! \brief Remove file //! \} //! \ioparams diff --git a/libs/main/io_devices/pigpio.cpp b/libs/main/io_devices/pigpio.cpp index 86783691..85d6cb78 100644 --- a/libs/main/io_devices/pigpio.cpp +++ b/libs/main/io_devices/pigpio.cpp @@ -29,7 +29,7 @@ /*! \class PIGPIO - * @brief GPIO support + * \brief GPIO support * * \section PIGPIO_sec0 Synopsis * This class provide initialize, get/set and watch functions for GPIO. diff --git a/libs/main/io_devices/pigpio.h b/libs/main/io_devices/pigpio.h index ce157aae..ed566206 100644 --- a/libs/main/io_devices/pigpio.h +++ b/libs/main/io_devices/pigpio.h @@ -1,5 +1,5 @@ -/*! @file pigpio.h - * @brief GPIO +/*! \file pigpio.h + * \brief GPIO */ /* PIP - Platform Independent Primitives @@ -33,41 +33,41 @@ public: PIGPIO(); virtual ~PIGPIO(); - //! @brief Work mode for pin + //! \brief Work mode for pin enum Direction { In /** Input direction (read) */, Out /** Output direction (write) */ }; - //! @brief Returns singleton object of %PIGPIO + //! \brief Returns singleton object of %PIGPIO static PIGPIO * instance(); - //! @brief Initialize pin \"gpio_num\" for \"dir\" mode + //! \brief Initialize pin \"gpio_num\" for \"dir\" mode void initPin(int gpio_num, Direction dir = PIGPIO::In); - //! @brief Set pin \"gpio_num\" value to \"value\" + //! \brief Set pin \"gpio_num\" value to \"value\" void pinSet (int gpio_num, bool value); - //! @brief Set pin \"gpio_num\" value to \b true + //! \brief Set pin \"gpio_num\" value to \b true void pinHigh (int gpio_num) {pinSet(gpio_num, true );} - //! @brief Set pin \"gpio_num\" value to \b false + //! \brief Set pin \"gpio_num\" value to \b false void pinLow (int gpio_num) {pinSet(gpio_num, false);} - //! @brief Returns pin \"gpio_num\" state + //! \brief Returns pin \"gpio_num\" state bool pinState(int gpio_num); - //! @brief Starts watch for pin \"gpio_num\". + //! \brief Starts watch for pin \"gpio_num\". //! \details Pins watching starts only with \a PIThread::start() function! //! This function doesn`t affect thread state void pinBeginWatch(int gpio_num); - //! @brief End watch for pin \"gpio_num\". + //! \brief End watch for pin \"gpio_num\". //! \details Pins watching starts only with \a PIThread::start() function! //! This function doesn`t affect thread state void pinEndWatch (int gpio_num); - //! @brief End watch for all pins. + //! \brief End watch for all pins. //! \details Pins watching starts only with \a PIThread::start() function! //! This function doesn`t affect thread state void clearWatch(); @@ -78,7 +78,7 @@ public: //! \{ //! \fn void pinChanged(int gpio_num, bool new_value) - //! @brief Raise on pin \"gpio_num\" state changes to \"new_value\" + //! \brief Raise on pin \"gpio_num\" state changes to \"new_value\" //! \details Important! This event will be raised only with started //! thread. diff --git a/libs/main/io_devices/piiobytearray.cpp b/libs/main/io_devices/piiobytearray.cpp index c91c3c90..67f45a21 100644 --- a/libs/main/io_devices/piiobytearray.cpp +++ b/libs/main/io_devices/piiobytearray.cpp @@ -21,7 +21,7 @@ /*! \class PIIOByteArray - * @brief PIIODevice wrapper around PIByteArray + * \brief PIIODevice wrapper around PIByteArray * * \section PIIOByteArray_sec0 Synopsis * This class sllow you to use PIByteArray as PIIODevice and pass it to, e.g. PIConfig diff --git a/libs/main/io_devices/piiobytearray.h b/libs/main/io_devices/piiobytearray.h index 6ff35480..57bec2e4 100644 --- a/libs/main/io_devices/piiobytearray.h +++ b/libs/main/io_devices/piiobytearray.h @@ -1,5 +1,5 @@ -/*! @file piiobytearray.h - * @brief PIIODevice wrapper around PIByteArray +/*! \file piiobytearray.h + * \brief PIIODevice wrapper around PIByteArray */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_devices/piiodevice.cpp b/libs/main/io_devices/piiodevice.cpp index c3e2cbc3..4a6a921a 100644 --- a/libs/main/io_devices/piiodevice.cpp +++ b/libs/main/io_devices/piiodevice.cpp @@ -24,7 +24,7 @@ /*! \class PIIODevice - * @brief Base class for input/output classes + * \brief Base class for input/output classes * * \section PIIODevice_sec0 Synopsis * This class provide open/close logic, threaded read/write and virtual input/output @@ -125,7 +125,7 @@ PIIODevice::PIIODevice(): PIThread() { } -/*! @brief Constructs a PIIODevice with path and mode +/*! \brief Constructs a PIIODevice with path and mode * \param path path to device * \param type mode for open */ PIIODevice::PIIODevice(const PIString & path, PIIODevice::DeviceMode mode): PIThread() { diff --git a/libs/main/io_devices/piiodevice.h b/libs/main/io_devices/piiodevice.h index bfe903e2..6c7319fe 100644 --- a/libs/main/io_devices/piiodevice.h +++ b/libs/main/io_devices/piiodevice.h @@ -1,5 +1,5 @@ -/*! @file piiodevice.h - * @brief Abstract input/output device +/*! \file piiodevice.h + * \brief Abstract input/output device */ /* PIP - Platform Independent Primitives @@ -35,10 +35,10 @@ typedef bool (*ReadRetFunc)(void * , uchar * , int ); #ifdef DOXYGEN -//! \relatesalso PIIODevice @brief Use this macro to enable automatic creation instances of your class with \a createFromFullPath() function +//! \relatesalso PIIODevice \brief Use this macro to enable automatic creation instances of your class with \a createFromFullPath() function # define REGISTER_DEVICE(class) -//! \relatesalso PIIODevice @brief Use this macro instead of PIOBJECT when describe your own PIIODevice +//! \relatesalso PIIODevice \brief Use this macro instead of PIOBJECT when describe your own PIIODevice # define PIIODEVICE(class) #else @@ -59,20 +59,20 @@ public: //! Constructs a empty PIIODevice explicit PIIODevice(); - //! @brief Open modes for PIIODevice + //! \brief Open modes for PIIODevice enum DeviceMode { ReadOnly /*! Device can only read */ = 0x01, WriteOnly /*! Device can only write */ = 0x02, ReadWrite /*! Device can both read and write */ = 0x03 }; - //! @brief Options for PIIODevice, works with some devices + //! \brief Options for PIIODevice, works with some devices enum DeviceOption { BlockingRead /*! \a read block until data is received, default off */ = 0x01, BlockingWrite /*! \a write block until data is sent, default off */ = 0x02 }; - //! @brief Characteristics of PIIODevice subclass + //! \brief Characteristics of PIIODevice subclass enum DeviceInfoFlag { Sequential /*! Continuous bytestream without datagrams */ = 0x01, Reliable /*! Channel without data errors / corruptions */ = 0x02 @@ -144,7 +144,7 @@ public: int reopenTimeout() {return property(PIStringAscii("reopenTimeout")).toInt();} - /** @brief Set "threaded read slot" + /** \brief Set "threaded read slot" * \details Set external static function of threaded read that will be executed * at every successful threaded read. Function should have format * "bool func(void * data, uchar * readed, int size)" */ @@ -153,7 +153,7 @@ public: //! Set custom data that will be passed to "threaded read slot" void setThreadedReadData(void * d) {ret_data_ = d;} - /** @brief Set size of threaded read buffer + /** \brief Set size of threaded read buffer * \details Default size is 4096 bytes. If your device can read at single read * more than 4096 bytes you should use this function to adjust buffer size */ void setThreadedReadBufferSize(int new_size) {threaded_read_buffer_size = new_size; threadedReadBufferSizeChanged();} @@ -240,12 +240,12 @@ public: //! Configure device from PIVariantTypes::IODevice void configureFromVariant(const PIVariantTypes::IODevice & d); - //! @brief Try to determine suitable device, create new one, configure it with \a configureFromFullPath() and returns it. + //! \brief Try to determine suitable device, create new one, configure it with \a configureFromFullPath() and returns it. //! \details To function \a configureFromFullPath() "full_path" passed without \a fullPathPrefix() + "://". //! See \ref PIIODevice_sec7 static PIIODevice * createFromFullPath(const PIString & full_path); - //! @brief Try to determine suitable device, create new one, configure it with \a configureFromVariant() and returns it. + //! \brief Try to determine suitable device, create new one, configure it with \a configureFromVariant() and returns it. //! \details To function \a configureFromFullPath() "full_path" passed without \a fullPathPrefix() + "://". //! See \ref PIIODevice_sec7 static PIIODevice * createFromVariant(const PIVariantTypes::IODevice & d); @@ -276,57 +276,57 @@ public: //! \{ //! \fn bool open() - //! @brief Open device + //! \brief Open device //! \fn bool open(const PIString & path) - //! @brief Open device with path "path" + //! \brief Open device with path "path" //! \fn bool open(const DeviceMode & mode) - //! @brief Open device with mode "mode" + //! \brief Open device with mode "mode" //! \fn bool open(const PIString & path, const DeviceMode & mode) - //! @brief Open device with path "path" and mode "mode" + //! \brief Open device with path "path" and mode "mode" //! \fn bool close() - //! @brief Close device + //! \brief Close device //! \fn int write(PIByteArray data) - //! @brief Write "data" to device + //! \brief Write "data" to device //! \} //! \vhandlers //! \{ //! \fn void flush() - //! @brief Immediate write all buffers + //! \brief Immediate write all buffers //! \} //! \events //! \{ //! \fn void opened() - //! @brief Raise if succesfull open + //! \brief Raise if succesfull open //! \fn void closed() - //! @brief Raise if succesfull close + //! \brief Raise if succesfull close //! \fn void threadedReadEvent(uchar * readed, int size) - //! @brief Raise if read thread succesfull read some data + //! \brief Raise if read thread succesfull read some data //! \fn void threadedWriteEvent(ullong id, int written_size) - //! @brief Raise if write thread successfull write some data of task with ID "id" + //! \brief Raise if write thread successfull write some data of task with ID "id" //! \} //! \ioparams //! \{ #ifdef DOXYGEN - //! @brief setReopenEnabled, default "true" + //! \brief setReopenEnabled, default "true" bool reopenEnabled; - //! @brief setReopenTimeout in ms, default 1000 + //! \brief setReopenTimeout in ms, default 1000 int reopenTimeout; - //! @brief setThreadedReadBufferSize in bytes, default 4096 + //! \brief setThreadedReadBufferSize in bytes, default 4096 int threadedReadBufferSize; #endif //! \} diff --git a/libs/main/io_devices/piiostring.cpp b/libs/main/io_devices/piiostring.cpp index 47f30e4b..d2587cec 100644 --- a/libs/main/io_devices/piiostring.cpp +++ b/libs/main/io_devices/piiostring.cpp @@ -21,7 +21,7 @@ /*! \class PIIOString - * @brief PIIODevice wrapper around PIString + * \brief PIIODevice wrapper around PIString * * \section PIIOString_sec0 Synopsis * This class allow you to use PIString as PIIODevice and pass it to, e.g. PIConfig diff --git a/libs/main/io_devices/piiostring.h b/libs/main/io_devices/piiostring.h index 68a93684..9301060d 100644 --- a/libs/main/io_devices/piiostring.h +++ b/libs/main/io_devices/piiostring.h @@ -1,5 +1,5 @@ -/*! @file piiostring.h - * @brief PIIODevice wrapper around PIString +/*! \file piiostring.h + * \brief PIIODevice wrapper around PIString */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_devices/pipeer.h b/libs/main/io_devices/pipeer.h index 36a16b53..41862623 100644 --- a/libs/main/io_devices/pipeer.h +++ b/libs/main/io_devices/pipeer.h @@ -1,5 +1,5 @@ -/*! @file pipeer.h - * @brief Peering net node +/*! \file pipeer.h + * \brief Peering net node */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_devices/piserial.cpp b/libs/main/io_devices/piserial.cpp index f8264da3..0e381c71 100644 --- a/libs/main/io_devices/piserial.cpp +++ b/libs/main/io_devices/piserial.cpp @@ -138,7 +138,7 @@ /*! \class PISerial - * @brief Serial device + * \brief Serial device * * \section PISerial_sec0 Synopsis * This class provide access to serial device, e.g. COM port. It can read, @@ -416,7 +416,7 @@ int PISerial::convertSpeed(PISerial::Speed speed) { } -/** @brief Advanced read function +/** \brief Advanced read function * \details Read to pointer "read_to" no more than "max_size" and no longer * than "timeout_ms" milliseconds. If "timeout_ms" < 0 function will be * wait forever until "max_size" will be readed. If size <= 0 function @@ -454,7 +454,7 @@ bool PISerial::read(void * data, int size, double timeout_ms) { } -/** @brief Advanced read function +/** \brief Advanced read function * \details Read all or no more than "size" and no longer than * "timeout_ms" milliseconds. If "timeout_ms" < 0 function will be * wait forever until "size" will be readed. If "size" <= 0 @@ -506,7 +506,7 @@ PIString PISerial::read(int size, double timeout_ms) { } -/** @brief Advanced read function +/** \brief Advanced read function * \details Read all or no more than "size" and no longer than * "timeout_ms" milliseconds. If "timeout_ms" < 0 function will be * wait forever until "size" will be readed. If "size" <= 0 @@ -722,7 +722,7 @@ void PISerial::setTimeouts() { } -/** @brief Basic read function +/** \brief Basic read function * \details Read to pointer "read_to" no more than "max_size". If read is * set to blocking this function will be wait at least one byte. * \returns Readed bytes count diff --git a/libs/main/io_devices/piserial.h b/libs/main/io_devices/piserial.h index 6af6c290..f8957a40 100644 --- a/libs/main/io_devices/piserial.h +++ b/libs/main/io_devices/piserial.h @@ -1,5 +1,5 @@ -/*! @file piserial.h - * @brief Serial device +/*! \file piserial.h + * \brief Serial device */ /* PIP - Platform Independent Primitives @@ -34,14 +34,14 @@ public: //! Contructs an empty %PISerial explicit PISerial(); - //! @brief Parameters of PISerial + //! \brief Parameters of PISerial enum Parameters { ParityControl /*! Enable parity check and generate */ = 0x1, ParityOdd /*! Parity is odd instead of even */ = 0x2, TwoStopBits /*! Two stop bits instead of one */ = 0x4 }; - //! @brief Speed of PISerial + //! \brief Speed of PISerial enum Speed { S50 /*! 50 baud */ = 50, S75 /*! 75 baud */ = 75, @@ -72,26 +72,26 @@ public: S4000000 /*! 4000000 baud */ = 4000000 }; - //! @brief Information about serial device + //! \brief Information about serial device struct PIP_EXPORT DeviceInfo { DeviceInfo(); - //! @brief String representation of USB ID in format \"xxxx:xxxx\" + //! \brief String representation of USB ID in format \"xxxx:xxxx\" PIString id() const; - //! @brief USB Vendor ID + //! \brief USB Vendor ID uint vID; - //! @brief USB Product ID + //! \brief USB Product ID uint pID; - //! @brief Path to device, e.g. "COM2" or "/dev/ttyUSB0" + //! \brief Path to device, e.g. "COM2" or "/dev/ttyUSB0" PIString path; - //! @brief Device description + //! \brief Device description PIString description; - //! @brief Device manufacturer + //! \brief Device manufacturer PIString manufacturer; }; @@ -187,42 +187,42 @@ public: PIString read(int size = -1, double timeout_ms = 1000.); PIByteArray readData(int size = -1, double timeout_ms = 1000.); - //! @brief Write to device data "data" with maximum size "size" and wait for data written if "wait" is \b true. + //! \brief Write to device data "data" with maximum size "size" and wait for data written if "wait" is \b true. //! \returns \b true if sended bytes count = "size" bool send(const void * data, int size); - //! @brief Write to device byte array "data" + //! \brief Write to device byte array "data" //! \returns \b true if sended bytes count = size of string bool send(const PIByteArray & data) {return send(data.data(), data.size_s());} - //! @brief Returns all available speeds for serial devices + //! \brief Returns all available speeds for serial devices static PIVector availableSpeeds(); - //! @brief Returns all available system devices path. If "test" each device will be tried to open + //! \brief Returns all available system devices path. If "test" each device will be tried to open static PIStringList availableDevices(bool test = false); - //! @brief Returns all available system devices. If "test" each device will be tried to open + //! \brief Returns all available system devices. If "test" each device will be tried to open static PIVector availableDevicesInfo(bool test = false); //! \ioparams //! \{ #ifdef DOXYGEN - //! @brief device, default "" + //! \brief device, default "" string device; - //! @brief input/output speed, default 115200 + //! \brief input/output speed, default 115200 int speed; - //! @brief dataBitsCount, default 8 + //! \brief dataBitsCount, default 8 int dataBitsCount; - //! @brief parityControl, default false + //! \brief parityControl, default false bool parityControl; - //! @brief parityOdd, default false + //! \brief parityOdd, default false bool parityOdd; - //! @brief twoStopBits, default false + //! \brief twoStopBits, default false bool twoStopBits; #endif //! \} diff --git a/libs/main/io_devices/pisharedmemory.cpp b/libs/main/io_devices/pisharedmemory.cpp index 2b5c3f70..daaaa2c2 100644 --- a/libs/main/io_devices/pisharedmemory.cpp +++ b/libs/main/io_devices/pisharedmemory.cpp @@ -41,7 +41,7 @@ /*! \class PISharedMemory - * @brief Shared memory + * \brief Shared memory * * \section PISharedMemory_sec0 Synopsis * This class provide access to local file. You can manipulate diff --git a/libs/main/io_devices/pisharedmemory.h b/libs/main/io_devices/pisharedmemory.h index d08559f8..495739f6 100644 --- a/libs/main/io_devices/pisharedmemory.h +++ b/libs/main/io_devices/pisharedmemory.h @@ -1,5 +1,5 @@ -/*! @file pisharedmemory.h - * @brief Shared memory +/*! \file pisharedmemory.h + * \brief Shared memory */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_devices/pispi.h b/libs/main/io_devices/pispi.h index f9295235..29284a45 100644 --- a/libs/main/io_devices/pispi.h +++ b/libs/main/io_devices/pispi.h @@ -1,5 +1,5 @@ -/*! @file pispi.h - * @brief SPI device +/*! \file pispi.h + * \brief SPI device */ /* PIP - Platform Independent Primitives @@ -33,7 +33,7 @@ public: explicit PISPI(const PIString & path = PIString(), uint speed_hz = 1000000, PIIODevice::DeviceMode mode = PIIODevice::ReadWrite); virtual ~PISPI(); - //! @brief Parameters of PISPI + //! \brief Parameters of PISPI enum Parameters { ClockInverse /*! SPI clk polarity control*/ = 0x1, ClockPhaseShift /*! SPI clk phase control */ = 0x2, diff --git a/libs/main/io_devices/pitransparentdevice.cpp b/libs/main/io_devices/pitransparentdevice.cpp index 6b6e5f39..42f1a609 100644 --- a/libs/main/io_devices/pitransparentdevice.cpp +++ b/libs/main/io_devices/pitransparentdevice.cpp @@ -21,7 +21,7 @@ /*! \class PITransparentDevice - * @brief PIIODevice that pass write to read + * \brief PIIODevice that pass write to read * * \section PITransparentDevice_sec0 Synopsis * This class pass all data from \a write() function to \a read(). diff --git a/libs/main/io_devices/pitransparentdevice.h b/libs/main/io_devices/pitransparentdevice.h index cc023e12..4b49eb4b 100644 --- a/libs/main/io_devices/pitransparentdevice.h +++ b/libs/main/io_devices/pitransparentdevice.h @@ -1,5 +1,5 @@ -/*! @file pitransparentdevice.h - * @brief PIIODevice that pass write to read +/*! \file pitransparentdevice.h + * \brief PIIODevice that pass write to read */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_devices/piusb.h b/libs/main/io_devices/piusb.h index 0658dc01..5ba47d8c 100644 --- a/libs/main/io_devices/piusb.h +++ b/libs/main/io_devices/piusb.h @@ -1,5 +1,5 @@ -/*! @file piusb.h - * @brief USB device +/*! \file piusb.h + * \brief USB device */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_utils/pibasetransfer.h b/libs/main/io_utils/pibasetransfer.h index cbf58b06..988cdef9 100644 --- a/libs/main/io_utils/pibasetransfer.h +++ b/libs/main/io_utils/pibasetransfer.h @@ -1,5 +1,5 @@ -/*! @file pibasetransfer.h - * @brief Base class for reliable send and receive data in fixed packets with error correction, pause and resume +/*! \file pibasetransfer.h + * \brief Base class for reliable send and receive data in fixed packets with error correction, pause and resume */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_utils/pibroadcast.h b/libs/main/io_utils/pibroadcast.h index a9787aa2..67008007 100644 --- a/libs/main/io_utils/pibroadcast.h +++ b/libs/main/io_utils/pibroadcast.h @@ -1,5 +1,5 @@ -/*! @file pibroadcast.h - * @brief Broadcast for all interfaces, including loopback +/*! \file pibroadcast.h + * \brief Broadcast for all interfaces, including loopback */ /* PIP - Platform Independent Primitives @@ -117,7 +117,7 @@ public: //! \{ //! \fn void receiveEvent(PIByteArray data) - //! @brief Raise on packet received + //! \brief Raise on packet received //! \} diff --git a/libs/main/io_utils/piconnection.cpp b/libs/main/io_utils/piconnection.cpp index 17c05ec2..c82d8c7c 100644 --- a/libs/main/io_utils/piconnection.cpp +++ b/libs/main/io_utils/piconnection.cpp @@ -21,7 +21,7 @@ #include "piconfig.h" /** \class PIConnection - * @brief Complex Input/Output point + * \brief Complex Input/Output point * * \section PIConnection_synopsis Synopsis * %PIConnection provides abstract layer over physical devices, diff --git a/libs/main/io_utils/piconnection.h b/libs/main/io_utils/piconnection.h index 1a40a4a0..f6be10bd 100644 --- a/libs/main/io_utils/piconnection.h +++ b/libs/main/io_utils/piconnection.h @@ -1,5 +1,5 @@ -/*! @file piconnection.h - * @brief Complex I/O point +/*! \file piconnection.h + * \brief Complex I/O point */ /* PIP - Platform Independent Primitives @@ -43,11 +43,11 @@ public: ~PIConnection(); - /*! @brief Configure connection from config file "config" from section "name". Returns if configuration was successful + /*! \brief Configure connection from config file "config" from section "name". Returns if configuration was successful * \details \b Warning: all devices, filters and channels removed before configure! */ bool configureFromConfig(const PIString & config, const PIString & name = PIStringAscii("connection")); - /*! @brief Configure connection from config content "string" from section "name". Returns if configuration was successful + /*! \brief Configure connection from config content "string" from section "name". Returns if configuration was successful * \details \b Warning: all devices, filters and channels removed before configure! */ bool configureFromString(PIString * string, const PIString & name = PIStringAscii("connection")); @@ -55,7 +55,7 @@ public: PIString makeConfig() const; - /*! @brief Add device with full path "full_path", open mode "mode" to Device pool and connection + /*! \brief Add device with full path "full_path", open mode "mode" to Device pool and connection * \details Returns pointer to device or null if device can not be created. If "start" is true, * read thread is started immediately. Else, you can start read thread with functions \a startThreadedRead() * or \a startAllThreadedReads(). By default, read thread doesn`t start */ @@ -65,12 +65,12 @@ public: PIStringList deviceNames(const PIIODevice * dev) const; - /*! @brief Remove device with full path "full_path" from connection + /*! \brief Remove device with full path "full_path" from connection * \details Returns if device was removed. If there is no connection bounded to this device, * it will be removed from Device pool */ bool removeDevice(const PIString & full_path); - /*! @brief Remove all device from connection + /*! \brief Remove all device from connection * \details If there is no connection bounded to there devices, they removed from Device pool */ void removeAllDevices(); @@ -83,7 +83,7 @@ public: //! Returns all devices bounded to this connection PIVector boundedDevices() const; - /*! @brief Add filter with name "name" to device with full path "full_path_name" or filter "full_path_name" + /*! \brief Add filter with name "name" to device with full path "full_path_name" or filter "full_path_name" * \details If there is no filter with name "name", connection create new with split mode "mode" and bound * to it device "full_path_name" or filter "full_path_name". If filter with name "name" already exists, * device "full_path_name" or filter "full_path_name" add to this filter. @@ -100,7 +100,7 @@ public: //! Add filter with "filter" to device "dev" PIPacketExtractor * addFilter(PIPacketExtractor * filter, const PIIODevice * dev) {return addFilter(filter, devFPath(dev));} - /*! @brief Remove from filter with name "name" device with full path "full_path_name" or filter "full_path_name" + /*! \brief Remove from filter with name "name" device with full path "full_path_name" or filter "full_path_name" * \details If there is no devices bounded to this filter, it will be removed. Returns if device was removed */ bool removeFilter(const PIString & name, const PIString & full_path_name); @@ -125,7 +125,7 @@ public: //! Returns all devices bounded to filter "name" PIVector filterBoundedDevices(const PIString & name) const; - /*! @brief Add to connection channel from "name_from" to "name_to" + /*! \brief Add to connection channel from "name_from" to "name_to" * \details "name_from" and "name_to" can be full pathes of devices or device names or filter names. * Returns \b false if there if no such device or filter, else create channel and returns \b true */ bool addChannel(const PIString & name_from, const PIString & name_to); @@ -139,7 +139,7 @@ public: //! Add to connection channel from "dev_from" to "dev_to" bool addChannel(const PIIODevice * dev_from, const PIIODevice * dev_to) {return addChannel(devFPath(dev_from), devFPath(dev_to));} - /*! @brief Remove from connection channel from "name_from" to "name_to" + /*! \brief Remove from connection channel from "name_from" to "name_to" * \details "name_from" and "name_to" can be full pathes of devices or filter names. * Returns \b false if there if no such device or filter, else remove channel and returns \b true */ bool removeChannel(const PIString & name_from, const PIString & name_to); @@ -153,7 +153,7 @@ public: //! Remove from connection channel from "dev_from" to "dev_to" bool removeChannel(const PIIODevice * dev_from, const PIIODevice * dev_to) {return removeChannel(devFPath(dev_from), devFPath(dev_to));} - /*! @brief Remove from connection all channels from "name_from" + /*! \brief Remove from connection all channels from "name_from" * \details "name_from" can be full path of device or filter name. * Returns \b false if there if no such device or filter, else remove channels and returns \b true */ bool removeChannel(const PIString & name_from); @@ -167,7 +167,7 @@ public: //! Returns all channels of this connection as full pathes or filter names pair array (from, to) PIVector > channels() const; - /*! @brief Add to connection sender with name "name" device with full path "full_path" + /*! \brief Add to connection sender with name "name" device with full path "full_path" * \details If there is no sender with name "name", connection create new, bound * to it device "full_path_name" and start sender timer with frequency "frequency". * If sender with name "name" already exists, device "full_path_name" add to this sender @@ -179,7 +179,7 @@ public: //! Add to connection sender with name "name" device "dev" void addSender(const PIString & name, const PIIODevice * dev, float frequency, bool start = false) {addSender(name, devFPath(dev), frequency, start);} - /*! @brief Remove from sender with name "name" device with full path "full_path_name" + /*! \brief Remove from sender with name "name" device with full path "full_path_name" * \details If there is no devices bounded to this sender, it will be removed. Returns if sender was removed */ bool removeSender(const PIString & name, const PIString & full_path_name); @@ -321,13 +321,13 @@ public: //! \{ //! \fn void dataReceivedEvent(const PIString & from, const PIByteArray & data) - //! @brief Raise on data received from device with full path "from" + //! \brief Raise on data received from device with full path "from" //! \fn void packetReceivedEvent(const PIString & from, const PIByteArray & data) - //! @brief Raise on packet received from filter with name "from" + //! \brief Raise on packet received from filter with name "from" //! \fn void qualityChanged(const PIIODevice * device, PIDiagnostics::Quality new_quality, PIDiagnostics::Quality old_quality) - //! @brief Raise on diagnostic quality of device "device" changed from "old_quality" to "new_quality" + //! \brief Raise on diagnostic quality of device "device" changed from "old_quality" to "new_quality" //! \} diff --git a/libs/main/io_utils/pidatatransfer.h b/libs/main/io_utils/pidatatransfer.h index 5a4b62ad..dd8480d7 100644 --- a/libs/main/io_utils/pidatatransfer.h +++ b/libs/main/io_utils/pidatatransfer.h @@ -1,5 +1,5 @@ -/*! @file pidatatransfer.h - * @brief Class for send and receive PIByteArray via \a PIBaseTransfer +/*! \file pidatatransfer.h + * \brief Class for send and receive PIByteArray via \a PIBaseTransfer */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_utils/pidiagnostics.cpp b/libs/main/io_utils/pidiagnostics.cpp index 7ba08c3e..bb54d881 100644 --- a/libs/main/io_utils/pidiagnostics.cpp +++ b/libs/main/io_utils/pidiagnostics.cpp @@ -21,7 +21,7 @@ /** \class PIDiagnostics - * @brief Connection quality diagnostics + * \brief Connection quality diagnostics * \details * \section PIDiagnostics_sec0 Synopsis * This class provide abstract connection quality diagnostics and diff --git a/libs/main/io_utils/pidiagnostics.h b/libs/main/io_utils/pidiagnostics.h index b6af71d2..71da060a 100644 --- a/libs/main/io_utils/pidiagnostics.h +++ b/libs/main/io_utils/pidiagnostics.h @@ -1,5 +1,5 @@ -/*! @file pidiagnostics.h - * @brief Connection quality diagnostics +/*! \file pidiagnostics.h + * \brief Connection quality diagnostics */ /* PIP - Platform Independent Primitives @@ -102,23 +102,23 @@ public: //! \{ //! \fn void start(double msecs = 1000.) - //! @brief Start diagnostics evaluations with period "msecs" milliseconds + //! \brief Start diagnostics evaluations with period "msecs" milliseconds //! \fn void reset() - //! @brief Reset diagnostics counters + //! \brief Reset diagnostics counters //! \fn void received(int size, bool correct = true) - //! @brief Notify diagnostics about "correct" corected received packet + //! \brief Notify diagnostics about "correct" corected received packet //! \fn void sended(int size) - //! @brief Notify diagnostics about sended packet + //! \brief Notify diagnostics about sended packet //! \} //! \events //! \{ //! \fn void qualityChanged(PIDiagnostics::Quality new_quality, PIDiagnostics::Quality old_quality) - //! @brief Raise on change receive quality from "old_quality" to "new_quality" + //! \brief Raise on change receive quality from "old_quality" to "new_quality" //! \} diff --git a/libs/main/io_utils/piethutilbase.h b/libs/main/io_utils/piethutilbase.h index f18b3a5a..fc564004 100644 --- a/libs/main/io_utils/piethutilbase.h +++ b/libs/main/io_utils/piethutilbase.h @@ -1,5 +1,5 @@ -/*! @file piethutilbase.h - * @brief Base class for ethernet utils +/*! \file piethutilbase.h + * \brief Base class for ethernet utils */ /* PIP - Platform Independent Primitives @@ -56,11 +56,11 @@ public: protected: - /*! @brief Returns encrypted data if layer enabled, + /*! \brief Returns encrypted data if layer enabled, * otherwise returns unchanged \"data\" */ PIByteArray cryptData(const PIByteArray & data); - /*! @brief Returns decrypted data if layer enabled, + /*! \brief Returns decrypted data if layer enabled, * otherwise returns unchanged \"data\". If decryption * was unsuccessfull returns empty %PIByteArray. */ PIByteArray decryptData(const PIByteArray & data); diff --git a/libs/main/io_utils/pifiletransfer.h b/libs/main/io_utils/pifiletransfer.h index 8ed18d6a..254454a0 100644 --- a/libs/main/io_utils/pifiletransfer.h +++ b/libs/main/io_utils/pifiletransfer.h @@ -1,5 +1,5 @@ -/*! @file pifiletransfer.h - * @brief Class for send and receive files and directories via \a PIBaseTransfer +/*! \file pifiletransfer.h + * \brief Class for send and receive files and directories via \a PIBaseTransfer */ /* PIP - Platform Independent Primitives diff --git a/libs/main/io_utils/pipacketextractor.cpp b/libs/main/io_utils/pipacketextractor.cpp index 0a15880b..996ad08f 100644 --- a/libs/main/io_utils/pipacketextractor.cpp +++ b/libs/main/io_utils/pipacketextractor.cpp @@ -21,7 +21,7 @@ /** \class PIPacketExtractor - * @brief Packets extractor + * \brief Packets extractor * \details * \section PIPacketExtractor_main Synopsis * This class implements packet recognition by various algorithms and custom diff --git a/libs/main/io_utils/pipacketextractor.h b/libs/main/io_utils/pipacketextractor.h index 4fd3eba5..52657bf9 100644 --- a/libs/main/io_utils/pipacketextractor.h +++ b/libs/main/io_utils/pipacketextractor.h @@ -1,5 +1,5 @@ -/*! @file pipacketextractor.h - * @brief Packets extractor +/*! \file pipacketextractor.h + * \brief Packets extractor */ /* PIP - Platform Independent Primitives @@ -130,27 +130,27 @@ public: //! \{ //! \fn void packetReceived(uchar * data, int size) - //! @brief Raise on successfull \a packetValidate() function + //! \brief Raise on successfull \a packetValidate() function //! \} protected: - /** @brief Function to validate header + /** \brief Function to validate header * \param src Your header content * \param rec Received header * \param size Header size * \details Default implementation returns by-byte "src" with "rec" compare result */ virtual bool validateHeader(uchar * src, uchar * rec, int size) {if (ret_func_header != 0) return ret_func_header(ret_data_, src, rec, size); for (int i = 0; i < size; ++i) if (src[i] != rec[i]) return false; return true;} - /** @brief Function to validate footer + /** \brief Function to validate footer * \param src Your footer content * \param rec Received footer * \param size Footer size * \details Default implementation returns by-byte "src" with "rec" compare result */ virtual bool validateFooter(uchar * src, uchar * rec, int size) {if (ret_func_footer != 0) return ret_func_footer(ret_data_, src, rec, size); for (int i = 0; i < size; ++i) if (src[i] != rec[i]) return false; return true;} - /** @brief Function to validate payload + /** \brief Function to validate payload * \param rec Received payload * \param size payload size * \details Default implementation returns \b true */ diff --git a/libs/main/io_utils/piparsehelper.h b/libs/main/io_utils/piparsehelper.h index df0f2524..a44eec1a 100644 --- a/libs/main/io_utils/piparsehelper.h +++ b/libs/main/io_utils/piparsehelper.h @@ -1,5 +1,5 @@ -/*! @file piparsehelper.h - * @brief Helper class to automate structs receive +/*! \file piparsehelper.h + * \brief Helper class to automate structs receive */ /* PIP - Platform Independent Primitives @@ -28,7 +28,7 @@ /** \class PIParseHelper - * @brief Helper class to automate structs receive + * \brief Helper class to automate structs receive * * * \section PIParseHelper_synopsis Synopsis @@ -85,11 +85,11 @@ template class PIParseHelper { public: - //! @brief Construct %PIParseHelper with target object \"p\" + //! \brief Construct %PIParseHelper with target object \"p\" PIParseHelper(PIObject * p): parent(p) {} - //! @brief Assign key \"key\" to event handler \"handler\" with 1 argument + //! \brief Assign key \"key\" to event handler \"handler\" with 1 argument template void assign(Key key, Ret(*handler)(void*,T)) { if (!parent) return; @@ -110,7 +110,7 @@ public: } - //! @brief Assign key \"key\" to event handler \"handler\" without arguments + //! \brief Assign key \"key\" to event handler \"handler\" without arguments template void assign(Key key, Ret(*handler)(void*)) { if (!parent) return; @@ -130,7 +130,7 @@ public: } - //! @brief Assign key \"key\" to lambda-function \"func\" with 1 argument + //! \brief Assign key \"key\" to lambda-function \"func\" with 1 argument //! \note Important! Direct lambda functions are not allowed, see \ref PIParseHelper_lambda template void assign(Key key, std::function func) { @@ -145,7 +145,7 @@ public: } - //! @brief Assign key \"key\" to lambda-function \"func\" without arguments + //! \brief Assign key \"key\" to lambda-function \"func\" without arguments //! \note Important! Direct lambda functions are not allowed, see \ref PIParseHelper_lambda void assign(Key key, std::function func) { if (!parent) return; @@ -156,7 +156,7 @@ public: } - //! @brief Deserialize data and invoke assigned to \"key\" methods + //! \brief Deserialize data and invoke assigned to \"key\" methods void parse(Key key, PIByteArray ba) { if (!parent) return; auto fl = functions.value(key); diff --git a/libs/main/io_utils/pistreampacker.h b/libs/main/io_utils/pistreampacker.h index 933c0c0d..834c6cb1 100644 --- a/libs/main/io_utils/pistreampacker.h +++ b/libs/main/io_utils/pistreampacker.h @@ -1,5 +1,5 @@ -/*! @file pistreampacker.h - * @brief Simple packet wrap aroud any PIIODevice +/*! \file pistreampacker.h + * \brief Simple packet wrap aroud any PIIODevice */ /* PIP - Platform Independent Primitives @@ -90,7 +90,7 @@ public: //! \{ //! \fn void received(uchar * readed, int size) - //! @brief Handler to receive data. \a PIIODevice::threadedReadEvent() + //! \brief Handler to receive data. \a PIIODevice::threadedReadEvent() //! can be connected to this handler //! \} @@ -99,10 +99,10 @@ public: //! \{ //! \fn void packetReceiveEvent(PIByteArray data) - //! @brief Raise on packet successfully received + //! \brief Raise on packet successfully received //! \fn void sendRequest(PIByteArray data) - //! @brief Raise from \a send() function. This data should + //! \brief Raise from \a send() function. This data should //! be directly sended to your device. You can //! connect this event to \a PIIODevice::write() handler diff --git a/libs/main/lua/piluaprogram.h b/libs/main/lua/piluaprogram.h index cec94678..3b2cf5da 100644 --- a/libs/main/lua/piluaprogram.h +++ b/libs/main/lua/piluaprogram.h @@ -1,5 +1,5 @@ -/*! @file piluaprogram.h - * @brief Lua Program +/*! \file piluaprogram.h + * \brief Lua Program */ /* PIP - Platform Independent Primitives diff --git a/libs/main/lua/pip_lua.h b/libs/main/lua/pip_lua.h index 0f7b216d..a9b94167 100644 --- a/libs/main/lua/pip_lua.h +++ b/libs/main/lua/pip_lua.h @@ -1,5 +1,5 @@ -/*! @file pip_lua.h - * @brief PIP Lua bindings +/*! \file pip_lua.h + * \brief PIP Lua bindings * * This file declare conversions for PIP types via LuaBridge */ diff --git a/libs/main/math/picrc.h b/libs/main/math/picrc.h index ebac8013..e18f9440 100644 --- a/libs/main/math/picrc.h +++ b/libs/main/math/picrc.h @@ -1,5 +1,5 @@ -/*! @file picrc.h - * @brief CRC checksum calculator +/*! \file picrc.h + * \brief CRC checksum calculator */ /* PIP - Platform Independent Primitives diff --git a/libs/main/math/pievaluator.cpp b/libs/main/math/pievaluator.cpp index 521d758f..6e8e4272 100644 --- a/libs/main/math/pievaluator.cpp +++ b/libs/main/math/pievaluator.cpp @@ -21,7 +21,7 @@ /*! \class PIEvaluator - * @brief This class provide mathematical evaluations of custom expression + * \brief This class provide mathematical evaluations of custom expression * * \section PIEvaluator_sec0 Synopsis * %PIEvaluator developed for stream evaluations of once set expression. diff --git a/libs/main/math/pievaluator.h b/libs/main/math/pievaluator.h index 23c32188..bad7ab48 100644 --- a/libs/main/math/pievaluator.h +++ b/libs/main/math/pievaluator.h @@ -1,5 +1,5 @@ -/*! @file pievaluator.h - * @brief Mathematic expressions calculator +/*! \file pievaluator.h + * \brief Mathematic expressions calculator */ /* PIP - Platform Independent Primitives diff --git a/libs/main/math/pifft.h b/libs/main/math/pifft.h index d06f8101..10428201 100644 --- a/libs/main/math/pifft.h +++ b/libs/main/math/pifft.h @@ -1,5 +1,5 @@ -/*! @file pifft.h - * @brief Class for FFT, IFFT and Hilbert transformations +/*! \file pifft.h + * \brief Class for FFT, IFFT and Hilbert transformations */ /* PIP - Platform Independent Primitives diff --git a/libs/main/math/pigeometry.h b/libs/main/math/pigeometry.h index 685dd03d..65bf39d1 100644 --- a/libs/main/math/pigeometry.h +++ b/libs/main/math/pigeometry.h @@ -1,5 +1,5 @@ -/*! @file pigeometry.h - * @brief Geometry base class +/*! \file pigeometry.h + * \brief Geometry base class */ /* PIP - Platform Independent Primitives diff --git a/libs/main/math/pimathbase.h b/libs/main/math/pimathbase.h index 8ad5d569..ee845dd8 100644 --- a/libs/main/math/pimathbase.h +++ b/libs/main/math/pimathbase.h @@ -1,5 +1,5 @@ -/*! @file pimathbase.h - * @brief Basic mathematical functions and defines +/*! \file pimathbase.h + * \brief Basic mathematical functions and defines */ /* PIP - Platform Independent Primitives diff --git a/libs/main/math/pimathcomplex.h b/libs/main/math/pimathcomplex.h index 4dcfaea5..cec45505 100644 --- a/libs/main/math/pimathcomplex.h +++ b/libs/main/math/pimathcomplex.h @@ -1,5 +1,5 @@ -/*! @file pimathcomplex.h - * @brief PIP math complex +/*! \file pimathcomplex.h + * \brief PIP math complex */ /* PIP - Platform Independent Primitives @@ -89,7 +89,7 @@ inline PIVector2D abs(const PIVector2D & v) { /** -* @brief floating point number specific comparison between value passed as parameter and zero +* \brief floating point number specific comparison between value passed as parameter and zero * * @param v floating point parameter for comparison * @return true if v in locality of zero, otherwise false @@ -101,7 +101,7 @@ inline bool PIMathFloatNullCompare(const T v) { } /** -* @brief floating point number specific comparison between parameter value and zero. +* \brief floating point number specific comparison between parameter value and zero. * * @param v complex with floating point real and imag parts * @return true if absolute of v in locality of zero, otherwise false diff --git a/libs/main/math/pimathmatrix.h b/libs/main/math/pimathmatrix.h index 6119ce70..c149acf6 100644 --- a/libs/main/math/pimathmatrix.h +++ b/libs/main/math/pimathmatrix.h @@ -1,5 +1,5 @@ -/*! @file pimathmatrix.h - * @brief PIMathMatrix +/*! \file pimathmatrix.h + * \brief PIMathMatrix * * This file declare math matrix class, which performs various matrix operations */ @@ -37,7 +37,7 @@ #pragma pack(push, 1) -//! @brief A class that works with square matrix operations, the input data of which are columns, rows and the data type of the matrix +//! \brief A class that works with square matrix operations, the input data of which are columns, rows and the data type of the matrix //! @tparam Rows rows number of matrix //! @tparam Сols columns number of matrix //! @tparam Type is the data type of the matrix. There are can be basic C++ language data and different classes where the arithmetic operators(=, +=, -=, *=, /=, ==, !=, +, -, *, /) @@ -53,12 +53,12 @@ class PIP_EXPORT PIMathMatrixT { static_assert(Cols > 0, "Column count must be > 0"); public: /** - * @brief Constructs PIMathMatrixT that is filled by \a new_value + * \brief Constructs PIMathMatrixT that is filled by \a new_value */ PIMathMatrixT(const Type &new_value = Type()) {PIMM_FOR m[r][c] = new_value;} /** - * @brief Contructs PIMathMatrixT from PIVector + * \brief Contructs PIMathMatrixT from PIVector */ PIMathMatrixT(const PIVector &val) { assert(Rows*Cols == val.size()); @@ -67,7 +67,7 @@ public: } /** - * @brief Contructs PIMathMatrixT from C++11 initializer list + * \brief Contructs PIMathMatrixT from C++11 initializer list */ PIMathMatrixT(std::initializer_list init_list) { assert(Rows*Cols == init_list.size()); @@ -76,7 +76,7 @@ public: } /** - * @brief Сreates a matrix whose main diagonal is filled with ones and the remaining elements are zeros + * \brief Сreates a matrix whose main diagonal is filled with ones and the remaining elements are zeros * * @return identity matrix of type PIMathMatrixT */ @@ -87,21 +87,21 @@ public: } /** - * @brief Method which returns number of columns in matrix + * \brief Method which returns number of columns in matrix * * @return type uint shows number of columns */ constexpr uint cols() const {return Cols;} /** - * @brief Method which returns number of rows in matrix + * \brief Method which returns number of rows in matrix * * @return type uint shows number of rows */ constexpr uint rows() const {return Rows;} /** - * @brief Method which returns the selected column in PIMathVectorT format. + * \brief Method which returns the selected column in PIMathVectorT format. * If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param index is the number of the selected column @@ -114,7 +114,7 @@ public: } /** - * @brief Method which returns the selected row in PIMathVectorT format + * \brief Method which returns the selected row in PIMathVectorT format * If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param index is the number of the selected row @@ -127,7 +127,7 @@ public: } /** - * @brief Set the selected column in matrix. + * \brief Set the selected column in matrix. * If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param index is the number of the selected column @@ -140,7 +140,7 @@ public: } /** - * @brief Set the selected row in matrix + * \brief Set the selected row in matrix * If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param index is the number of the selected row @@ -153,7 +153,7 @@ public: } /** - * @brief Method which changes selected rows in a matrix. + * \brief Method which changes selected rows in a matrix. * If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param rf is the number of the first selected row @@ -166,7 +166,7 @@ public: } /** - * @brief Method which changes selected columns in a matrix. + * \brief Method which changes selected columns in a matrix. * If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param cf is the number of the first selected column @@ -179,7 +179,7 @@ public: } /** - * @brief Method which fills the matrix with selected value + * \brief Method which fills the matrix with selected value * * @param v is a parameter the type and value of which is selected and later filled into the matrix * @return filled matrix type _CMatrix @@ -190,14 +190,14 @@ public: } /** - * @brief Method which checks if matrix is square + * \brief Method which checks if matrix is square * * @return true if matrix is square, else false */ constexpr bool isSquare() const { return Rows == Cols; } /** - * @brief Method which checks if main diagonal of matrix consists of ones and another elements are zeros + * \brief Method which checks if main diagonal of matrix consists of ones and another elements are zeros * * @return true if matrix is identitied, else false */ @@ -207,7 +207,7 @@ public: } /** - * @brief Method which checks if every elements of matrix are zeros + * \brief Method which checks if every elements of matrix are zeros * * @return true if matrix is null, else false */ @@ -218,7 +218,7 @@ public: /** - * @brief Read-only access to element by \a row and \a col. + * \brief Read-only access to element by \a row and \a col. * If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param row of matrix @@ -228,7 +228,7 @@ public: Type at(uint row, uint col) const { return m[row][col]; } /** - * @brief Full access to element by \a row and \a col. + * \brief Full access to element by \a row and \a col. * If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param row of matrix @@ -238,7 +238,7 @@ public: inline Type & element(uint row, uint col) {return m[row][col];} /** - * @brief Read-only access to element by \a row and \a col. + * \brief Read-only access to element by \a row and \a col. * If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param row of matrix @@ -248,7 +248,7 @@ public: inline const Type & element(uint row, uint col) const {return m[row][col];} /** - * @brief Full access to the matrix row pointer. If you enter an index out of the border of the matrix there will be "undefined behavior" + * \brief Full access to the matrix row pointer. If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param row of matrix * @return matrix row pointer @@ -256,7 +256,7 @@ public: Type *operator[](uint row) { return m[row]; } /** - * @brief Read-only access to the matrix row pointer. If you enter an index out of the border of the matrix there will be "undefined behavior" + * \brief Read-only access to the matrix row pointer. If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param row of matrix * @return matrix row pointer @@ -264,7 +264,7 @@ public: const Type *operator[](uint row) const {return m[row];} /** - * @brief Matrix compare + * \brief Matrix compare * * @param sm matrix for compare * @return if matrices are equal true, else false @@ -275,7 +275,7 @@ public: } /** - * @brief Matrix negative compare + * \brief Matrix negative compare * * @param sm matrix for compare * @return if matrices are not equal true, else false @@ -283,21 +283,21 @@ public: bool operator!=(const _CMatrix &sm) const { return !(*this == sm); } /** - * @brief Addition assignment with matrix "sm" + * \brief Addition assignment with matrix "sm" * * @param sm matrix for the addition assigment */ void operator+=(const _CMatrix &sm) {PIMM_FOR m[r][c] += sm.m[r][c];} /** - * @brief Subtraction assignment with matrix "sm" + * \brief Subtraction assignment with matrix "sm" * * @param sm matrix for the subtraction assigment */ void operator-=(const _CMatrix &sm) {PIMM_FOR m[r][c] -= sm.m[r][c];} /** - * @brief Multiplication assignment with value "v" + * \brief Multiplication assignment with value "v" * * @param v value for the multiplication assigment */ @@ -306,7 +306,7 @@ public: } /** - * @brief Division assignment with value "v" + * \brief Division assignment with value "v" * * @param v value for the division assigment */ @@ -316,7 +316,7 @@ public: } /** - * @brief Matrix substraction + * \brief Matrix substraction * * @return the result of matrix substraction */ @@ -327,7 +327,7 @@ public: } /** - * @brief Matrix addition + * \brief Matrix addition * * @param sm is matrix term * @return the result of matrix addition @@ -339,7 +339,7 @@ public: } /** - * @brief Matrix substraction + * \brief Matrix substraction * * @param sm is matrix subtractor * @return the result of matrix substraction @@ -351,7 +351,7 @@ public: } /** - * @brief Matrix multiplication + * \brief Matrix multiplication * * @param v is value factor * @return the result of matrix multiplication @@ -363,7 +363,7 @@ public: } /** - * @brief Matrix division + * \brief Matrix division * * @param v is value divider * @return the result of matrix division @@ -376,7 +376,7 @@ public: } /** - * @brief Determinant of the matrix is ​​calculated. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Determinant of the matrix is ​​calculated. Works only with square matrix, nonzero matrices and invertible matrix * * @param ok is a parameter with which we can find out if the method worked correctly * @return matrix determinant @@ -394,7 +394,7 @@ public: } /** - * @brief Trace of the matrix is calculated. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Trace of the matrix is calculated. Works only with square matrix, nonzero matrices and invertible matrix * * @return matrix trace */ @@ -408,7 +408,7 @@ public: } /** - * @brief Transforming matrix to upper triangular. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Transforming matrix to upper triangular. Works only with square matrix, nonzero matrices and invertible matrix * * @param ok is a parameter with which we can find out if the method worked correctly * @return copy of transformed upper triangular matrix @@ -448,7 +448,7 @@ public: } /** - * @brief Matrix inversion operation. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Matrix inversion operation. Works only with square matrix, nonzero matrices and invertible matrix * * @param ok is a parameter with which we can find out if the method worked correctly * @return copy of inverted matrix @@ -502,7 +502,7 @@ public: } /** - * @brief Matrix inversion operation. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Matrix inversion operation. Works only with square matrix, nonzero matrices and invertible matrix * * @param ok is a parameter with which we can find out if the method worked correctly * @return inverted matrix @@ -514,7 +514,7 @@ public: } /** - * @brief Matrix transposition operation. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Matrix transposition operation. Works only with square matrix, nonzero matrices and invertible matrix * * @return transposed matrix */ @@ -525,7 +525,7 @@ public: } /** - * @brief Matrix rotation operation. Works only with 2x2 matrix + * \brief Matrix rotation operation. Works only with 2x2 matrix * * @return rotated matrix */ @@ -565,7 +565,7 @@ inline std::ostream & operator <<(std::ostream & s, const PIMathMatrixT &m) { } /** -* @brief Multiplying matrices by each other. If you enter an index out of the border of the matrix there will be "undefined behavior" +* \brief Multiplying matrices by each other. If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param fm first matrix multiplier * @param sm second matrix multiplier @@ -609,7 +609,7 @@ inline PIMathMatrixT operator*(const PIMathMatrixT operator*(const PIMathMatrixT } /** -* @brief Multiplying vector and matrix. If you enter an index out of the border of the matrix there will be "undefined behavior" +* \brief Multiplying vector and matrix. If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param sv first vector multiplier * @param fm second matrix multiplier @@ -651,7 +651,7 @@ inline PIMathVectorT operator*(const PIMathVectorT &sv, } /** -* @brief Multiplying value of type Type and matrix +* \brief Multiplying value of type Type and matrix * * @param x first multiplier of type Type * @param fm second matrix multiplier @@ -689,7 +689,7 @@ class PIMathMatrix; #define PIMM_FOR_C for (uint i = 0; i < _V2D::cols_; ++i) #define PIMM_FOR_R for (uint i = 0; i < _V2D::rows_; ++i) -//! @brief A class that works with matrix operations, the input data of which is the data type of the matrix +//! \brief A class that works with matrix operations, the input data of which is the data type of the matrix //! @tparam There are can be basic C++ language data and different classes where the arithmetic operators(=, +=, -=, *=, /=, ==, !=, +, -, *, /) //! of the C++ language are implemented template @@ -698,7 +698,7 @@ class PIP_EXPORT PIMathMatrix : public PIVector2D { typedef PIMathMatrix _CMatrix; public: /** - * @brief Constructor of class PIMathMatrix, which creates a matrix + * \brief Constructor of class PIMathMatrix, which creates a matrix * * @param cols is number of matrix column uint type * @param rows is number of matrix row uint type @@ -707,7 +707,7 @@ public: PIMathMatrix(const uint cols = 0, const uint rows = 0, const Type &f = Type()) { _V2D::resize(rows, cols, f); } /** - * @brief Constructor of class PIMathMatrix, which creates a matrix + * \brief Constructor of class PIMathMatrix, which creates a matrix * * @param cols is number of matrix column uint type * @param rows is number of matrix row uint type @@ -720,7 +720,7 @@ public: } /** - * @brief Constructor of class PIMathMatrix, which creates a matrix + * \brief Constructor of class PIMathMatrix, which creates a matrix * * @param val is PIVector of PIVector, which creates matrix */ @@ -736,7 +736,7 @@ public: } /** - * @brief Constructor of class PIMathMatrix, which creates a matrix + * \brief Constructor of class PIMathMatrix, which creates a matrix * * @param val is PIVector2D, which creates matrix */ @@ -748,7 +748,7 @@ public: } /** - * @brief Creates a matrix whose main diagonal is filled with ones and the remaining elements are zeros + * \brief Creates a matrix whose main diagonal is filled with ones and the remaining elements are zeros * * @param cols is number of matrix column uint type * @param rows is number of matrix row uint type @@ -761,7 +761,7 @@ public: } /** - * @brief Creates a row matrix of every element that is equal to every element of the vector + * \brief Creates a row matrix of every element that is equal to every element of the vector * * @param val is the vector type PIMathVector * @return row matrix of every element that is equal to every element of the vector @@ -769,7 +769,7 @@ public: static _CMatrix matrixRow(const PIMathVector &val) {return _CMatrix(val.size(), 1, val.toVector());} /** - * @brief Creates a column matrix of every element that is equal to every element of the vector + * \brief Creates a column matrix of every element that is equal to every element of the vector * * @param val is the vector type PIMathVector * @return column matrix of every element that is equal to every element of the vector @@ -777,7 +777,7 @@ public: static _CMatrix matrixCol(const PIMathVector &val) {return _CMatrix(1, val.size(), val.toVector());} /** - * @brief Set the selected column in matrix. If there are more elements of the vector than elements in the column of the matrix + * \brief Set the selected column in matrix. If there are more elements of the vector than elements in the column of the matrix * or index larger than the number of columns otherwise there will be "undefined behavior" * * @param index is the number of the selected column @@ -791,7 +791,7 @@ public: } /** - * @brief Set the selected row in matrix. If there are more elements of the vector than elements in the row of the matrix, + * \brief Set the selected row in matrix. If there are more elements of the vector than elements in the row of the matrix, * or index larger than the number of rows otherwise there will be "undefined behavior" * @param index is the number of the selected row * @param v is a vector of the type _CMCol that needs to fill the row @@ -804,7 +804,7 @@ public: } /** - * @brief Method which replace selected columns in a matrix. You cannot use an index larger than the number of columns, + * \brief Method which replace selected columns in a matrix. You cannot use an index larger than the number of columns, * otherwise there will be "undefined behavior" * * @param r0 is the number of the first selected row @@ -817,7 +817,7 @@ public: } /** - * @brief Method which replace selected rows in a matrix. You cannot use an index larger than the number of rows, + * \brief Method which replace selected rows in a matrix. You cannot use an index larger than the number of rows, * otherwise there will be "undefined behavior" * * @param c0 is the number of the first selected row @@ -830,7 +830,7 @@ public: } /** - * @brief Method which fills the matrix with selected value + * \brief Method which fills the matrix with selected value * * @param v is a parameter the type and value of which is selected and later filled into the matrix * @return filled matrix type _CMatrix @@ -841,14 +841,14 @@ public: } /** - * @brief Method which checks if matrix is square + * \brief Method which checks if matrix is square * * @return true if matrix is square, else false */ bool isSquare() const { return _V2D::cols_ == _V2D::rows_; } /** - * @brief Method which checks if main diagonal of matrix consists of ones and another elements are zeros + * \brief Method which checks if main diagonal of matrix consists of ones and another elements are zeros * * @return true if matrix is identity, else false */ @@ -858,7 +858,7 @@ public: } /** - * @brief Method which checks if every elements of matrix are zeros + * \brief Method which checks if every elements of matrix are zeros * * @return true if matrix elements equal to zero, else false */ @@ -868,14 +868,14 @@ public: } /** - * @brief Method which checks if matrix is empty + * \brief Method which checks if matrix is empty * * @return true if matrix is valid, else false */ bool isValid() const { return !PIVector2D::isEmpty(); } /** - * @brief Addition assignment with matrix "sm" + * \brief Addition assignment with matrix "sm" * * @param sm matrix for the addition assigment */ @@ -886,7 +886,7 @@ public: } /** - * @brief Subtraction assignment with matrix "sm" + * \brief Subtraction assignment with matrix "sm" * * @param sm matrix for the subtraction assigment */ @@ -897,7 +897,7 @@ public: } /** - * @brief Multiplication assignment with value "v" + * \brief Multiplication assignment with value "v" * * @param v value for the multiplication assigment */ @@ -906,7 +906,7 @@ public: } /** - * @brief Division assignment with value "v" + * \brief Division assignment with value "v" * * @param v value for the division assigment */ @@ -916,7 +916,7 @@ public: } /** - * @brief Matrix substraction + * \brief Matrix substraction * * @return the result of matrix substraction */ @@ -927,7 +927,7 @@ public: } /** - * @brief Matrix addition + * \brief Matrix addition * * @param sm is matrix term * @return the result of matrix addition @@ -941,7 +941,7 @@ public: } /** - * @brief Matrix subtraction + * \brief Matrix subtraction * * @param sm is matrix subtractor * @return the result of matrix subtraction @@ -955,7 +955,7 @@ public: } /** - * @brief Matrix multiplication + * \brief Matrix multiplication * * @param v is value factor * @return the result of matrix multiplication @@ -967,7 +967,7 @@ public: } /** - * @brief Matrix division + * \brief Matrix division * * @param v is value divider * @return the result of matrix division @@ -980,7 +980,7 @@ public: } /** - * @brief Determinant of the self matrix is ​​calculated. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Determinant of the self matrix is ​​calculated. Works only with square matrix, nonzero matrices and invertible matrix * * @param ok is a parameter with which we can find out if the method worked correctly * @return matrix determinant @@ -1001,7 +1001,7 @@ public: } /** - * @brief Trace of the matrix is calculated. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Trace of the matrix is calculated. Works only with square matrix, nonzero matrices and invertible matrix * * @return matrix trace */ @@ -1015,7 +1015,7 @@ public: } /** - * @brief Transforming matrix to upper triangular. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Transforming matrix to upper triangular. Works only with square matrix, nonzero matrices and invertible matrix * * @param ok is a parameter with which we can find out if the method worked correctly * @return copy of transformed upper triangular matrix @@ -1055,7 +1055,7 @@ public: } /** - * @brief Matrix inversion operation. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Matrix inversion operation. Works only with square matrix, nonzero matrices and invertible matrix * * @param ok is a parameter with which we can find out if the method worked correctly * @param sv is a vector multiplier @@ -1114,7 +1114,7 @@ public: } /** - * @brief Matrix inversion operation. Works only with square matrix, nonzero matrices and invertible matrix + * \brief Matrix inversion operation. Works only with square matrix, nonzero matrices and invertible matrix * * @param ok is a parameter with which we can find out if the method worked correctly * @return inverted matrix @@ -1126,7 +1126,7 @@ public: } /** - * @brief Matrix transposition operation + * \brief Matrix transposition operation * * @return transposed matrix */ @@ -1144,7 +1144,7 @@ inline std::ostream & operator <<(std::ostream & s, const PIMathMatrix & m #endif /** -* @brief Inline operator for outputting the matrix to the console +* \brief Inline operator for outputting the matrix to the console * * @param s PICout type * @param the matrix type PIMathMatrix that we print to the console @@ -1165,7 +1165,7 @@ inline PICout operator<<(PICout s, const PIMathMatrix &m) { } /** -* @brief Inline operator for serializing a matrix into a PIByteArray +* \brief Inline operator for serializing a matrix into a PIByteArray * * @param s PIByteArray type * @param v PIMathMatrix type @@ -1178,7 +1178,7 @@ inline PIByteArray &operator<<(PIByteArray &s, const PIMathMatrix &v) { } /** -* @brief Inline operator to deserialize matrix from PIByteArray +* \brief Inline operator to deserialize matrix from PIByteArray * * @param s PIByteArray type * @param v PIMathMatrix type @@ -1192,7 +1192,7 @@ inline PIByteArray &operator>>(PIByteArray &s, PIMathMatrix &v) { /** -* @brief Multiplying matrices by each other. If you enter an index out of the border of the matrix there will be "undefined behavior" +* \brief Multiplying matrices by each other. If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param fm first matrix multiplier * @param sm second matrix multiplier @@ -1216,7 +1216,7 @@ inline PIMathMatrix operator*(const PIMathMatrix &fm, } /** -* @brief Multiplying matrix and vector. If you enter an index out of the border of the matrix there will be "undefined behavior" +* \brief Multiplying matrix and vector. If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param fm first matrix multiplier * @param sv second vector multiplier @@ -1238,7 +1238,7 @@ inline PIMathVector operator*(const PIMathMatrix &fm, } /** -* @brief Multiplying vector and matrix. If you enter an index out of the border of the matrix there will be "undefined behavior" +* \brief Multiplying vector and matrix. If you enter an index out of the border of the matrix there will be "undefined behavior" * * @param sv first vector multiplier * @param fm second matrix multiplier @@ -1260,7 +1260,7 @@ inline PIMathVector operator*(const PIMathVector &sv, } /** -* @brief Multiplying value of type Type and matrix +* \brief Multiplying value of type Type and matrix * * @param x first multiplier of type Type * @param v second matrix multiplier @@ -1275,7 +1275,7 @@ typedef PIMathMatrix PIMathMatrixi; typedef PIMathMatrix PIMathMatrixd; /** -* @brief Searching hermitian matrix +* \brief Searching hermitian matrix * * @param m conjugate transpose matrix * @return result of the hermitian diff --git a/libs/main/math/pimathsolver.h b/libs/main/math/pimathsolver.h index 7d6c57f7..5d030c20 100644 --- a/libs/main/math/pimathsolver.h +++ b/libs/main/math/pimathsolver.h @@ -1,5 +1,5 @@ -/*! @file pimathsolver.h - * @brief PIMathSolver +/*! \file pimathsolver.h + * \brief PIMathSolver */ /* PIP - Platform Independent Primitives diff --git a/libs/main/math/pimathvector.h b/libs/main/math/pimathvector.h index 4f19cc89..9a5d0166 100644 --- a/libs/main/math/pimathvector.h +++ b/libs/main/math/pimathvector.h @@ -1,5 +1,5 @@ -/*! @file pimathvector.h - * @brief PIMathVector +/*! \file pimathvector.h + * \brief PIMathVector */ /* PIP - Platform Independent Primitives diff --git a/libs/main/math/piquaternion.h b/libs/main/math/piquaternion.h index d975f234..4cfb6f1f 100644 --- a/libs/main/math/piquaternion.h +++ b/libs/main/math/piquaternion.h @@ -1,5 +1,5 @@ -/*! @file piquaternion.h - * @brief Class for quaternions +/*! \file piquaternion.h + * \brief Class for quaternions */ /* PIP - Platform Independent Primitives diff --git a/libs/main/math/pistatistic.h b/libs/main/math/pistatistic.h index 27897ea6..8d731842 100644 --- a/libs/main/math/pistatistic.h +++ b/libs/main/math/pistatistic.h @@ -1,5 +1,5 @@ -/*! @file pistatistic.h - * @brief Class for calculating math statistic in values array +/*! \file pistatistic.h + * \brief Class for calculating math statistic in values array */ /* PIP - Platform Independent Primitives diff --git a/libs/main/resources/piresources.h b/libs/main/resources/piresources.h index 428ec7b1..6fca0431 100644 --- a/libs/main/resources/piresources.h +++ b/libs/main/resources/piresources.h @@ -1,5 +1,5 @@ -/*! @file piresources.h - * @brief Resources subsystem +/*! \file piresources.h + * \brief Resources subsystem */ /* PIP - Platform Independent Primitives diff --git a/libs/main/system/pilibrary.h b/libs/main/system/pilibrary.h index e5ec0845..e98cdcbc 100644 --- a/libs/main/system/pilibrary.h +++ b/libs/main/system/pilibrary.h @@ -1,5 +1,5 @@ -/*! @file pilibrary.h -* @brief Dynamic library +/*! \file pilibrary.h +* \brief Dynamic library */ /* PIP - Platform Independent Primitives diff --git a/libs/main/system/piplugin.cpp b/libs/main/system/piplugin.cpp index beef10b7..25f9fb60 100644 --- a/libs/main/system/piplugin.cpp +++ b/libs/main/system/piplugin.cpp @@ -25,7 +25,7 @@ #include "piincludes_p.h" /*! \class PIPluginLoader - * @brief Plugin loader + * \brief Plugin loader * * \section PIPluginLoader_sec0 Synopsis * This class provides several macro to define plugin and %PIPluginLoader - class diff --git a/libs/main/system/piplugin.h b/libs/main/system/piplugin.h index 0b240efb..90f2879f 100644 --- a/libs/main/system/piplugin.h +++ b/libs/main/system/piplugin.h @@ -1,5 +1,5 @@ -/*! @file piplugin.h -* @brief Plugin helpers +/*! \file piplugin.h +* \brief Plugin helpers */ /* PIP - Platform Independent Primitives diff --git a/libs/main/system/piprocess.h b/libs/main/system/piprocess.h index 3d60aeff..96945273 100644 --- a/libs/main/system/piprocess.h +++ b/libs/main/system/piprocess.h @@ -1,5 +1,5 @@ -/*! @file piprocess.h -* @brief Process +/*! \file piprocess.h +* \brief Process */ /* PIP - Platform Independent Primitives diff --git a/libs/main/system/pisignals.h b/libs/main/system/pisignals.h index 3027c691..7709c355 100644 --- a/libs/main/system/pisignals.h +++ b/libs/main/system/pisignals.h @@ -1,5 +1,5 @@ -/*! @file pisignals.h - * @brief System signals +/*! \file pisignals.h + * \brief System signals */ /* PIP - Platform Independent Primitives diff --git a/libs/main/thread/piblockingqueue.h b/libs/main/thread/piblockingqueue.h index c630ea21..200ebc17 100644 --- a/libs/main/thread/piblockingqueue.h +++ b/libs/main/thread/piblockingqueue.h @@ -24,7 +24,7 @@ #include "piconditionvar.h" /** - * @brief A Queue that supports operations that wait for the queue to become non-empty when retrieving an element, and + * \brief A Queue that supports operations that wait for the queue to become non-empty when retrieving an element, and * wait for space to become available in the queue when storing an element. */ template @@ -32,7 +32,7 @@ class PIBlockingQueue: private PIQueue { public: /** - * @brief Constructor + * \brief Constructor */ explicit inline PIBlockingQueue(size_t capacity = SIZE_MAX, PIConditionVariable* cond_var_add = new PIConditionVariable(), @@ -40,7 +40,7 @@ public: : cond_var_add(cond_var_add), cond_var_rem(cond_var_rem), max_size(capacity) { } /** - * @brief Copy constructor. Initialize queue with copy of other queue elements. Not thread-safe for other queue. + * \brief Copy constructor. Initialize queue with copy of other queue elements. Not thread-safe for other queue. */ explicit inline PIBlockingQueue(const PIDeque& other) : cond_var_add(new PIConditionVariable()), cond_var_rem(new PIConditionVariable()) { mutex.lock(); @@ -50,7 +50,7 @@ public: } /** - * @brief Thread-safe copy constructor. Initialize queue with copy of other queue elements. + * \brief Thread-safe copy constructor. Initialize queue with copy of other queue elements. */ inline PIBlockingQueue(PIBlockingQueue & other) : cond_var_add(new PIConditionVariable()), cond_var_rem(new PIConditionVariable()) { other.mutex.lock(); @@ -67,7 +67,7 @@ public: } /** - * @brief Inserts the specified element into this queue, waiting if necessary for space to become available. + * \brief Inserts the specified element into this queue, waiting if necessary for space to become available. * * @param v the element to add */ @@ -83,7 +83,7 @@ public: PIBlockingQueue & enqueue(const T & v) {return put(v);} /** - * @brief Inserts the specified element at the end of this queue if it is possible to do so immediately without + * \brief Inserts the specified element at the end of this queue if it is possible to do so immediately without * exceeding the queue's capacity, returning true upon success and false if this queue is full. * * @param v the element to add @@ -104,7 +104,7 @@ public: } /** - * @brief Retrieves and removes the head of this queue, waiting if necessary until an element becomes available. + * \brief Retrieves and removes the head of this queue, waiting if necessary until an element becomes available. * * @return the head of this queue */ @@ -121,7 +121,7 @@ public: T dequeue() {return take();} /** - * @brief Retrieves and removes the head of this queue, waiting up to the specified wait time if necessary for an + * \brief Retrieves and removes the head of this queue, waiting up to the specified wait time if necessary for an * element to become available. * * @param timeoutMs how long to wait before giving up, in milliseconds @@ -146,7 +146,7 @@ public: } /** - * @brief Returns the number of elements that this queue can ideally (in the absence of memory or resource + * \brief Returns the number of elements that this queue can ideally (in the absence of memory or resource * constraints) contains. This is always equal to the initial capacity of this queue less the current size of this queue. * * @return the capacity @@ -160,7 +160,7 @@ public: } /** - * @brief Returns the number of additional elements that this queue can ideally (in the absence of memory or resource + * \brief Returns the number of additional elements that this queue can ideally (in the absence of memory or resource * constraints) accept. This is always equal to the initial capacity of this queue less the current size of this queue. * * @return the remaining capacity @@ -173,7 +173,7 @@ public: } /** - * @brief Returns the number of elements in this collection. + * \brief Returns the number of elements in this collection. */ size_t size() { mutex.lock(); @@ -183,7 +183,7 @@ public: } /** - * @brief Removes all available elements from this queue and adds them to other given queue. + * \brief Removes all available elements from this queue and adds them to other given queue. */ size_t drainTo(PIDeque& other, size_t maxCount = SIZE_MAX) { mutex.lock(); @@ -194,7 +194,7 @@ public: } /** - * @brief Removes all available elements from this queue and adds them to other given queue. + * \brief Removes all available elements from this queue and adds them to other given queue. */ size_t drainTo(PIBlockingQueue& other, size_t maxCount = SIZE_MAX) { mutex.lock(); diff --git a/libs/main/thread/piconditionvar.h b/libs/main/thread/piconditionvar.h index 0e988e32..87aed74a 100644 --- a/libs/main/thread/piconditionvar.h +++ b/libs/main/thread/piconditionvar.h @@ -24,7 +24,7 @@ /** - * @brief A condition variable is an object able to block the calling thread until notified to resume. + * \brief A condition variable is an object able to block the calling thread until notified to resume. * * It uses a PIMutex to lock the thread when one of its wait functions is called. The thread remains * blocked until woken up by another thread that calls a notification function on the same PIConditionVariable object. @@ -36,24 +36,24 @@ public: virtual ~PIConditionVariable(); /** - * @brief Unblocks one of the threads currently waiting for this condition. If no threads are waiting, the function + * \brief Unblocks one of the threads currently waiting for this condition. If no threads are waiting, the function * does nothing. If more than one, it is unspecified which of the threads is selected. */ void notifyOne(); /** - * @brief Unblocks all threads currently waiting for this condition. If no threads are waiting, the function does + * \brief Unblocks all threads currently waiting for this condition. If no threads are waiting, the function does * nothing. */ void notifyAll(); /** - * @brief see wait(PIMutex &, const std::function&) + * \brief see wait(PIMutex &, const std::function&) */ virtual void wait(PIMutex & lk); /** - * @brief Wait until notified + * \brief Wait until notified * * The execution of the current thread (which shall have locked with lk method PIMutex::lock()) is blocked * until notified. @@ -79,12 +79,12 @@ public: virtual void wait(PIMutex& lk, const std::function& condition); /** - * @brief see waitFor(PIMutex &, int, const std::function&) + * \brief see waitFor(PIMutex &, int, const std::function&) */ virtual bool waitFor(PIMutex & lk, int timeoutMs); /** - * @brief Wait for timeout or until notified + * \brief Wait for timeout or until notified * * The execution of the current thread (which shall have locked with lk method PIMutex::lock()) is blocked * during timeoutMs, or until notified (if the latter happens first). diff --git a/libs/main/thread/pigrabberbase.h b/libs/main/thread/pigrabberbase.h index 6bb2843b..a19776aa 100644 --- a/libs/main/thread/pigrabberbase.h +++ b/libs/main/thread/pigrabberbase.h @@ -1,5 +1,5 @@ -/*! @file pigrabberbase.h - * @brief Abstract class for create grabbers +/*! \file pigrabberbase.h + * \brief Abstract class for create grabbers */ /* PIP - Platform Independent Primitives diff --git a/libs/main/thread/pimutex.cpp b/libs/main/thread/pimutex.cpp index db42b86f..bea01ef2 100644 --- a/libs/main/thread/pimutex.cpp +++ b/libs/main/thread/pimutex.cpp @@ -18,7 +18,7 @@ */ /** \class PIMutex - * @brief Mutex + * \brief Mutex * \details * \section PIMutex_sec0 Synopsis * %PIMutex provides synchronization blocks between several threads. diff --git a/libs/main/thread/pimutex.h b/libs/main/thread/pimutex.h index 847d5eb6..af66fa1f 100644 --- a/libs/main/thread/pimutex.h +++ b/libs/main/thread/pimutex.h @@ -1,5 +1,5 @@ -/*! @file pimutex.h - * @brief PIMutex, PIMutexLocker +/*! \file pimutex.h + * \brief PIMutex, PIMutexLocker */ /* PIP - Platform Independent Primitives @@ -38,16 +38,16 @@ public: ~PIMutex(); - //! @brief Lock mutex + //! \brief Lock mutex //! \details If mutex is unlocked it set to locked state and returns immediate. //! If mutex is already locked function blocks until mutex will be unlocked void lock(); - //! @brief Unlock mutex + //! \brief Unlock mutex //! \details In any case this function returns immediate void unlock() ; - //! @brief Try to lock mutex + //! \brief Try to lock mutex //! \details If mutex is unlocked it set to locked state and returns "true" immediate. //! If mutex is already locked function returns immediate an returns "false" bool tryLock(); @@ -63,7 +63,7 @@ private: }; -//! @brief PIMutexLocker +//! \brief PIMutexLocker //! \details Same as std::lock_guard. //! When a PIMutexLocker object is created, it attempts to lock the mutex it is given, if "condition" true. //! When control leaves the scope in which the PIMutexLocker object was created, diff --git a/libs/main/thread/pipipelinethread.h b/libs/main/thread/pipipelinethread.h index fd300cb1..91321df3 100644 --- a/libs/main/thread/pipipelinethread.h +++ b/libs/main/thread/pipipelinethread.h @@ -1,5 +1,5 @@ -/*! @file pipipelinethread.h - * @brief Class for create multihread pipeline +/*! \file pipipelinethread.h + * \brief Class for create multihread pipeline */ /* PIP - Platform Independent Primitives diff --git a/libs/main/thread/pispinlock.cpp b/libs/main/thread/pispinlock.cpp index 1b547538..3262f39b 100644 --- a/libs/main/thread/pispinlock.cpp +++ b/libs/main/thread/pispinlock.cpp @@ -18,7 +18,7 @@ */ /** \class PISpinlock - * @brief Spinlock + * \brief Spinlock * \details * \section PISpinlock_sec0 Synopsis * %PISpinlock provides synchronization blocks between several threads. diff --git a/libs/main/thread/pispinlock.h b/libs/main/thread/pispinlock.h index ecc90dc7..6de315c4 100644 --- a/libs/main/thread/pispinlock.h +++ b/libs/main/thread/pispinlock.h @@ -1,5 +1,5 @@ -/*! @file pispinlock.h - * @brief PISpinlock +/*! \file pispinlock.h + * \brief PISpinlock */ /* PIP - Platform Independent Primitives @@ -39,12 +39,12 @@ public: ~PISpinlock() {} - //! @brief Lock spinlock + //! \brief Lock spinlock //! \details If spinlock is unlocked it set to locked state and returns immediate. //! If spinlock is already locked function blocks until spinlock will be unlocked void lock() {while (flag.test_and_set(std::memory_order_acquire));} - //! @brief Unlock spinlock + //! \brief Unlock spinlock //! \details In any case this function returns immediate void unlock() {flag.clear(std::memory_order_release);} @@ -54,7 +54,7 @@ private: }; -//! @brief PISpinlockLocker +//! \brief PISpinlockLocker //! \details //! When a PISpinlockLocker object is created, it attempts to lock the spinlock it is given, if "condition" true. //! When control leaves the scope in which the PISpinlockLocker object was created, diff --git a/libs/main/thread/pithread.cpp b/libs/main/thread/pithread.cpp index e1eb1f4d..11e6531e 100644 --- a/libs/main/thread/pithread.cpp +++ b/libs/main/thread/pithread.cpp @@ -55,7 +55,7 @@ __THREAD_FUNC_RET__ thread_function_once(void * t) {((PIThread*)t)->__thread_fun #endif /*! \class PIThread - * @brief Thread class + * \brief Thread class * \details This class allow you exec your code in separate thread. * * \section PIThread_sec0 Synopsis diff --git a/libs/main/thread/pithread.h b/libs/main/thread/pithread.h index 6d676f68..9eaa6afa 100644 --- a/libs/main/thread/pithread.h +++ b/libs/main/thread/pithread.h @@ -1,5 +1,5 @@ -/*! @file pithread.h - * @brief Thread +/*! \file pithread.h + * \brief Thread * * This file declare thread class and some wait functions */ @@ -105,25 +105,25 @@ public: EVENT_HANDLER1(void, stop, bool, wait); EVENT_HANDLER0(void, terminate); - //! @brief Set common data passed to external function + //! \brief Set common data passed to external function void setData(void * d) {data_ = d;} - //! @brief Set external function that will be executed after every \a run() + //! \brief Set external function that will be executed after every \a run() void setSlot(ThreadFunc func) {ret_func = func;} - //! @brief Set external function that will be executed after every \a run() + //! \brief Set external function that will be executed after every \a run() void setSlot(std::function func) {ret_func = [func](void*){func();};} - //! @brief Set priority of thread + //! \brief Set priority of thread void setPriority(PIThread::Priority prior); - //! @brief Returns common data passed to external function + //! \brief Returns common data passed to external function void * data() const {return data_;} - //! @brief Return priority of thread + //! \brief Return priority of thread PIThread::Priority priority() const {return priority_;} - //! @brief Return \c true if thread is running + //! \brief Return \c true if thread is running bool isRunning() const {return running_;} bool isStopping() const {return running_ && terminating;} @@ -133,19 +133,19 @@ public: EVENT_HANDLER0(bool, waitForFinish) {return waitForFinish(-1);} EVENT_HANDLER1(bool, waitForFinish, int, timeout_msecs); - //! @brief Set necessity of lock every \a run with internal mutex + //! \brief Set necessity of lock every \a run with internal mutex void needLockRun(bool need) {lockRun = need;} - //! @brief Lock internal mutex + //! \brief Lock internal mutex EVENT_HANDLER0(void, lock) const {thread_mutex.lock();} - //! @brief Unlock internal mutex + //! \brief Unlock internal mutex EVENT_HANDLER0(void, unlock) const {thread_mutex.unlock();} - //! @brief Returns internal mutex + //! \brief Returns internal mutex PIMutex & mutex() const {return thread_mutex;} - //! @brief Returns thread ID + //! \brief Returns thread ID llong tid() const {return tid_;} void __thread_func__(); @@ -154,12 +154,12 @@ public: EVENT(started) EVENT(stopped) - //! @brief Start event handler with name \"handler\" of object \"object\" + //! \brief Start event handler with name \"handler\" of object \"object\" //! in separate thread with name \"name\" //! and automatically delete it on function finish static void runOnce(PIObject * object, const char * handler, const PIString & name = PIString()); - //! @brief Start function \"func\" in separate thread with name \"name\" + //! \brief Start function \"func\" in separate thread with name \"name\" //! and automatically delete it on function finish static void runOnce(std::function func, const PIString & name = PIString()); @@ -167,7 +167,7 @@ public: //! \{ /** \fn bool start(int timer_delay = -1) - * @brief Start thread + * \brief Start thread * \details Start execution of \a run() in internal loop with * "timer_delay" delay in milliseconds. If "timer_delay" <= 0 * there is no delay in loop. Thread also exec external function @@ -176,58 +176,58 @@ public: * \return \c false if thread already started or can`t start thread */ /** \fn bool startOnce() - * @brief Start thread without internal loop + * \brief Start thread without internal loop * \details Start execution of \a run() once. Thread also exec * external function set by \a setSlot() if it`s not null * * \return \c false if thread already started or can`t start thread */ /** \fn bool startOnce(ThreadFunc func) - * @brief Start thread without internal loop + * \brief Start thread without internal loop * \details Overloaded function. Set external function "func" before start * * \return \c false if thread already started or can`t start thread */ /** \fn void stop(bool wait = false) - * @brief Stop thread + * \brief Stop thread * \details Stop execution of thread and wait for it finish * if "wait" is \c true. This function can block for infinite * time if "wait" is \c true and any of thread function is * busy forever */ /** \fn void terminate() - * @brief Strongly stop thread + * \brief Strongly stop thread * \details Stop execution of thread immediately */ /** \fn bool waitForStart(int timeout_msecs = -1) - * @brief Wait for thread start + * \brief Wait for thread start * \details This function block until thread start for "timeout_msecs" * or forever if "timeout_msecs" < 0 * * \return \c false if timeout is exceeded */ /** \fn bool waitForFinish(int timeout_msecs = -1) - * @brief Wait for thread finish + * \brief Wait for thread finish * \details This function block until thread finish for "timeout_msecs" * or forever if "timeout_msecs" < 0 * * \return \c false if timeout is exceeded */ //! \fn void lock() - //! @brief Lock internal mutex + //! \brief Lock internal mutex //! \fn void unlock() - //! @brief Unlock internal mutex + //! \brief Unlock internal mutex //! \} //! \events //! \{ //! \fn void started() - //! @brief Raise on thread start + //! \brief Raise on thread start //! \fn void stopped() - //! @brief Raise on thread stop + //! \brief Raise on thread stop //! \} diff --git a/libs/main/thread/pithreadnotifier.h b/libs/main/thread/pithreadnotifier.h index 5755fc7c..0f13d30b 100644 --- a/libs/main/thread/pithreadnotifier.h +++ b/libs/main/thread/pithreadnotifier.h @@ -1,5 +1,5 @@ -/*! @file pithreadnotifier.h - * @brief Class for simply notify and wait in different threads +/*! \file pithreadnotifier.h + * \brief Class for simply notify and wait in different threads */ /* PIP - Platform Independent Primitives diff --git a/libs/main/thread/pithreadpoolexecutor.cpp b/libs/main/thread/pithreadpoolexecutor.cpp index ea0eb9aa..0f0c3bac 100644 --- a/libs/main/thread/pithreadpoolexecutor.cpp +++ b/libs/main/thread/pithreadpoolexecutor.cpp @@ -20,7 +20,7 @@ #include "pithreadpoolexecutor.h" /*! \class PIThreadPoolExecutor - * @brief Thread pools address two different problems: they usually provide improved performance when executing large + * \brief Thread pools address two different problems: they usually provide improved performance when executing large * numbers of asynchronous tasks, due to reduced per-task invocation overhead, and they provide a means of bounding and * managing the resources, including threads, consumed when executing a collection of tasks. */ diff --git a/libs/main/thread/pithreadpoolexecutor.h b/libs/main/thread/pithreadpoolexecutor.h index 70c5850b..e5a97d33 100644 --- a/libs/main/thread/pithreadpoolexecutor.h +++ b/libs/main/thread/pithreadpoolexecutor.h @@ -31,7 +31,7 @@ public: virtual ~PIThreadPoolExecutor(); /** - * @brief Executes the given task sometime in the future. The task execute in an existing pooled thread. If the task + * \brief Executes the given task sometime in the future. The task execute in an existing pooled thread. If the task * cannot be submitted for execution, either because this executor has been shutdown or because its capacity has been * reached. * @@ -42,7 +42,7 @@ public: void shutdownNow(); /** - * @brief Initiates an orderly shutdown in which previously submitted tasks are executed, but no new tasks will be + * \brief Initiates an orderly shutdown in which previously submitted tasks are executed, but no new tasks will be * accepted. Invocation has no additional effect if already shut down. This method does not wait for previously * submitted tasks to complete execution. Use awaitTermination to do that. */ diff --git a/libs/main/thread/pithreadpoolloop.cpp b/libs/main/thread/pithreadpoolloop.cpp index b829469b..050acd15 100644 --- a/libs/main/thread/pithreadpoolloop.cpp +++ b/libs/main/thread/pithreadpoolloop.cpp @@ -23,7 +23,7 @@ /*! \class PIThreadPoolLoop - * @brief Thread class + * \brief Thread class * \details This class allow you parallelize loop. * * \section PIThreadPoolLoop_sec0 Usage diff --git a/libs/main/thread/pithreadpoolloop.h b/libs/main/thread/pithreadpoolloop.h index 30938d66..49368caa 100644 --- a/libs/main/thread/pithreadpoolloop.h +++ b/libs/main/thread/pithreadpoolloop.h @@ -1,5 +1,5 @@ -/*! @file pithreadpoolloop.h - * @brief Thread pool loop +/*! \file pithreadpoolloop.h + * \brief Thread pool loop * * This file declare thread class and some wait functions */ diff --git a/libs/main/thread/pitimer.cpp b/libs/main/thread/pitimer.cpp index 83e94885..b2a1edac 100644 --- a/libs/main/thread/pitimer.cpp +++ b/libs/main/thread/pitimer.cpp @@ -25,7 +25,7 @@ /*! \class PITimer - * @brief Timer + * \brief Timer * * \section PITimer_sec0 Synopsis * This class implements timer function. PIP timers supports 3 way to tick notify, diff --git a/libs/main/thread/pitimer.h b/libs/main/thread/pitimer.h index fc076b50..842af062 100644 --- a/libs/main/thread/pitimer.h +++ b/libs/main/thread/pitimer.h @@ -1,5 +1,5 @@ -/*! @file pitimer.h - * @brief Timer +/*! \file pitimer.h + * \brief Timer */ /* PIP - Platform Independent Primitives @@ -39,7 +39,7 @@ public: double interval() const {return interval_;} void setInterval(double i); - //! @brief Return \c true if thread is running + //! \brief Return \c true if thread is running bool isRunning() const {return running_;} bool isStopped() const {return !running_;} @@ -76,10 +76,10 @@ class PIP_EXPORT PITimer: public PIObject { public: NO_COPY_CLASS(PITimer) - //! @brief Constructs timer with PITimer::Thread implementation + //! \brief Constructs timer with PITimer::Thread implementation explicit PITimer(); - //! @brief Timer implementations + //! \brief Timer implementations enum TimerImplementation { Thread /*! Timer works in his own thread. Intervals are measured by the system time */ = 0x01, ThreadRT /*! Using POSIX timer with SIGEV_THREAD notification. \attention Doesn`t support on Windows and Mac OS! */ = 0x02, @@ -87,34 +87,34 @@ public: * sequentially executes all timers. \attention Use this implementation with care! */ = 0x04 }; - //! @brief Constructs timer with "ti" implementation + //! \brief Constructs timer with "ti" implementation explicit PITimer(TimerImplementation ti); - //! @brief Constructs timer with "slot" slot void(void *,int), "data" data and "ti" implementation + //! \brief Constructs timer with "slot" slot void(void *,int), "data" data and "ti" implementation explicit PITimer(TimerEvent slot, void * data = 0, TimerImplementation ti = Thread); - //! @brief Constructs timer with "slot" slot void(), and "ti" implementation + //! \brief Constructs timer with "slot" slot void(), and "ti" implementation explicit PITimer(std::function slot, TimerImplementation ti = Thread); - //! @brief Constructs timer with "slot" slot void(void *), "data" data and "ti" implementation + //! \brief Constructs timer with "slot" slot void(void *), "data" data and "ti" implementation explicit PITimer(std::function slot, void * data, TimerImplementation ti = Thread); virtual ~PITimer(); - //! @brief Returns timer implementation + //! \brief Returns timer implementation PITimer::TimerImplementation implementation() const {return imp_mode;} - //! @brief Returns timer loop delay in milliseconds + //! \brief Returns timer loop delay in milliseconds double interval() const; - //! @brief Set timer loop delay in milliseconds + //! \brief Set timer loop delay in milliseconds EVENT_HANDLER1(void, setInterval, double, ms); - //! @brief Returns if timer is started + //! \brief Returns if timer is started bool isRunning() const; - //! @brief Returns if timer is not started + //! \brief Returns if timer is not started bool isStopped() const; EVENT_HANDLER0(bool, start); @@ -123,22 +123,22 @@ public: EVENT_HANDLER0(bool, restart); - /** @brief Start timer with \b interval() loop delay after \b delay_msecs delay. + /** \brief Start timer with \b interval() loop delay after \b delay_msecs delay. * \details Timer wait \b delay_msecs milliseconds and then normally starts with * \b interval() loop delay. */ void startDeferred(double delay_ms); - /** @brief Start timer with \b interval_msecs loop delay after \b delay_msecs delay. + /** \brief Start timer with \b interval_msecs loop delay after \b delay_msecs delay. * \details Timer wait \b delay_msecs milliseconds and then normally starts with * \b interval_msecs loop delay. */ void startDeferred(double interval_ms, double delay_ms); - /** @brief Start timer with \b interval() loop delay after \b start_datetime date and time. + /** \brief Start timer with \b interval() loop delay after \b start_datetime date and time. * \details Timer wait until \b start_datetime and then normally starts with * \b interval() loop delay. */ void startDeferred(PIDateTime start_datetime); - /** @brief Start timer with \b interval_msecs loop delay after \b start_datetime date and time. + /** \brief Start timer with \b interval_msecs loop delay after \b start_datetime date and time. * \details Timer wait until \b start_datetime and then normally starts with * \b interval_msecs loop delay. */ void startDeferred(double interval_ms, PIDateTime start_datetime); @@ -148,43 +148,43 @@ public: bool waitForFinish() {return waitForFinish(-1);} bool waitForFinish(int timeout_msecs); - //! @brief Set custom data + //! \brief Set custom data void setData(void * data_) {data_t = data_;} - //! @brief Set timer tick function + //! \brief Set timer tick function void setSlot(TimerEvent slot) {ret_func = slot;} - //! @brief Set timer tick function + //! \brief Set timer tick function void setSlot(std::function slot) {ret_func = [slot](void *, int){slot();};} - //! @brief Set timer tick function + //! \brief Set timer tick function void setSlot(std::function slot) {ret_func = [slot](void *d, int){slot(d);};} - //! @brief Returns common data passed to tick functions + //! \brief Returns common data passed to tick functions void * data() const {return data_t;} void needLockRun(bool need) {lockRun = need;} EVENT_HANDLER0(void, lock) {mutex_.lock();} EVENT_HANDLER0(void, unlock) {mutex_.unlock();} - //! @brief Returns if timer should exec \a maybeCallQueuedEvents() at every tick. + //! \brief Returns if timer should exec \a maybeCallQueuedEvents() at every tick. //! By default \b true bool isCallQueuedEvents() const {return callEvents;} - //! @brief If set timer exec \a maybeCallQueuedEvents() at every tick. + //! \brief If set timer exec \a maybeCallQueuedEvents() at every tick. //! By default \b true void setCallQueuedEvents(bool yes) {callEvents = yes;} - //! @brief Add frequency delimiter \b delim with optional delimiter slot \b slot. + //! \brief Add frequency delimiter \b delim with optional delimiter slot \b slot. void addDelimiter(int delim, TimerEvent slot = 0) {delims << Delimiter(slot, delim);} - //! @brief Add frequency delimiter \b delim with optional delimiter slot \b slot. + //! \brief Add frequency delimiter \b delim with optional delimiter slot \b slot. void addDelimiter(int delim, std::function slot) {delims << Delimiter([slot](void *, int){slot();}, delim);} - //! @brief Add frequency delimiter \b delim with optional delimiter slot \b slot. + //! \brief Add frequency delimiter \b delim with optional delimiter slot \b slot. void addDelimiter(int delim, std::function slot) {delims << Delimiter([slot](void *d, int){slot(d);}, delim);} - //! @brief Remove all frequency delimiters \b delim. + //! \brief Remove all frequency delimiters \b delim. void removeDelimiter(int delim) {for (int i = 0; i < delims.size_s(); ++i) if (delims[i].delim == delim) {delims.remove(i); i--;}} EVENT_HANDLER0(void, clearDelimiters) {delims.clear();} @@ -195,30 +195,30 @@ public: //! \{ /** \fn bool start() - * @brief Start timer with \a interval() loop delay + * \brief Start timer with \a interval() loop delay * \details Start execution of timer functions with frequency = 1 / msecs Hz. */ /** \fn bool start(double msecs) - * @brief Start timer with \b msecs loop delay + * \brief Start timer with \b msecs loop delay * \details Start execution of timer functions with frequency = 1. / msecs Hz. * Instead of \a start(int msecs) function this variant allow start timer * with frequencies more than 1 kHz */ //! \fn bool restart() - //! @brief Stop and start timer with \a interval() loop delay + //! \brief Stop and start timer with \a interval() loop delay //! \fn bool stop(bool wait = true) - //! @brief Stop timer and wait for it finish if "wait" + //! \brief Stop timer and wait for it finish if "wait" //! \fn void clearDelimiters() - //! @brief Remove all frequency delimiters + //! \brief Remove all frequency delimiters //! \} //! \events //! \{ /** \fn void tickEvent(void * data, int delimiter) - * @brief Raise on timer tick + * \brief Raise on timer tick * \details \b Data can be set with function \a setData(void * data) or from constructor. * \b Delimiter is frequency delimiter, 1 for main loop. */