1 /*****************************************************************************
2 * vlc_url.h: URL related macros
3 *****************************************************************************
4 * Copyright (C) 2002-2006 the VideoLAN team
7 * Authors: Christophe Massiot <massiot@via.ecp.fr>
8 * RĂ©mi Denis-Courmont <rem # videolan.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
25 #if !defined( __LIBVLC__ )
26 #error You are not libvlc or one of its plugins. You cannot include this file
44 char *psz_buffer; /* to be freed */
47 /*****************************************************************************
49 *****************************************************************************
50 * option : if != 0 then path is split at this char
52 * format [protocol://[login[:password]@]][host[:port]]/path[OPTIONoption]
53 *****************************************************************************/
54 static inline void vlc_UrlParse( vlc_url_t *url, const char *psz_url,
61 url->psz_protocol = NULL;
62 url->psz_username = NULL;
63 url->psz_password = NULL;
67 url->psz_option = NULL;
71 url->psz_buffer = NULL;
74 url->psz_buffer = psz_parse = psz_dup = strdup( psz_url );
76 p = strstr( psz_parse, ":/" );
79 /* we have a protocol */
85 url->psz_protocol = psz_parse;
88 p = strchr( psz_parse, '@' );
92 url->psz_username = psz_parse;
95 psz_parse = strchr( psz_parse, ':' );
96 if( psz_parse != NULL )
98 /* We have a password */
100 url->psz_password = psz_parse;
106 p = strchr( psz_parse, '/' );
107 if( !p || psz_parse < p )
111 /* We have a host[:port] */
112 url->psz_host = strdup( psz_parse );
115 url->psz_host[p - psz_parse] = '\0';
118 if( *url->psz_host == '[' )
121 p2 = strchr( url->psz_host, ']' );
124 p2 = strchr( p2, ':' );
129 p2 = strchr( url->psz_host, ':' );
134 url->i_port = atoi( p2 );
139 /* Now parse psz_path and psz_option */
142 url->psz_path = psz_parse;
145 p = strchr( url->psz_path, option );
155 /*****************************************************************************
157 *****************************************************************************/
158 static inline void vlc_UrlClean( vlc_url_t *url )
160 if( url->psz_buffer ) free( url->psz_buffer );
161 if( url->psz_host ) free( url->psz_host );
163 url->psz_protocol = NULL;
164 url->psz_username = NULL;
165 url->psz_password = NULL;
166 url->psz_host = NULL;
168 url->psz_path = NULL;
169 url->psz_option = NULL;
171 url->psz_buffer = NULL;
174 VLC_EXPORT( char *, unescape_URI_duplicate, ( const char *psz ) );
175 VLC_EXPORT( void, unescape_URI, ( char *psz ) );
176 VLC_EXPORT( char *, decode_URI_duplicate, ( const char *psz ) );
177 VLC_EXPORT( void, decode_URI, ( char *psz ) );
178 VLC_EXPORT( char *, encode_URI_component, ( const char *psz ) );
180 static inline char *vlc_UrlEncode( const char *psz_url )
182 /* FIXME: do not encode / : ? and & _when_ not needed */
183 return encode_URI_component( psz_url );
188 /** Check whether a given string is not a valid URL and must hence be
190 static inline int vlc_UrlIsNotEncoded( const char *psz_url )
194 for( ptr = psz_url; *ptr; ptr++ )
200 if( !isxdigit( ptr[1] ) || !isxdigit( ptr[2] ) )
201 return 1; /* not encoded */
205 if( ( (unsigned char)( c - 'a' ) < 26 )
206 || ( (unsigned char)( c - 'A' ) < 26 )
207 || ( (unsigned char)( c - '0' ) < 10 )
208 || ( strchr( "-_.", c ) != NULL ) )
211 return 0; /* looks fine - but maybe it is not encoded */