1
// -*- mode: cpp; mode: fold -*-
3
// $Id: strutl.h,v 1.21 2001/05/29 05:09:44 jgg Exp $
4
/* ######################################################################
6
String Util - These are some useful string functions
8
_strstrip is a function to remove whitespace from the front and end
11
This source is placed in the Public Domain, do with it what you will
12
It was originally written by Jason Gunthorpe <jgg@gpu.srv.ualberta.ca>
14
##################################################################### */
20
#pragma interface "apt-pkg/strutl.h"
34
// Methods have a hidden this parameter that is visible to this attribute
35
#define APT_FORMAT2 __attribute__ ((format (printf, 2, 3)))
40
char *_strstrip(char *String);
41
char *_strtabexpand(char *String,size_t Len);
42
bool ParseQuoteWord(const char *&String,string &Res);
43
bool ParseCWord(const char *&String,string &Res);
44
string QuoteString(string Str,const char *Bad);
45
string DeQuoteString(string Str);
46
string SizeToStr(double Bytes);
47
string TimeToStr(unsigned long Sec);
48
string Base64Encode(string Str);
49
string URItoFileName(string URI);
50
string TimeRFC1123(time_t Date);
51
bool StrToTime(string Val,time_t &Result);
52
string LookupTag(string Message,const char *Tag,const char *Default = 0);
53
int StringToBool(string Text,int Default = -1);
54
bool ReadMessages(int Fd, vector<string> &List);
55
bool StrToNum(const char *Str,unsigned long &Res,unsigned Len,unsigned Base = 0);
56
bool Hex2Num(string Str,unsigned char *Num,unsigned int Length);
57
bool TokSplitString(char Tok,char *Input,char **List,
58
unsigned long ListMax);
59
void ioprintf(ostream &out,const char *format,...) APT_FORMAT2;
60
bool CheckDomainList(string Host,string List);
62
#define APT_MKSTRCMP(name,func) \
63
inline int name(const char *A,const char *AEnd,const char *B) {return func(A,AEnd,B,B+strlen(B));}; \
64
inline int name(string A,const char *B) {return func(A.c_str(),A.c_str()+A.length(),B,B+strlen(B));}; \
65
inline int name(string A,string B) {return func(A.c_str(),A.c_str()+A.length(),B.c_str(),B.c_str()+B.length());}; \
66
inline int name(string A,const char *B,const char *BEnd) {return func(A.c_str(),A.c_str()+A.length(),B,BEnd);};
68
#define APT_MKSTRCMP2(name,func) \
69
inline int name(const char *A,const char *AEnd,const char *B) {return func(A,AEnd,B,B+strlen(B));}; \
70
inline int name(string A,const char *B) {return func(A.begin(),A.end(),B,B+strlen(B));}; \
71
inline int name(string A,string B) {return func(A.begin(),A.end(),B.begin(),B.end());}; \
72
inline int name(string A,const char *B,const char *BEnd) {return func(A.begin(),A.end(),B,BEnd);};
74
int stringcmp(const char *A,const char *AEnd,const char *B,const char *BEnd);
75
int stringcasecmp(const char *A,const char *AEnd,const char *B,const char *BEnd);
77
/* We assume that GCC 3 indicates that libstdc++3 is in use too. In that
78
case the definition of string::const_iterator is not the same as
79
const char * and we need these extra functions */
81
int stringcmp(string::const_iterator A,string::const_iterator AEnd,
82
const char *B,const char *BEnd);
83
int stringcmp(string::const_iterator A,string::const_iterator AEnd,
84
string::const_iterator B,string::const_iterator BEnd);
85
int stringcasecmp(string::const_iterator A,string::const_iterator AEnd,
86
const char *B,const char *BEnd);
87
int stringcasecmp(string::const_iterator A,string::const_iterator AEnd,
88
string::const_iterator B,string::const_iterator BEnd);
90
inline int stringcmp(string::const_iterator A,string::const_iterator Aend,const char *B) {return stringcmp(A,Aend,B,B+strlen(B));};
91
inline int stringcasecmp(string::const_iterator A,string::const_iterator Aend,const char *B) {return stringcasecmp(A,Aend,B,B+strlen(B));};
94
APT_MKSTRCMP2(stringcmp,stringcmp);
95
APT_MKSTRCMP2(stringcasecmp,stringcasecmp);
97
inline const char *DeNull(const char *s) {return (s == 0?"(null)":s);};
101
void CopyFrom(string From);
113
inline void operator =(string From) {CopyFrom(From);};
114
inline bool empty() {return Access.empty();};
115
static string SiteOnly(string URI);
117
URI(string Path) {CopyFrom(Path);};
124
const string *Contents;
126
string SubstVar(string Str,const struct SubstVar *Vars);
127
string SubstVar(string Str,string Subst,string Contents);
135
unsigned long RegexChoice(RxChoiceList *Rxs,const char **ListBegin,
136
const char **ListEnd);