// Licence: wxWindows
/////////////////////////////////////////////////////////////////////////////
-//
-//TODO: RN: I had some massive doxygen docs, I need to move these
-//in a presentable form in these sources
-//
-
// ===========================================================================
// declarations
// ===========================================================================
}
// ---------------------------------------------------------------------------
-// Escape/TranslateEscape/IsEscape
+// Escape Methods
//
// TranslateEscape unencodes a 3 character URL escape sequence
+//
// Escape encodes an invalid URI character into a 3 character sequence
+//
// IsEscape determines if the input string contains an escape sequence,
// if it does, then it moves the input string past the escape sequence
+//
+// Unescape unencodes all 3 character URL escape sequences in a wxString
// ---------------------------------------------------------------------------
wxChar wxURI::TranslateEscape(const wxChar* s)
void wxURI::Escape(wxString& s, const wxChar& c)
{
const wxChar* hdig = wxT("0123456789abcdef");
- s += '%';
+ s += wxT('%');
s += hdig[(c >> 4) & 15];
s += hdig[c & 15];
}
bool wxURI::IsEscape(const wxChar*& uri)
{
- if(*uri == '%' && IsHex(*(uri+1)) && IsHex(*(uri+2)))
+ // pct-encoded = "%" HEXDIG HEXDIG
+ if(*uri == wxT('%') && IsHex(*(uri+1)) && IsHex(*(uri+2)))
{
uri += 3;
return true;
//
// BuildURI() builds the entire URI into a useable
// representation, including proper identification characters such as slashes
+//
+// BuildUnescapedURI() does the same thing as BuildURI(), only it unescapes
+// the components that accept escape sequences
// ---------------------------------------------------------------------------
wxString wxURI::BuildURI() const
}
// ---------------------------------------------------------------------------
-// operator = and ==
+// Assignment
// ---------------------------------------------------------------------------
-wxURI& wxURI::operator = (const wxURI& uri)
-{
- return Assign(uri);
-}
-
wxURI& wxURI::Assign(const wxURI& uri)
{
//assign fields
return *this;
}
+wxURI& wxURI::operator = (const wxURI& uri)
+{
+ return Assign(uri);
+}
+
wxURI& wxURI::operator = (const wxString& string)
{
Create(string);
return *this;
}
+// ---------------------------------------------------------------------------
+// Comparison
+// ---------------------------------------------------------------------------
+
bool wxURI::operator == (const wxURI& uri) const
{
if (HasScheme())
m_scheme += *uri++;
//scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )
- //RN: Scheme can not be escaped
while (IsAlpha(*uri) || IsDigit(*uri) ||
- *uri == '+' ||
- *uri == '-' ||
- *uri == '.')
+ *uri == wxT('+') ||
+ *uri == wxT('-') ||
+ *uri == wxT('.'))
{
m_scheme += *uri++;
}
//valid scheme?
- if (*uri == ':')
+ if (*uri == wxT(':'))
{
//mark the scheme as valid
m_fields |= wxURI_SCHEME;
const wxChar* wxURI::ParseAuthority(const wxChar* uri)
{
// authority = [ userinfo "@" ] host [ ":" port ]
- if (*uri == '/' && *(uri+1) == '/')
+ if (*uri == wxT('/') && *(uri+1) == wxT('/'))
{
uri += 2;
const wxChar* uricopy = uri;
// userinfo = *( unreserved / pct-encoded / sub-delims / ":" )
- while(*uri && *uri != '@' && *uri != '/' && *uri != '#' && *uri != '?')
+ while(*uri && *uri != wxT('@') && *uri != wxT('/') && *uri != wxT('#') && *uri != wxT('?'))
{
if(IsUnreserved(*uri) || IsEscape(uri) ||
- IsSubDelim(*uri) || *uri == ':')
+ IsSubDelim(*uri) || *uri == wxT(':'))
m_user += *uri++;
else
Escape(m_user, *uri++);
}
- if(*uri == '@')
+ if(*uri == wxT('@'))
{
//valid userinfo
m_fields |= wxURI_USER;
// host = IP-literal / IPv4address / reg-name
// IP-literal = "[" ( IPv6address / IPvFuture ) "]"
- if (*uri == '[')
+ if (*uri == wxT('['))
{
- if (ParseIPv6address(++uri) && *uri == ']')
+ if (ParseIPv6address(++uri) && *uri == wxT(']'))
{
++uri;
m_hostType = wxURI_IPV6ADDRESS;
{
uri = uricopy;
- if (ParseIPvFuture(++uri) && *uri == ']')
+ if (ParseIPvFuture(++uri) && *uri == wxT(']'))
{
++uri;
m_hostType = wxURI_IPVFUTURE;
{
uri = uricopy;
// reg-name = *( unreserved / pct-encoded / sub-delims )
- while(*uri && *uri != '/' && *uri != ':' && *uri != '#' && *uri != '?')
+ while(*uri && *uri != wxT('/') && *uri != wxT(':') && *uri != wxT('#') && *uri != wxT('?'))
{
if(IsUnreserved(*uri) || IsEscape(uri) || IsSubDelim(*uri))
m_server += *uri++;
wxASSERT(uri != NULL);
// port = *DIGIT
- if(*uri == ':')
+ if(*uri == wxT(':'))
{
++uri;
while(IsDigit(*uri))
/// ; non-zero-length segment without any colon ":"
///
/// pchar = unreserved / pct-encoded / sub-delims / ":" / "@"
- if (*uri == '/')
+ if (*uri == wxT('/'))
{
m_path += *uri++;
- while(*uri && *uri != '#' && *uri != '?')
+ while(*uri && *uri != wxT('#') && *uri != wxT('?'))
{
if( IsUnreserved(*uri) || IsSubDelim(*uri) || IsEscape(uri) ||
- *uri == ':' || *uri == '@' || *uri == '/')
+ *uri == wxT(':') || *uri == wxT('@') || *uri == wxT('/'))
m_path += *uri++;
else
Escape(m_path, *uri++);
if (bReference)
{
//no colon allowed
- while(*uri && *uri != '#' && *uri != '?')
+ while(*uri && *uri != wxT('#') && *uri != wxT('?'))
{
if(IsUnreserved(*uri) || IsSubDelim(*uri) || IsEscape(uri) ||
- *uri == '@' || *uri == '/')
+ *uri == wxT('@') || *uri == wxT('/'))
m_path += *uri++;
else
Escape(m_path, *uri++);
}
else
{
- while(*uri && *uri != '#' && *uri != '?')
+ while(*uri && *uri != wxT('#') && *uri != wxT('?'))
{
if(IsUnreserved(*uri) || IsSubDelim(*uri) || IsEscape(uri) ||
- *uri == ':' || *uri == '@' || *uri == '/')
+ *uri == wxT(':') || *uri == wxT('@') || *uri == wxT('/'))
m_path += *uri++;
else
Escape(m_path, *uri++);
wxASSERT(uri != NULL);
// query = *( pchar / "/" / "?" )
- if (*uri == '?')
+ if (*uri == wxT('?'))
{
++uri;
- while(*uri && *uri != '#')
+ while(*uri && *uri != wxT('#'))
{
if (IsUnreserved(*uri) || IsSubDelim(*uri) || IsEscape(uri) ||
- *uri == ':' || *uri == '@' || *uri == '/' || *uri == '?')
+ *uri == wxT(':') || *uri == wxT('@') || *uri == wxT('/') || *uri == wxT('?'))
m_query += *uri++;
else
Escape(m_query, *uri++);
wxASSERT(uri != NULL);
// fragment = *( pchar / "/" / "?" )
- if (*uri == '#')
+ if (*uri == wxT('#'))
{
++uri;
while(*uri)
{
if (IsUnreserved(*uri) || IsSubDelim(*uri) || IsEscape(uri) ||
- *uri == ':' || *uri == '@' || *uri == '/' || *uri == '?')
+ *uri == wxT(':') || *uri == wxT('@') || *uri == wxT('/') || *uri == wxT('?'))
m_fragment += *uri++;
else
Escape(m_fragment, *uri++);
}
// ---------------------------------------------------------------------------
-// Resolve URI
+// Resolve
+//
+// Builds missing components of this uri from a base uri
//
-// Builds missing components of this uri from a base uri
+// A version of the algorithm outlined in the RFC is used here
+// (it is shown in comments)
//
-// A version of the algorithm outlined in the RFC is used here
-// (it is shown in comments)
+// Note that an empty URI inherits all components
// ---------------------------------------------------------------------------
void wxURI::Resolve(const wxURI& base, int flags)
wxASSERT_MSG(!base.IsReference(),
wxT("wxURI to inherit from must not be a reference!"));
- // If we arn't being strict, enable the older
+ // If we arn't being strict, enable the older (pre-RFC2396)
// loophole that allows this uri to inherit other
// properties from the base uri - even if the scheme
// is defined
// T.path = remove_dot_segments(T.path);
// endif;
// T.query = R.query;
- if (m_path[(const size_t&)0] != '/')
+ if (m_path[0u] != wxT('/'))
{
//Marge paths
const wxChar* op = m_path.c_str();
const wxChar* bp = base.m_path.c_str() + base.m_path.Length();
//not a ending directory? move up
- if (base.m_path[0] && *(bp-1) != '/')
+ if (base.m_path[0] && *(bp-1) != wxT('/'))
UpTree(base.m_path, bp);
//normalize directories
- while(*op == '.' && *(op+1) == '.' &&
- (*(op+2) == '\0' || *(op+2) == '/') )
+ while(*op == wxT('.') && *(op+1) == wxT('.') &&
+ (*(op+2) == '\0' || *(op+2) == wxT('/')) )
{
UpTree(base.m_path, bp);
}
m_path = base.m_path.substr(0, bp - base.m_path.c_str()) +
- m_path.Mid((op - m_path.c_str()), m_path.Length());
+ m_path.substr((op - m_path.c_str()), m_path.Length());
}
}
+
+ //T.fragment = R.fragment;
}
// ---------------------------------------------------------------------------
-// Directory Normalization (static)
+// UpTree
//
-// UpTree goes up a directory in a string and moves the pointer as such,
-// while Normalize gets rid of duplicate/erronues directories in a URI
-// according to RFC 2396 and modified quite a bit to meet the unit tests
-// in it.
+// Moves a URI path up a directory
// ---------------------------------------------------------------------------
+//static
void wxURI::UpTree(const wxChar* uristart, const wxChar*& uri)
{
- if (uri != uristart && *(uri-1) == '/')
+ if (uri != uristart && *(uri-1) == wxT('/'))
{
uri -= 2;
}
for(;uri != uristart; --uri)
{
- if (*uri == '/')
+ if (*uri == wxT('/'))
{
++uri;
break;
}
//!!!TODO:HACK!!!//
- if (uri == uristart && *uri == '/')
+ if (uri == uristart && *uri == wxT('/'))
++uri;
//!!!//
}
+// ---------------------------------------------------------------------------
+// Normalize
+//
+// Normalizes directories in-place
+//
+// I.E. ./ and . are ignored
+//
+// ../ and .. are removed if a directory is before it, along
+// with that directory (leading .. and ../ are kept)
+// ---------------------------------------------------------------------------
+
+//static
void wxURI::Normalize(wxChar* s, bool bIgnoreLeads)
{
wxChar* cp = s;
wxChar* bp = s;
- if(s[0] == '/')
+ if(s[0] == wxT('/'))
++bp;
while(*cp)
{
- if (*cp == '.' && (*(cp+1) == '/' || *(cp+1) == '\0')
- && (bp == cp || *(cp-1) == '/'))
+ if (*cp == wxT('.') && (*(cp+1) == wxT('/') || *(cp+1) == '\0')
+ && (bp == cp || *(cp-1) == wxT('/')))
{
//. _or_ ./ - ignore
if (*(cp+1) == '\0')
else
cp += 2;
}
- else if (*cp == '.' && *(cp+1) == '.' &&
- (*(cp+2) == '/' || *(cp+2) == '\0')
- && (bp == cp || *(cp-1) == '/'))
+ else if (*cp == wxT('.') && *(cp+1) == wxT('.') &&
+ (*(cp+2) == wxT('/') || *(cp+2) == '\0')
+ && (bp == cp || *(cp-1) == wxT('/')))
{
//.. _or_ ../ - go up the tree
if (s != bp)
}
// ---------------------------------------------------------------------------
-// Misc. Parsing Methods
+// ParseH16
+//
+// Parses 1 to 4 hex values. Returns true if the first character of the input
+// string is a valid hex character. It is the caller's responsability to move
+// the input string back to its original position on failure.
+// ---------------------------------------------------------------------------
+
+bool wxURI::ParseH16(const wxChar*& uri)
+{
+ // h16 = 1*4HEXDIG
+ if(!IsHex(*++uri))
+ return false;
+
+ if(IsHex(*++uri) && IsHex(*++uri) && IsHex(*++uri))
+ ++uri;
+
+ return true;
+}
+
+// ---------------------------------------------------------------------------
+// ParseIPXXX
+//
+// Parses a certain version of an IP address and moves the input string past
+// it. Returns true if the input string contains the proper version of an ip
+// address. It is the caller's responsability to move the input string back
+// to its original position on failure.
// ---------------------------------------------------------------------------
bool wxURI::ParseIPv4address(const wxChar*& uri)
//each ip part must be between 0-255 (dupe of version in for loop)
if( IsDigit(*++uri) && IsDigit(*++uri) &&
//100 or less (note !)
- !( (*(uri-2) < '2') ||
+ !( (*(uri-2) < wxT('2')) ||
//240 or less
- (*(uri-2) == '2' &&
- (*(uri-1) < '5' || (*(uri-1) == '5' && *uri <= '5'))
+ (*(uri-2) == wxT('2') &&
+ (*(uri-1) < wxT('5') || (*(uri-1) == wxT('5') && *uri <= wxT('5')))
)
)
)
//compilers should unroll this loop
for(; iIPv4 < 4; ++iIPv4)
{
- if (*uri != '.' || !IsDigit(*++uri))
+ if (*uri != wxT('.') || !IsDigit(*++uri))
break;
//each ip part must be between 0-255
if( IsDigit(*++uri) && IsDigit(*++uri) &&
//100 or less (note !)
- !( (*(uri-2) < '2') ||
+ !( (*(uri-2) < wxT('2')) ||
//240 or less
- (*(uri-2) == '2' &&
- (*(uri-1) < '5' || (*(uri-1) == '5' && *uri <= '5'))
+ (*(uri-2) == wxT('2') &&
+ (*(uri-1) < wxT('5') || (*(uri-1) == wxT('5') && *uri <= wxT('5')))
)
)
)
return iIPv4 == 4;
}
-bool wxURI::ParseH16(const wxChar*& uri)
-{
- // h16 = 1*4HEXDIG
- if(!IsHex(*++uri))
- return false;
-
- if(IsHex(*++uri) && IsHex(*++uri) && IsHex(*++uri))
- ++uri;
-
- return true;
-}
-
bool wxURI::ParseIPv6address(const wxChar*& uri)
{
// IPv6address = 6( h16 ":" ) ls32
break;
}
- if(*uri != ':')
+ if(*uri != wxT(':'))
{
break;
}
if (numPrefix)
return false;
- if (*uri == ':')
+ if (*uri == wxT(':'))
{
- if (*++uri != ':')
+ if (*++uri != wxT(':'))
return false;
maxPostfix = 5;
}
else
{
- if (*uri != ':' || *(uri+1) != ':')
+ if (*uri != wxT(':') || *(uri+1) != wxT(':'))
{
if (numPrefix != 6)
return false;
- while (*--uri != ':') {}
+ while (*--uri != wxT(':')) {}
++uri;
const wxChar* uristart = uri;
//parse ls32
// ls32 = ( h16 ":" h16 ) / IPv4address
- if (ParseH16(uri) && *uri == ':' && ParseH16(uri))
+ if (ParseH16(uri) && *uri == wxT(':') && ParseH16(uri))
return true;
uri = uristart;
for(; maxPostfix != 0; --maxPostfix)
{
- if(!ParseH16(uri) || *uri != ':')
+ if(!ParseH16(uri) || *uri != wxT(':'))
return false;
}
const wxChar* uristart = uri;
//parse ls32
// ls32 = ( h16 ":" h16 ) / IPv4address
- if (ParseH16(uri) && *uri == ':' && ParseH16(uri))
+ if (ParseH16(uri) && *uri == wxT(':') && ParseH16(uri))
return true;
uri = uristart;
bool wxURI::ParseIPvFuture(const wxChar*& uri)
{
// IPvFuture = "v" 1*HEXDIG "." 1*( unreserved / sub-delims / ":" )
- if (*++uri != 'v' || !IsHex(*++uri))
+ if (*++uri != wxT('v') || !IsHex(*++uri))
return false;
while (IsHex(*++uri)) {}
- if (*uri != '.' || !(IsUnreserved(*++uri) || IsSubDelim(*uri) || *uri == ':'))
+ if (*uri != wxT('.') || !(IsUnreserved(*++uri) || IsSubDelim(*uri) || *uri == wxT(':')))
return false;
- while(IsUnreserved(*++uri) || IsSubDelim(*uri) || *uri == ':') {}
+ while(IsUnreserved(*++uri) || IsSubDelim(*uri) || *uri == wxT(':')) {}
return true;
}
// ---------------------------------------------------------------------------
-// Misc methods - IsXXX and CharToHex
+// CharToHex
+//
+// Converts a character into a numeric hexidecimal value, or 0 if the
+// passed in character is not a valid hex character
// ---------------------------------------------------------------------------
+//static
wxInt32 wxURI::CharToHex(const wxChar& c)
{
- if ((c >= 'A') && (c <= 'Z')) return c - 'A' + 0x0A;
- if ((c >= 'a') && (c <= 'z')) return c - 'a' + 0x0a;
- if ((c >= '0') && (c <= '9')) return c - '0' + 0x00;
+ if ((c >= wxT('A')) && (c <= wxT('Z'))) return c - wxT('A') + 0x0A;
+ if ((c >= wxT('a')) && (c <= wxT('z'))) return c - wxT('a') + 0x0a;
+ if ((c >= wxT('0')) && (c <= wxT('9'))) return c - wxT('0') + 0x00;
return 0;
}
+// ---------------------------------------------------------------------------
+// IsXXX
+//
+// Returns true if the passed in character meets the criteria of the method
+// ---------------------------------------------------------------------------
+
//! unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~"
bool wxURI::IsUnreserved (const wxChar& c)
{ return IsAlpha(c) || IsDigit(c) ||
- c == '-' ||
- c == '.' ||
- c == '_' ||
- c == '~' //tilde
+ c == wxT('-') ||
+ c == wxT('.') ||
+ c == wxT('_') ||
+ c == wxT('~') //tilde
;
}
//! gen-delims = ":" / "/" / "?" / "#" / "[" / "]" / "@"
bool wxURI::IsGenDelim (const wxChar& c)
{
- return c == ':' ||
- c == '/' ||
- c == '?' ||
- c == '#' ||
- c == '[' ||
- c == ']' ||
- c == '@';
+ return c == wxT(':') ||
+ c == wxT('/') ||
+ c == wxT('?') ||
+ c == wxT('#') ||
+ c == wxT('[') ||
+ c == wxT(']') ||
+ c == wxT('@');
}
//! sub-delims = "!" / "$" / "&" / "'" / "(" / ")"
//! / "*" / "+" / "," / ";" / "="
bool wxURI::IsSubDelim (const wxChar& c)
{
- return c == '!' ||
- c == '$' ||
- c == '&' ||
- c == '\'' ||
- c == '(' ||
- c == ')' ||
- c == '*' ||
- c == '+' ||
- c == ',' ||
- c == ';' ||
- c == '='
+ return c == wxT('!') ||
+ c == wxT('$') ||
+ c == wxT('&') ||
+ c == wxT('\'') ||
+ c == wxT('(') ||
+ c == wxT(')') ||
+ c == wxT('*') ||
+ c == wxT('+') ||
+ c == wxT(',') ||
+ c == wxT(';') ||
+ c == wxT('=')
;
}
bool wxURI::IsHex(const wxChar& c)
-{ return IsDigit(c) || (c >= 'a' && c <= 'f') || (c >= 'A' && c <= 'F'); }
+{ return IsDigit(c) || (c >= wxT('a') && c <= wxT('f')) || (c >= wxT('A') && c <= wxT('F')); }
bool wxURI::IsAlpha(const wxChar& c)
-{ return (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z'); }
+{ return (c >= wxT('a') && c <= wxT('z')) || (c >= wxT('A') && c <= wxT('Z')); }
bool wxURI::IsDigit(const wxChar& c)
-{ return c >= '0' && c <= '9'; }
+{ return c >= wxT('0') && c <= wxT('9'); }
// ---------------------------------------------------------------------------
#include "wx/url.h"
-wxString wxURL::ConvertToValidURI(const wxString& uri, const wxChar* WXUNUSED(delims))
+//Note that this old code really doesn't convert to a URI that well and looks
+//more like a dirty hack than anything else...
+
+wxString wxURL::ConvertToValidURI(const wxString& uri, const wxChar* delims)
{
- return wxURI(uri).BuildURI();
+ wxString out_str;
+ wxString hexa_code;
+ size_t i;
+
+ for (i = 0; i < uri.Len(); i++)
+ {
+ wxChar c = uri.GetChar(i);
+
+ if (c == wxT(' '))
+ {
+ // GRG, Apr/2000: changed to "%20" instead of '+'
+
+ out_str += wxT("%20");
+ }
+ else
+ {
+ // GRG, Apr/2000: modified according to the URI definition (RFC 2396)
+ //
+ // - Alphanumeric characters are never escaped
+ // - Unreserved marks are never escaped
+ // - Delimiters must be escaped if they appear within a component
+ // but not if they are used to separate components. Here we have
+ // no clear way to distinguish between these two cases, so they
+ // are escaped unless they are passed in the 'delims' parameter
+ // (allowed delimiters).
+
+ static const wxChar marks[] = wxT("-_.!~*()'");
+
+ if ( !wxIsalnum(c) && !wxStrchr(marks, c) && !wxStrchr(delims, c) )
+ {
+ hexa_code.Printf(wxT("%%%02X"), c);
+ out_str += hexa_code;
+ }
+ else
+ {
+ out_str += c;
+ }
+ }
+ }
+
+ return out_str;
}
wxString wxURL::ConvertFromURI(const wxString& uri)
projects / wxWidgets.git / blobdiff