string_util.cc File Reference

Some std::string helper functions. More...

#include <platform/types.hh>
#include <utility/numbers.hh>
#include <utility/exit.hh>
#include <utility/excn/Exceptions.hh>
#include <utility/file/FileName.hh>
#include <utility/io/izstream.hh>
#include <utility/string_util.hh>
#include <utility/vector1.hh>
#include <ObjexxFCL/string.functions.hh>
#include <fstream>
#include <iomanip>
#include <string>
#include <cmath>
#include <boost/uuid/sha1.hpp>
#include <algorithm>

Namespaces
	utility
	unresizable vector whose size is known at compile time, which may be allocated on the stack, and which indexes from 0.

Functions
utility::vector1< std::string >	utility::split (std::string const &s)
	split given std::string using ' ' symbol. More...
utility::vector1< std::string >	utility::split_whitespace (std::string const &s)
	split given std::string using whitespace as a separator. Unlike string_split_multi_delim(), any group of mixed whitespace counts only as a single seperator. More...
std::vector< std::string >	utility::split_by_newlines (std::string const &s)
std::string	utility::upper (std::string const &s)
	Make a string Uppercase. More...
std::string	utility::lower (std::string const &s)
	Make a string Lowercase More...
utility::vector1< std::string >	utility::quoted_split (std::string const &s)
std::string	utility::join (utility::vector1< std::string > const &s, std::string const &connector)
	combine strings with anything More...
std::string	utility::join (std::vector< std::string > const &s, std::string const &connector)
	combine strings with anything More...
std::string	utility::replace_spaces (std::string const &string_w_spaces, std::string const &replacement)
	replace space separations in a string with a connector such as '_' More...
std::list< std::string >	utility::split_to_list (const std::string &s)
	split given std::string using ' ' symbol. More...
std::set< std::string >	utility::split_to_set (std::string const &s)
	split given std::string to a set using ' ' symbol. More...
utility::vector1< std::string >	utility::string_split (std::string const &in, char splitchar)
utility::vector1< std::string >	utility::string_split_simple (std::string const &in, char splitchar= ' ')
	split to vector1< std::string > using arbitrary split character, but no empty strings (closer to python string::split) More...
utility::vector1< std::string >	utility::string_split_multi_delim (std::string const &in, std::string splitchars)
float	utility::string2float (std::string st)
	convert a string to a float, returns -1 on failure More...
int	utility::string2int (std::string st)
	convert a string to an int, returns -1 on failure More...
platform::Size	utility::string2Size (std::string st)
	convert a string to a Size, returns numeric::get_undefined_size() on failure More...
platform::Real	utility::string2Real (std::string st)
	convert a string to a Real, returns numeric::get_undefined_real() on failure More...
std::string	utility::Real2string (platform::Real, std::size_t const decimal_places)
	convert a Real to string at a number of decimal places, optionally pad left. More...
std::string	utility::fmt_real (platform::Real, platform::Size const pad_left_newlen, std::size_t const decimal_places)
	convert a Real to a string, padding left with spaces until total number of char on left is equal to pad_lef_n More...
void	utility::string2uint (const std::string &x, unsigned int *const y)
bool	utility::trimmed_compare (std::string const &s1, std::string const &s2)
	compares two strings ignoring leading and trailing spaces More...
bool	utility::startswith (std::string const &haystack, std::string const &needle)
	True iff haystack starts with needle. More...
bool	utility::endswith (std::string const &haystack, std::string const &needle)
	True iff haystack ends with needle. More...
bool	utility::contains (std::string const &haystack, std::string const &needle)
	Does the string contain the other string? This is purely convenience as I hate the C++ syntax to do this. More...
void	utility::slurp (std::istream &in, std::string &out)
	Take all of the contents from the std::istream "in" and put them in the std::string "out". More...
void	utility::trim (std::string &s, const std::string &drop=" ")
	Remove any charachters in "drop" from the front and back of the string. Use strip() for the value-return version. More...
std::string	utility::strip (std::string const &source, std::string const &drop)
	Return a copy of the string with leading and trailing characters removed Any charachters in drop will be removed For the in place version, see trim() More...
std::string	utility::pad_left (std::string const &s, platform::Size const newlen, char pad_with=' ')
	Add char to the left of the string. More...
std::string	utility::pad_right (std::string const &s, platform::Size const newlen, char pad_with=' ')
	Add char to the right of a string. More...
std::string	utility::strip (std::string const &source, char c=' ')
	Return a copy of the string with leading and trailing characters removed. More...
bool	utility::is_string_numeric (std::string const &input)
std::string	utility::file_contents (std::string const &file_name)
	Read the entire contents of a file into a string. All end-of-line characters are replaced by "\n". Throws a utility::excn::EXCN_msg_exception if the file cannot be opened. More...
std::string	utility::file_basename (const std::string &full_path)
std::string	utility::filename (const std::string &path)
std::string	utility::pathname (const std::string &path)
std::string	utility::replace_environment_variables (std::string input)
	find all environment variables with the form ${VARIABLE} and replace with the contents of that environment variable. if the environment variable does not exist, return string::npos More...
std::string	utility::string_to_sha1 (std::string const &input_string)
bool	utility::is_true_string (std::string const &value_str)
	String accepted as a true value? More...
bool	utility::is_false_string (std::string const &value_str)
	String accepted as a false value? More...
std::string	utility::make_tag_with_dashes (utility::vector1< int > res_vector, char const delimiter= ' ')
	Compactifies vectors of ints: 1 2 3 9 10 11 to "1-3 9-11". More...
std::string	utility::make_tag_with_dashes (utility::vector1< int > res_vector, utility::vector1< char > chain_vector, utility::vector1< std::string > segid_vector, char const delimiter)
std::string	utility::make_segtag_with_dashes (utility::vector1< int > res_vector, utility::vector1< std::string > segid_vector, char const delimiter)
std::string	utility::make_tag (utility::vector1< int > res_vector)
std::tuple< std::vector< int > , std::vector< char > , std::vector< std::string > >	utility::get_resnum_and_chain_and_segid (std::string const &s, bool &string_is_ok)
	converts string like "1-3 20-22" or "A:1-5 B:20-22" to vectors containing resnums and chains. More...
std::tuple< std::vector< int > , std::vector< char > , std::vector< std::string > >	utility::get_resnum_and_chain (std::string const &s)
	for those who have a legacy interface that can't touch segids. More...
std::pair< std::vector< int > , std::vector< std::string > >	utility::get_resnum_and_segid (std::string const &s, bool &string_is_ok)
	converts string like "1-3 20-22" or "A:1-5 B:20-22" to vectors containing resnums and chains. More...
bool	utility::get_resnum_and_chain_from_one_tag (std::string const &tag, std::vector< int > &resnum, std::vector< char > &chains, std::vector< std::string > &segids)
	helper function for get_resnum_and_chain More...
bool	utility::get_resnum_and_segid_from_one_tag (std::string const &tag, std::vector< int > &resnum, std::vector< std::string > &chains)
	helper function for get_resnum_and_chain More...
platform::Size	utility::get_num_digits (platform::Size value)
std::string	utility::replace_in (std::string const &source, std::string const &from, std::string const &to)
	Generate new string from 'source' by replacing all occurrences of 'from' to 'to' string. More...
std::string	utility::remove_from_string (std::string const &source, std::string const &erase_str)
	Call boost to erase all instances of erase_str from source. More...

Detailed Description

Some std::string helper functions.

Author

Sergey Lyskov

Jared Adolf-Bryfogle