strutil.h

//-*-C++-*-
/***************************************************************************
 *
 *   Copyright (C) 1999 by Willem van Straten
 *   Licensed under the Academic Free License version 2.1
 *
 ***************************************************************************/
// psrchive/Util/genutil/strutil.h
 
#ifndef __STRING_UTILS_H
#define __STRING_UTILS_H
 
#include <sys/types.h>
#include <stdio.h>
#include <stdlib.h>
 
#include <iostream>
#include <iomanip>
#include <sstream>
#include <string>
#include <vector>
 
#include "pad.h"
#include "tostring.h"
#include "stringtok.h"
#include "stringcase.h"
#include "whitespace.h"

bool printable (const std::string& s);
 
// returns the filename without its path
std::string basename (const std::string& filename);
// returns the path preceding a filename
std::string pathname (const std::string& filename);
std::string replace_extension (const std::string& filename, 
                               const std::string& extension);

std::string time_string (double seconds);
 
std::vector<std::string>
stringdecimate(const std::string& wordstr, std::string delimiters);

std::string remove_all (std::string input, char c);
 
// ///////////////////////////////////////////////////////////
// reads up to 'nbytes' (or to eof) from 'istr', adding them 
// to 'str'.  returns number of bytes read or -1 on error
// ///////////////////////////////////////////////////////////
ssize_t 
stringload (std::string* str, std::istream &istr, std::streamsize nbytes=0);
 
// ///////////////////////////////////////////////////////////
// reads up to 'nbytes' (or to eof) from 'fptr', adding them 
// to 'str'.  returns number bytes read or -1 on error
// ///////////////////////////////////////////////////////////
ssize_t 
stringload (std::string* str, FILE* fptr, size_t nbytes=0);
 
//
// copy up to nbytes (or to eof) from 'from' to 'to'
//
void copy (FILE* from, FILE* to, ssize_t nbytes=-1);
 
// ///////////////////////////////////////////////////////////
// fills a vector of std::string with the first word from each line
// in the file.  A line is delimited by \n or commented by #.
// ///////////////////////////////////////////////////////////
int stringfload (std::vector<std::string>* lines, const std::string& filename);
int stringload (std::vector<std::string>* lines, FILE* fptr);
 
// ///////////////////////////////////////////////////////////
// fills a vector of std::string with the lines form file.  
// A line is delimited by \n or commented by #.
// ///////////////////////////////////////////////////////////
void loadlines (const std::string& filename, std::vector<std::string>& lines);
 
// ///////////////////////////////////////////////////////////
// like sprintf, but returns a string
// ///////////////////////////////////////////////////////////
std::string stringprintf (const char *fmt ...);
 
// //////////////////////////////////////////////////////////
// string_split splits a string setting parameters before and after
// to the contents before and after the delimiter string
// before and after will be empty if the delimiter does not exist
// //////////////////////////////////////////////////////////
 
void string_split( std::string source, std::string &before, std::string &after, std::string delimiter );
 
// //////////////////////////////////////////////////////////
// string_split splits a string setting parameters before and after
// to the contents before and after the ANY characters in the delim_chars string
// before and after will be empty if NONE of delim_chars exist
// //////////////////////////////////////////////////////////
 
void string_split_on_any ( std::string source, std::string &before, std::string &after, std::string delim_chars );
 
// split string into an array of strings
void string_split_on_any ( const std::string& source, std::vector<std::string>& result, std::string delim_chars );
 
#endif