Utility.h

Go to the documentation of this file.

#ifndef _MADARA_UTILITY_H_
#define _MADARA_UTILITY_H_

#include <vector>
#include <string>
#include "ace/SOCK_Dgram.h"
#include "ace/High_Res_Timer.h"
#include "madara/MADARA_export.h"
#include "madara/utility/stdint.h"
#include "madara/knowledge/WaitSettings.h"


namespace madara
{
  namespace knowledge
  {
    class KnowledgeBase;
    struct WaitSettings;
  }

  namespace utility
  {
    MADARA_Export std::string get_version (void);
    
    MADARA_Export uint32_t get_uint_version (void);
    
    MADARA_Export std::string to_string_version (uint32_t version);
    
    MADARA_Export size_t string_replace (std::string & source,
      const std::string & old_phrase,
      const std::string & new_phrase,
      bool replace_all = true);
    
    MADARA_Export std::string & upper (std::string & input);
    
    MADARA_Export std::string & lower (std::string & input);
    
    MADARA_Export std::string & dds_topicify (std::string & input);
    
    MADARA_Export std::string & strip_white_space (std::string & input);
    
    MADARA_Export std::string & strip_comments (std::string & input);
    
    MADARA_Export std::string & string_remove (std::string & input,
      char unwanted);

    MADARA_Export std::string & strip_extra_white_space (
      std::string & input);

    MADARA_Export std::string strip_prefix (
      const std::string & input, const std::string & prefix);

    MADARA_Export int split_hostport_identifier (const std::string & key, 
      std::string & host, std::string & port);
    
    MADARA_Export int merge_hostport_identifier (std::string & key, 
      const std::string & host, const std::string & port);
    
    MADARA_Export int merge_hostport_identifier (std::string & key, 
      const std::string & host, unsigned short u_port);
    
    MADARA_Export void tokenizer (const std::string & input, 
      const ::std::vector< std::string> & splitters,
      ::std::vector< std::string> & tokens,
      ::std::vector< std::string> & pivot_list);
    
    MADARA_Export int bind_to_ephemeral_port (ACE_SOCK_Dgram & socket,
      std::string & host, unsigned short & port,
      bool increase_until_bound = true);
    
    MADARA_Export std::string file_to_string (const std::string & filename);

    MADARA_Export std::string extract_path (const std::string & name);
    
    MADARA_Export std::string extract_filename (const std::string & name);

    MADARA_Export std::string expand_envs (
      const std::string & source);

    char * get_var (const std::string & source, size_t cur, size_t & end);
    
    MADARA_Export std::string clean_dir_name (const std::string & target);
    
    MADARA_Export uint64_t endian_swap (uint64_t value);
    
    MADARA_Export int64_t endian_swap (int64_t value);
    
    MADARA_Export uint32_t endian_swap (uint32_t value);
    
    MADARA_Export int32_t endian_swap (int32_t value);
    
    MADARA_Export uint16_t endian_swap (uint16_t value);
    
    MADARA_Export int16_t endian_swap (int16_t value);
    
    MADARA_Export double endian_swap (double value);
    
    MADARA_Export int  read_file (const std::string & filename,
      void *& buffer, size_t & size, bool add_zero_char = false);
    
    MADARA_Export ssize_t write_file (const std::string & filename,
      void * buffer, size_t size);

    MADARA_Export int64_t get_time (void);

    MADARA_Export double rand_double (double floor = 0.0,
      double ceiling = 1.0, bool set_seed_to_time = true);
     
    MADARA_Export int64_t rand_int (int64_t floor = 0,
      int64_t ceiling = RAND_MAX, bool set_seed_to_time = true);

    MADARA_Export int64_t nearest_int (double input);

    MADARA_Export bool begins_with (const std::string & input,
      const std::string & prefix);
    
    MADARA_Export bool ends_with (const std::string & input,
      const std::string & ending);
    
    MADARA_Export double sleep (double sleep_time);
    
    MADARA_Export ACE_Time_Value sleep (const ACE_Time_Value & sleep_time);

    MADARA_Export bool approx_equal (
      double value1, double value2, double epsilon = 0.0001);

    MADARA_Export bool file_exists (const std::string & filename);

    MADARA_Export unsigned int file_size (const std::string & filename);
    
    MADARA_Export bool wait_true (knowledge::KnowledgeBase & knowledge,
      const std::string & variable,
      const knowledge::WaitSettings & settings =
        knowledge::WaitSettings ());

    

    MADARA_Export bool wait_false (knowledge::KnowledgeBase & knowledge,
      const std::string & variable,
      const knowledge::WaitSettings & settings =
        knowledge::WaitSettings ());
    template <typename T>
    bool less_compare (const T & left, const T & right);

    template <typename T>
    bool greater_compare (const T & left, const T & right);

    template <typename T>
    void sift_down (T * input, int start, int end,
      bool (*comparator) (const T & left, const T & right) =
        greater_compare<T>);
    
    template <typename T>
    void heapify (T * input, int size,
     bool (*comparator) (const T & left, const T & right) =
        greater_compare<T>);

    template <typename T>
    void heap_sort (T * input, int size,
     bool (*comparator) (const T & left, const T & right) =
        greater_compare<T>);

    template <typename T>
    T bitmask_add (T mask, T values);
    
    template <typename T>
    bool bitmask_check (T mask, T values);
    
    template <typename T>
    T bitmask_remove (T mask, T values);

  }
}

#include "Utility.inl"

#endif // _MADARA_UTILITY_H_