/home/rex/ebltrunk/tools/libeblearntools/include/tools_utils.h

/***************************************************************************
 *   Copyright (C) 2010 by Pierre Sermanet   *
 *   pierre.sermanet@gmail.com   *
 *   All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *     * Redistribution under a license not approved by the Open Source 
 *       Initiative (http://www.opensource.org) must display the 
 *       following acknowledgement in all advertising material:
 *        This product includes software developed at the Courant
 *        Institute of Mathematical Sciences (http://cims.nyu.edu).
 *     * The names of the authors may not be used to endorse or promote products
 *       derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED 
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL ThE AUTHORS BE LIABLE FOR ANY
 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ***************************************************************************/

#ifndef TOOLS_UTILS_H_
#define TOOLS_UTILS_H_

#include <list>
#include <string>
#include <vector>
#include <map>

#include "defines.h"
#include "idx.h"

using namespace std;

namespace ebl {

  // directory utilities

  typedef pair<string, string> stringpair;
  typedef list<stringpair> files_list;

  inline bool less_than(const stringpair& b1, const stringpair& b2);
  
  EXPORT files_list *find_files(const string &dir,
                                const char *pattern = IMAGE_PATTERN,
                                files_list *fl = NULL, bool sort = true,
                                bool recursive = true, bool randomize = false);
  
  EXPORT list<string> *find_fullfiles(const string &dir,
                                      const char *pattern = IMAGE_PATTERN,
                                      list<string> *fl = NULL, 
                                      bool sort = true,
                                      bool recursive = true, 
                                      bool randomize = false,
                                      bool finddir = false,
                                      bool fullpattern = false);
  
  EXPORT uint count_files(const string &dir, 
                          const char *pattern = IMAGE_PATTERN);

  EXPORT string increment_filename(const char *fullname, uint stride); 

  EXPORT bool string_to_bool(const string &s);
  EXPORT int string_to_int(const string &s);
  EXPORT int string_to_int(const char *s);
  EXPORT intg string_to_intg(const string &s);
  EXPORT intg string_to_intg(const char *s);
  EXPORT uint string_to_uint(const string &s);
  EXPORT uint string_to_uint(const char *s);
  EXPORT float string_to_float(const string &s);
  EXPORT float string_to_float(const char *s);
  EXPORT double string_to_double(const string &s);
  EXPORT double string_to_double(const char *s);

  EXPORT list<uint> string_to_uintlist(const string &s);
  EXPORT list<uint> string_to_uintlist(const char *s);
  EXPORT vector<int> string_to_intvector(const string &s, char sep = ',');
  EXPORT vector<int> string_to_intvector(const char *s, char sep = ',');
  EXPORT vector<uint> string_to_uintvector(const string &s, char sep = ',');
  EXPORT vector<uint> string_to_uintvector(const char *s, char sep = ',');
  EXPORT vector<intg> string_to_intgvector(const char *s, char sep = ',');
  EXPORT vector<float> string_to_floatvector(const char *s, char sep = ',');

  template <typename T>
  EXPORT idx<T> string_to_idx(const char *s, char sep = ',');
  template <typename T>
  EXPORT T string_to_number(const char *s);  
  EXPORT idxdim string_to_idxdim(const char *s, char sep = 'x');
  EXPORT fidxdim string_to_fidxdim(const char *s, char sep = 'x');
  EXPORT idxdim string_to_idxdim(const string &s, char sep = 'x');
  EXPORT midxdim string_to_idxdimvector(const char *s, char vecsep = ',',
                                        char dimsep = 'x');
  EXPORT mfidxdim string_to_fidxdimvector(const char *s, char vecsep = ',',
                                          char dimsep = 'x');

  EXPORT list<string> string_to_stringlist(const string &s, char sep = ',');
  EXPORT list<string> string_to_stringlist(const char *s, char sep = ',');
  EXPORT vector<string> string_to_stringvector(const string &s, char sep = ',');
  EXPORT vector<string> string_to_stringvector(const char *s, char sep = ',');
  EXPORT vector<double> string_to_doublevector(const string &s);
  EXPORT vector<double> string_to_doublevector(const char *s);

  template <typename T1, typename T2>
    EXPORT string map_to_string(map<T1,T2> &m);  
  template <typename T1, typename T2>
    EXPORT string map_to_string2(map<T1,T2> &m);  
  EXPORT string stringlist_to_string(list<string> &l);  
  EXPORT vector<string> ubyteidx_to_stringvector(idx<ubyte> &u);
  EXPORT string string_replaceall(const string &s, const char *s1,
                                  const char *s2);
  
  // system functions
  
  EXPORT bool tar(const string &dir, const string &tgtdir);
  EXPORT bool tar_pattern(const string &dir, const string &tgtdir,
                          const string &tgtfilename, const char *pattern);

  template <typename T>
    void list_to_vector(list<T> &l, vector<T> &v);

  EXPORT string filename(const char *s);
    
  EXPORT string system_to_string(const string &cmd);

} // end namespace ebl

#include "tools_utils.hpp"

#endif /* TOOLS_UTILS_ */