]>
git.saurik.com Git - apt.git/blob - apt-pkg/contrib/strutl.h
1 // -*- mode: cpp; mode: fold -*-
3 // $Id: strutl.h,v 1.22 2003/02/02 22:20:27 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 ##################################################################### */
30 #ifndef APT_10_CLEANER_HEADERS
33 #ifndef APT_8_CLEANER_HEADERS
41 std::string
Strip(const std::string
&s
);
42 bool Endswith(const std::string
&s
, const std::string
&ending
);
43 bool Startswith(const std::string
&s
, const std::string
&starting
);
48 bool UTF8ToCodeset(const char *codeset
, const std::string
&orig
, std::string
*dest
);
49 char *_strstrip(char *String
);
50 char *_strrstrip(char *String
); // right strip only
51 char *_strtabexpand(char *String
,size_t Len
);
52 bool ParseQuoteWord(const char *&String
,std::string
&Res
);
53 bool ParseCWord(const char *&String
,std::string
&Res
);
54 std::string
QuoteString(const std::string
&Str
,const char *Bad
);
55 std::string
DeQuoteString(const std::string
&Str
);
56 std::string
DeQuoteString(std::string::const_iterator
const &begin
, std::string::const_iterator
const &end
);
58 // unescape (\0XX and \xXX) from a string
59 std::string
DeEscapeString(const std::string
&input
);
61 std::string
SizeToStr(double Bytes
);
62 std::string
TimeToStr(unsigned long Sec
);
63 std::string
Base64Encode(const std::string
&Str
);
64 std::string
OutputInDepth(const unsigned long Depth
, const char* Separator
=" ");
65 std::string
URItoFileName(const std::string
&URI
);
66 std::string
TimeRFC1123(time_t Date
);
67 bool RFC1123StrToTime(const char* const str
,time_t &time
) APT_MUSTCHECK
;
68 bool FTPMDTMStrToTime(const char* const str
,time_t &time
) APT_MUSTCHECK
;
69 APT_DEPRECATED_MSG("Use RFC1123StrToTime or FTPMDTMStrToTime as needed instead") bool StrToTime(const std::string
&Val
,time_t &Result
);
70 std::string
LookupTag(const std::string
&Message
,const char *Tag
,const char *Default
= 0);
71 int StringToBool(const std::string
&Text
,int Default
= -1);
72 bool ReadMessages(int Fd
, std::vector
<std::string
> &List
);
73 bool StrToNum(const char *Str
,unsigned long &Res
,unsigned Len
,unsigned Base
= 0);
74 bool StrToNum(const char *Str
,unsigned long long &Res
,unsigned Len
,unsigned Base
= 0);
75 bool Base256ToNum(const char *Str
,unsigned long &Res
,unsigned int Len
);
76 bool Base256ToNum(const char *Str
,unsigned long long &Res
,unsigned int Len
);
77 bool Hex2Num(const std::string
&Str
,unsigned char *Num
,unsigned int Length
);
79 // input changing string split
80 bool TokSplitString(char Tok
,char *Input
,char **List
,
81 unsigned long ListMax
);
83 // split a given string by a char
84 std::vector
<std::string
> VectorizeString(std::string
const &haystack
, char const &split
) APT_PURE
;
86 /* \brief Return a vector of strings from string "input" where "sep"
87 * is used as the delimiter string.
89 * \param input The input string.
91 * \param sep The seperator to use.
93 * \param maxsplit (optional) The maximum amount of splitting that
96 * The optional "maxsplit" argument can be used to limit the splitting,
97 * if used the string is only split on maxsplit places and the last
98 * item in the vector contains the remainder string.
100 std::vector
<std::string
> StringSplit(std::string
const &input
,
101 std::string
const &sep
,
102 unsigned int maxsplit
=std::numeric_limits
<unsigned int>::max()) APT_CONST
;
104 void ioprintf(std::ostream
&out
,const char *format
,...) APT_PRINTF(2);
105 void strprintf(std::string
&out
,const char *format
,...) APT_PRINTF(2);
106 char *safe_snprintf(char *Buffer
,char *End
,const char *Format
,...) APT_PRINTF(3);
107 bool CheckDomainList(const std::string
&Host
, const std::string
&List
);
108 int tolower_ascii(int const c
) APT_CONST APT_HOT
;
109 std::string
StripEpoch(const std::string
&VerStr
);
111 #define APT_MKSTRCMP(name,func) \
112 inline APT_PURE int name(const char *A,const char *B) {return func(A,A+strlen(A),B,B+strlen(B));} \
113 inline APT_PURE int name(const char *A,const char *AEnd,const char *B) {return func(A,AEnd,B,B+strlen(B));} \
114 inline APT_PURE int name(const std::string& A,const char *B) {return func(A.c_str(),A.c_str()+A.length(),B,B+strlen(B));} \
115 inline APT_PURE int name(const std::string& A,const std::string& B) {return func(A.c_str(),A.c_str()+A.length(),B.c_str(),B.c_str()+B.length());} \
116 inline APT_PURE int name(const std::string& A,const char *B,const char *BEnd) {return func(A.c_str(),A.c_str()+A.length(),B,BEnd);}
118 #define APT_MKSTRCMP2(name,func) \
119 inline APT_PURE int name(const char *A,const char *AEnd,const char *B) {return func(A,AEnd,B,B+strlen(B));} \
120 inline APT_PURE int name(const std::string& A,const char *B) {return func(A.begin(),A.end(),B,B+strlen(B));} \
121 inline APT_PURE int name(const std::string& A,const std::string& B) {return func(A.begin(),A.end(),B.begin(),B.end());} \
122 inline APT_PURE int name(const std::string& A,const char *B,const char *BEnd) {return func(A.begin(),A.end(),B,BEnd);}
124 int APT_PURE
stringcmp(const char *A
,const char *AEnd
,const char *B
,const char *BEnd
);
125 int APT_PURE
stringcasecmp(const char *A
,const char *AEnd
,const char *B
,const char *BEnd
);
127 /* We assume that GCC 3 indicates that libstdc++3 is in use too. In that
128 case the definition of string::const_iterator is not the same as
129 const char * and we need these extra functions */
131 int APT_PURE
stringcmp(std::string::const_iterator A
,std::string::const_iterator AEnd
,
132 const char *B
,const char *BEnd
);
133 int APT_PURE
stringcmp(std::string::const_iterator A
,std::string::const_iterator AEnd
,
134 std::string::const_iterator B
,std::string::const_iterator BEnd
);
135 int APT_PURE
stringcasecmp(std::string::const_iterator A
,std::string::const_iterator AEnd
,
136 const char *B
,const char *BEnd
);
137 int APT_PURE
stringcasecmp(std::string::const_iterator A
,std::string::const_iterator AEnd
,
138 std::string::const_iterator B
,std::string::const_iterator BEnd
);
140 inline APT_PURE
int stringcmp(std::string::const_iterator A
,std::string::const_iterator Aend
,const char *B
) {return stringcmp(A
,Aend
,B
,B
+strlen(B
));}
141 inline APT_PURE
int stringcasecmp(std::string::const_iterator A
,std::string::const_iterator Aend
,const char *B
) {return stringcasecmp(A
,Aend
,B
,B
+strlen(B
));}
144 APT_MKSTRCMP2(stringcmp
,stringcmp
)
145 APT_MKSTRCMP2(stringcasecmp
,stringcasecmp
)
147 // Return the length of a NULL-terminated string array
148 size_t APT_PURE
strv_length(const char **str_array
);
151 inline const char *DeNull(const char *s
) {return (s
== 0?"(null)":s
);}
155 void CopyFrom(const std::string
&From
);
161 std::string Password
;
166 operator std::string();
167 inline void operator =(const std::string
&From
) {CopyFrom(From
);}
168 inline bool empty() {return Access
.empty();};
169 static std::string
SiteOnly(const std::string
&URI
);
170 static std::string
ArchiveOnly(const std::string
&URI
);
171 static std::string
NoUserPassword(const std::string
&URI
);
173 URI(std::string Path
) {CopyFrom(Path
);}
180 const std::string
*Contents
;
182 std::string
SubstVar(std::string Str
,const struct SubstVar
*Vars
);
183 std::string
SubstVar(const std::string
&Str
,const std::string
&Subst
,const std::string
&Contents
);
191 unsigned long RegexChoice(RxChoiceList
*Rxs
,const char **ListBegin
,
192 const char **ListEnd
);