uri.hpp

Go to the documentation of this file.

#ifndef COMPA_GENLIB_NET_URI_HPP
#define COMPA_GENLIB_NET_URI_HPP
/* *****************************************************************************
 *
 * Copyright (c) 2000-2003 Intel Corporation
 * All rights reserved.
 * Copyright (C) 2021+ GPL 3 and higher by Ingo Höft, <Ingo@Hoeft-online.de>
 * Redistribution only with this Copyright remark. Last modified: 2025-06-11
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * - Redistributions of source code must retain the above copyright notice,
 * this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright notice,
 * this list of conditions and the following disclaimer in the documentation
 * and/or other materials provided with the distribution.
 * - Neither name of Intel Corporation nor the names of its contributors
 * may be used to endorse or promote products derived from this software
 * without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTEL OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * ****************************************************************************/
#include <UPnPsdk/visibility.hpp>
 
#include <cctype>
#include <cstring>
 
#ifndef _WIN32
#include <netdb.h> /* for struct addrinfo */
#endif
 
#ifdef _WIN32
#define strncasecmp strnicmp
#else
/* Other systems have strncasecmp */
#endif
 
namespace compa {
 
// Must not use ABSOLUTE, RELATIVE; already defined in Win32 for other meaning.
enum struct uriType { Absolute, Relative };
 
enum struct pathType { ABS_PATH, REL_PATH, OPAQUE_PART };
 
} // namespace compa
 
 
inline constexpr int HTTP_SUCCESS{1};
 
struct token {
    const char* buff; 
    size_t size;      
};
 
struct hostport_type {
    token text; 
    sockaddr_storage IPaddress; 
};
 
struct uri_type {
    compa::uriType type;
    token scheme;
    compa::pathType path_type;
    token pathquery;
    token fragment;
    hostport_type hostport;
};
 
struct URL_list {
    size_t size;          
    char* URLs;           
    uri_type* parsedURLs; 
};
 
UPnPsdk_VIS int replace_escaped(
    char* in,
    size_t index,
    size_t* max);
 
UPnPsdk_VIS int copy_URL_list(
    URL_list* in,
    URL_list* out);
 
UPnPsdk_VIS void free_URL_list(
    URL_list* list);
 
#if defined(DEBUG) || defined(DOXYGEN_RUN)
void print_uri(uri_type* in 
);
#else
#define print_uri(in)                                                          \
    do {                                                                       \
    } while (0)
#endif
 
#if defined(DEBUG) || defined(DOXYGEN_RUN)
void print_token( //
    token* in     
);
#else
#define print_token(in)                                                        \
    do {                                                                       \
    } while (0)
#endif
 
UPnPsdk_VIS int token_string_casecmp(
    token* in1,
    const char* in2);
 
UPnPsdk_VIS int token_cmp(
    token* in1,
    token* in2);
 
UPnPsdk_VIS int remove_escaped_chars(
    char* in,
    size_t* size);
 
UPnPsdk_VIS int remove_dots(
    char* buf,
    size_t size);
 
UPnPsdk_VIS char* resolve_rel_url(
    char* base_url,
    char* rel_url);
 
UPnPsdk_VIS int parse_uri(
    const char* in,
    size_t max,
    uri_type* out);
 
int parse_token(
    char* in,
    token* out,
    int max_size);
 
#endif /* COMPA_GENLIB_NET_URI_HPP */