langutils.h

Go to the documentation of this file.

/* ============================================================
 *
 * This file is a part of RSC project
 *
 * Copyright (C) 2010 by Johannes Wienke <jwienke at techfak dot uni-bielefeld dot de>
 *
 * This file may be licensed under the terms of the
 * GNU Lesser General Public License Version 3 (the ``LGPL''),
 * or (at your option) any later version.
 *
 * Software distributed under the License is distributed
 * on an ``AS IS'' basis, WITHOUT WARRANTY OF ANY KIND, either
 * express or implied. See the LGPL for the specific language
 * governing rights and limitations.
 *
 * You should have received a copy of the LGPL along with this
 * program. If not, go to http://www.gnu.org/licenses/lgpl.html
 * or write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 * The development of this software was supported by:
 *   CoR-Lab, Research Institute for Cognition and Robotics
 *     Bielefeld University
 *
 * ============================================================ */

#pragma once

#include <string>

#include <boost/cstdint.hpp>
#include <boost/shared_ptr.hpp>

#include "rsc/rscexports.h"

namespace rsc {
namespace misc {

class RSC_EXPORT NullDeleter {
public:

    void operator()(void* ignored) const;

};

template<class ParentType>
class ParentSharedPtrDeleter {
public:
    ParentSharedPtrDeleter(boost::shared_ptr<ParentType> parent) :
            parent(parent) {
    }

    void operator()(void const *) {
        parent.reset();
    }

private:
    boost::shared_ptr<ParentType> parent;
};

RSC_EXPORT boost::uint64_t currentTimeMillis();

RSC_EXPORT boost::uint64_t currentTimeMicros();

RSC_EXPORT char randAlnumChar();

RSC_EXPORT std::string randAlnumStr(const std::string::size_type& length);

#ifdef __GNUC__
#define GCC_VERSION (__GNUC__ * 10000 \
                     + __GNUC_MINOR__ * 100 \
                     + __GNUC_PATCHLEVEL__)
#endif

#ifdef __GNUC__
#if GCC_VERSION > 40500
#define DEPRECATED_MSG(func, msg) func __attribute__ ((deprecated (#msg)))
#else
#define DEPRECATED_MSG(func, msg) func __attribute__ ((deprecated))
#endif
#elif defined(_MSC_VER)
#define DEPRECATED_MSG(func, msg) __declspec(deprecated(#msg)) func
#else
#pragma message("WARNING: You need to implement DEPRECATED for this compiler")
#define DEPRECATED_MSG(func, msg) func
#endif

#define DEPRECATED(fun) DEPRECATED_MSG(fun, "Use of deprecated construct.")

#ifdef __GNUC__
#if GCC_VERSION > 40500
#define DEPRECATED_CLASS(msg) __attribute__ ((deprecated (#msg)))
#else
#define DEPRECATED_CLASS(msg) __attribute__ ((deprecated))
#endif
#elif defined(_MSC_VER)
#define DEPRECATED_CLASS(msg) __declspec(deprecated(#msg))
#else
#pragma message("WARNING: You need to implement DEPRECATED_CLASS for this compiler")
#define DEPRECATED_CLASS(msg)
#endif

// provide static asserts that only issue a warning
// adapted from: http://stackoverflow.com/a/8990275/283649

#define PP_CAT(x,y) PP_CAT1(x,y)
#define PP_CAT1(x,y) x##y

namespace detail {

struct true_type {
};
struct false_type {
};
template<int test> struct converter: public true_type {
};
template<> struct converter<0> : public false_type {
};

}

#define STATIC_ASSERT_WARN(cond, msg) \
struct PP_CAT(static_warning,__LINE__) { \
    DEPRECATED_MSG(void _(::rsc::misc::detail::false_type const& ),msg) {}; \
    void _(::rsc::misc::detail::true_type const& ) {}; \
    PP_CAT(static_warning,__LINE__)() {_(::rsc::misc::detail::converter<(cond)>());} \
}

#define STATIC_ASSERT_WARN_TEMPLATE(token, cond, msg) \
    STATIC_ASSERT_WARN(cond, msg) PP_CAT(PP_CAT(_localvar_, token),__LINE__)

}
}