source-git / libsoup

Clone
Source Code
GIT

Blame docs/reference/html/SoupURI.html

c8 c8s master
  1.   4f3c613e634467f4bcbd4f7f8628bfcac5f9f4eb
  2.   docs
  3.   reference
  4.   html
  5.   SoupURI.html
Blob History Raw
rpm-build 4f3c61
rpm-build 4f3c61 
<html>
rpm-build 4f3c61 
<head>
rpm-build 4f3c61 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
rpm-build 4f3c61 
<title>SoupURI: libsoup Reference Manual</title>
rpm-build 4f3c61 
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
rpm-build 4f3c61 
<link rel="home" href="index.html" title="libsoup Reference Manual">
rpm-build 4f3c61 
<link rel="up" href="ch02.html" title="Core API">
rpm-build 4f3c61 
<link rel="prev" href="libsoup-2.4-Top-Level-Domain-utils.html" title="Top Level Domain utils">
rpm-build 4f3c61 
<link rel="next" href="libsoup-2.4-Version-Information.html" title="Version Information">
rpm-build 4f3c61 
<meta name="generator" content="GTK-Doc V1.28.1 (XML mode)">
rpm-build 4f3c61 
<link rel="stylesheet" href="style.css" type="text/css">
rpm-build 4f3c61 
</head>
rpm-build 4f3c61 
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Top  | 
rpm-build 4f3c61 
                  Description  | 
rpm-build 4f3c61 
                  Object Hierarchy
rpm-build 4f3c61
rpm-build 4f3c61 
Home
rpm-build 4f3c61 
Up
rpm-build 4f3c61 
Prev
rpm-build 4f3c61 
Next
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SoupURI
rpm-build 4f3c61 
SoupURI — URIs
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Functions
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SoupURI *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_new_with_base ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SoupURI *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_new ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_to_string ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SoupURI *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_copy ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SoupURI *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_copy_host ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
gboolean
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_equal ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
gboolean
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_host_equal ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
guint
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_host_hash ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_free ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_encode ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_decode ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_normalize ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
gboolean
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_uses_default_port ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_IS_VALID()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_VALID_FOR_HTTP()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_scheme ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
const char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_scheme ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_user ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
const char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_user ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_password ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
const char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_password ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_host ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
const char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_host ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_port ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
guint
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_port ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_path ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
const char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_path ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_query ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_query_from_form ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_query_from_fields ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
const char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_query ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
void
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_fragment ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
const char *
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_fragment ()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Types and Values
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
 
rpm-build 4f3c61 
SoupURI
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61 
SOUP_URI_SCHEME_HTTP
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61 
SOUP_URI_SCHEME_HTTPS
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61 
SOUP_URI_SCHEME_DATA
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61 
SOUP_URI_SCHEME_FILE
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61 
SOUP_URI_SCHEME_FTP
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61 
SOUP_URI_SCHEME_RESOURCE
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61 
SOUP_URI_SCHEME_WS
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
#define
rpm-build 4f3c61 
SOUP_URI_SCHEME_WSS
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Object Hierarchy
rpm-build 4f3c61 
    GBoxed
rpm-build 4f3c61 
    ╰── SoupURI
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Includes
rpm-build 4f3c61 
#include <libsoup/soup.h>
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Description
rpm-build 4f3c61 
A SoupURI represents a (parsed) URI.
rpm-build 4f3c61 
Many applications will not need to use SoupURI directly at all; on
rpm-build 4f3c61 
the client side, soup_message_new() takes a stringified URI, and on
rpm-build 4f3c61 
the server side, the path and query components are provided for you
rpm-build 4f3c61 
in the server callback.
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Functions
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_new_with_base ()
rpm-build 4f3c61 
SoupURI *
rpm-build 4f3c61 
soup_uri_new_with_base (SoupURI *base,
rpm-build 4f3c61 
                        const char *uri_string);
rpm-build 4f3c61 
Parses uri_string
rpm-build 4f3c61 
 relative to base
rpm-build 4f3c61 
.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
base
rpm-build 4f3c61 
a base URI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri_string
rpm-build 4f3c61 
the URI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 a parsed SoupURI.
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_new ()
rpm-build 4f3c61 
SoupURI *
rpm-build 4f3c61 
soup_uri_new (const char *uri_string);
rpm-build 4f3c61 
Parses an absolute URI.
rpm-build 4f3c61 
You can also pass NULL for uri_string
rpm-build 4f3c61 
 if you want to get back an
rpm-build 4f3c61 
"empty" SoupURI that you can fill in by hand. (You will need to
rpm-build 4f3c61 
call at least soup_uri_set_scheme() and soup_uri_set_path(), since
rpm-build 4f3c61 
those fields are required.)
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri_string
rpm-build 4f3c61 
a URI.
rpm-build 4f3c61 
[allow-none]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
a SoupURI, or NULL if the given string
rpm-build 4f3c61 
was found to be invalid.
rpm-build 4f3c61 
[nullable]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_to_string ()
rpm-build 4f3c61 
char *
rpm-build 4f3c61 
soup_uri_to_string (SoupURI *uri,
rpm-build 4f3c61 
                    gboolean just_path_and_query);
rpm-build 4f3c61 
Returns a string representing uri
rpm-build 4f3c61 
.
rpm-build 4f3c61 
If just_path_and_query
rpm-build 4f3c61 
 is TRUE, this concatenates the path and query
rpm-build 4f3c61 
together. That is, it constructs the string that would be needed in
rpm-build 4f3c61 
the Request-Line of an HTTP request for uri
rpm-build 4f3c61 
.
rpm-build 4f3c61 
Note that the output will never contain a password, even if uri
rpm-build 4f3c61
rpm-build 4f3c61 
does.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
just_path_and_query
rpm-build 4f3c61 
if TRUE, output just the path and query portions
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 a string representing uri
rpm-build 4f3c61 
, which the caller must free.
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_copy ()
rpm-build 4f3c61 
SoupURI *
rpm-build 4f3c61 
soup_uri_copy (SoupURI *uri);
rpm-build 4f3c61 
Copies uri
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 a copy of uri
rpm-build 4f3c61 
, which must be freed with soup_uri_free()
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_copy_host ()
rpm-build 4f3c61 
SoupURI *
rpm-build 4f3c61 
soup_uri_copy_host (SoupURI *uri);
rpm-build 4f3c61 
Makes a copy of uri
rpm-build 4f3c61 
, considering only the protocol, host, and port
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 the new SoupURI
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.28
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_equal ()
rpm-build 4f3c61 
gboolean
rpm-build 4f3c61 
soup_uri_equal (SoupURI *uri1,
rpm-build 4f3c61 
                SoupURI *uri2);
rpm-build 4f3c61 
Tests whether or not uri1
rpm-build 4f3c61 
 and uri2
rpm-build 4f3c61 
 are equal in all parts
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri1
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri2
rpm-build 4f3c61 
another SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 TRUE or FALSE
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_host_equal ()
rpm-build 4f3c61 
gboolean
rpm-build 4f3c61 
soup_uri_host_equal (gconstpointer v1,
rpm-build 4f3c61 
                     gconstpointer v2);
rpm-build 4f3c61 
Compares v1
rpm-build 4f3c61 
 and v2
rpm-build 4f3c61 
, considering only the scheme, host, and port.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
v1
rpm-build 4f3c61 
a SoupURI with a non-NULL host
rpm-build 4f3c61 
member.
rpm-build 4f3c61 
[type Soup.URI]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
v2
rpm-build 4f3c61 
a SoupURI with a non-NULL host
rpm-build 4f3c61 
member.
rpm-build 4f3c61 
[type Soup.URI]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 whether or not the URIs are equal in scheme, host,
rpm-build 4f3c61 
and port.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.28
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_host_hash ()
rpm-build 4f3c61 
guint
rpm-build 4f3c61 
soup_uri_host_hash (gconstpointer key);
rpm-build 4f3c61 
Hashes key
rpm-build 4f3c61 
, considering only the scheme, host, and port.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
key
rpm-build 4f3c61 
a SoupURI with a non-NULL host
rpm-build 4f3c61 
member.
rpm-build 4f3c61 
[type Soup.URI]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 a hash
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.28
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_free ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_free (SoupURI *uri);
rpm-build 4f3c61 
Frees uri
rpm-build 4f3c61 
.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_encode ()
rpm-build 4f3c61 
char *
rpm-build 4f3c61 
soup_uri_encode (const char *part,
rpm-build 4f3c61 
                 const char *escape_extra);
rpm-build 4f3c61 
This %-encodes the given URI part and returns the escaped
rpm-build 4f3c61 
version in allocated memory, which the caller must free when it is
rpm-build 4f3c61 
done.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
part
rpm-build 4f3c61 
a URI part
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
escape_extra
rpm-build 4f3c61 
additional reserved characters to
rpm-build 4f3c61 
escape (or NULL).
rpm-build 4f3c61 
[allow-none]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 the encoded URI part
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_decode ()
rpm-build 4f3c61 
char *
rpm-build 4f3c61 
soup_uri_decode (const char *part);
rpm-build 4f3c61 
Fully %-decodes part
rpm-build 4f3c61 
.
rpm-build 4f3c61 
In the past, this would return NULL if part
rpm-build 4f3c61 
 contained invalid
rpm-build 4f3c61 
percent-encoding, but now it just ignores the problem (as
rpm-build 4f3c61 
soup_uri_new() already did).
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
part
rpm-build 4f3c61 
a URI part
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 the decoded URI part.
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_normalize ()
rpm-build 4f3c61 
char *
rpm-build 4f3c61 
soup_uri_normalize (const char *part,
rpm-build 4f3c61 
                    const char *unescape_extra);
rpm-build 4f3c61 
%-decodes any "unreserved" characters (or characters in
rpm-build 4f3c61 
unescape_extra
rpm-build 4f3c61 
) in part
rpm-build 4f3c61 
, and %-encodes any non-ASCII
rpm-build 4f3c61 
characters, spaces, and non-printing characters in part
rpm-build 4f3c61 
.
rpm-build 4f3c61 
"Unreserved" characters are those that are not allowed to be used
rpm-build 4f3c61 
for punctuation according to the URI spec. For example, letters are
rpm-build 4f3c61 
unreserved, so soup_uri_normalize() will turn
rpm-build 4f3c61 
http://example.com/foo/b%61r into
rpm-build 4f3c61 
http://example.com/foo/bar, which is guaranteed
rpm-build 4f3c61 
to mean the same thing. However, "/" is "reserved", so
rpm-build 4f3c61 
http://example.com/foo%2Fbar would not
rpm-build 4f3c61 
be changed, because it might mean something different to the
rpm-build 4f3c61 
server.
rpm-build 4f3c61 
In the past, this would return NULL if part
rpm-build 4f3c61 
 contained invalid
rpm-build 4f3c61 
percent-encoding, but now it just ignores the problem (as
rpm-build 4f3c61 
soup_uri_new() already did).
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
part
rpm-build 4f3c61 
a URI part
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
unescape_extra
rpm-build 4f3c61 
reserved characters to unescape (or NULL).
rpm-build 4f3c61 
[allow-none]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 the normalized URI part
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_uses_default_port ()
rpm-build 4f3c61 
gboolean
rpm-build 4f3c61 
soup_uri_uses_default_port (SoupURI *uri);
rpm-build 4f3c61 
Tests if uri
rpm-build 4f3c61 
 uses the default port for its scheme. (Eg, 80 for
rpm-build 4f3c61 
http.) (This only works for http, https and ftp; libsoup does not know
rpm-build 4f3c61 
the default ports of other protocols.)
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 TRUE or FALSE
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_IS_VALID()
rpm-build 4f3c61 
#define   SOUP_URI_IS_VALID(uri)       ((uri) && (uri)->scheme && (uri)->path)
rpm-build 4f3c61
rpm-build 4f3c61 
Tests whether uri
rpm-build 4f3c61 
 is a valid SoupURI; that is, that it is non-NULL
rpm-build 4f3c61 
and its scheme
rpm-build 4f3c61 
 and path
rpm-build 4f3c61 
 members are also non-NULL.
rpm-build 4f3c61 
This macro does not check whether http and https URIs have a non-NULL
rpm-build 4f3c61 
host
rpm-build 4f3c61 
 member.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 TRUE if uri
rpm-build 4f3c61 
is valid for use.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.38
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_VALID_FOR_HTTP()
rpm-build 4f3c61 
#define   SOUP_URI_VALID_FOR_HTTP(uri) ((uri) && ((uri)->scheme == SOUP_URI_SCHEME_HTTP || (uri)->scheme == SOUP_URI_SCHEME_HTTPS) && (uri)->host && (uri)->path)
rpm-build 4f3c61
rpm-build 4f3c61 
Tests if uri
rpm-build 4f3c61 
 is a valid SoupURI for HTTP communication; that is, if
rpm-build 4f3c61 
it can be used to construct a SoupMessage.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 TRUE if uri
rpm-build 4f3c61 
is a valid "http" or "https" URI.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.24
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_scheme ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_scheme (SoupURI *uri,
rpm-build 4f3c61 
                     const char *scheme);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's scheme to scheme
rpm-build 4f3c61 
. This will also set uri
rpm-build 4f3c61 
's port to
rpm-build 4f3c61 
the default port for scheme
rpm-build 4f3c61 
, if known.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
scheme
rpm-build 4f3c61 
the URI scheme
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_scheme ()
rpm-build 4f3c61 
const char *
rpm-build 4f3c61 
soup_uri_get_scheme (SoupURI *uri);
rpm-build 4f3c61 
Gets uri
rpm-build 4f3c61 
's scheme.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 uri
rpm-build 4f3c61 
's scheme.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.32
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_user ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_user (SoupURI *uri,
rpm-build 4f3c61 
                   const char *user);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's user to user
rpm-build 4f3c61 
.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
user
rpm-build 4f3c61 
the username, or NULL.
rpm-build 4f3c61 
[allow-none]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_user ()
rpm-build 4f3c61 
const char *
rpm-build 4f3c61 
soup_uri_get_user (SoupURI *uri);
rpm-build 4f3c61 
Gets uri
rpm-build 4f3c61 
's user.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 uri
rpm-build 4f3c61 
's user.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.32
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_password ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_password (SoupURI *uri,
rpm-build 4f3c61 
                       const char *password);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's password to password
rpm-build 4f3c61 
.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
password
rpm-build 4f3c61 
the password, or NULL.
rpm-build 4f3c61 
[allow-none]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_password ()
rpm-build 4f3c61 
const char *
rpm-build 4f3c61 
soup_uri_get_password (SoupURI *uri);
rpm-build 4f3c61 
Gets uri
rpm-build 4f3c61 
's password.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 uri
rpm-build 4f3c61 
's password.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.32
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_host ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_host (SoupURI *uri,
rpm-build 4f3c61 
                   const char *host);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's host to host
rpm-build 4f3c61 
.
rpm-build 4f3c61 
If host
rpm-build 4f3c61 
 is an IPv6 IP address, it should not include the brackets
rpm-build 4f3c61 
required by the URI syntax; they will be added automatically when
rpm-build 4f3c61 
converting uri
rpm-build 4f3c61 
 to a string.
rpm-build 4f3c61 
http and https URIs should not have a NULL host
rpm-build 4f3c61 
.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
host
rpm-build 4f3c61 
the hostname or IP address, or NULL.
rpm-build 4f3c61 
[allow-none]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_host ()
rpm-build 4f3c61 
const char *
rpm-build 4f3c61 
soup_uri_get_host (SoupURI *uri);
rpm-build 4f3c61 
Gets uri
rpm-build 4f3c61 
's host.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 uri
rpm-build 4f3c61 
's host.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.32
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_port ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_port (SoupURI *uri,
rpm-build 4f3c61 
                   guint port);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's port to port
rpm-build 4f3c61 
. If port
rpm-build 4f3c61 
 is 0, uri
rpm-build 4f3c61 
 will not have an
rpm-build 4f3c61 
explicitly-specified port.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
port
rpm-build 4f3c61 
the port, or 0
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_port ()
rpm-build 4f3c61 
guint
rpm-build 4f3c61 
soup_uri_get_port (SoupURI *uri);
rpm-build 4f3c61 
Gets uri
rpm-build 4f3c61 
's port.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 uri
rpm-build 4f3c61 
's port.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.32
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_path ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_path (SoupURI *uri,
rpm-build 4f3c61 
                   const char *path);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's path to path
rpm-build 4f3c61 
.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
path
rpm-build 4f3c61 
the non-NULL path
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_path ()
rpm-build 4f3c61 
const char *
rpm-build 4f3c61 
soup_uri_get_path (SoupURI *uri);
rpm-build 4f3c61 
Gets uri
rpm-build 4f3c61 
's path.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 uri
rpm-build 4f3c61 
's path.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.32
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_query ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_query (SoupURI *uri,
rpm-build 4f3c61 
                    const char *query);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's query to query
rpm-build 4f3c61 
.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
query
rpm-build 4f3c61 
the query.
rpm-build 4f3c61 
[allow-none]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_query_from_form ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_query_from_form (SoupURI *uri,
rpm-build 4f3c61 
                              GHashTable *form);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's query to the result of encoding form
rpm-build 4f3c61 
 according to the
rpm-build 4f3c61 
HTML form rules. See soup_form_encode_hash() for more information.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
form
rpm-build 4f3c61 
a GHashTable containing HTML form
rpm-build 4f3c61 
information.
rpm-build 4f3c61 
[element-type utf8 utf8]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_query_from_fields ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_query_from_fields (SoupURI *uri,
rpm-build 4f3c61 
                                const char *first_field,
rpm-build 4f3c61 
                                ...);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's query to the result of encoding the given form fields
rpm-build 4f3c61 
and values according to the * HTML form rules. See
rpm-build 4f3c61 
soup_form_encode() for more information.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
first_field
rpm-build 4f3c61 
name of the first form field to encode into query
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
...
rpm-build 4f3c61 
value of first_field
rpm-build 4f3c61 
, followed by additional field names
rpm-build 4f3c61 
and values, terminated by NULL.
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_query ()
rpm-build 4f3c61 
const char *
rpm-build 4f3c61 
soup_uri_get_query (SoupURI *uri);
rpm-build 4f3c61 
Gets uri
rpm-build 4f3c61 
's query.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 uri
rpm-build 4f3c61 
's query.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.32
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_set_fragment ()
rpm-build 4f3c61 
void
rpm-build 4f3c61 
soup_uri_set_fragment (SoupURI *uri,
rpm-build 4f3c61 
                       const char *fragment);
rpm-build 4f3c61 
Sets uri
rpm-build 4f3c61 
's fragment to fragment
rpm-build 4f3c61 
.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
fragment
rpm-build 4f3c61 
the fragment.
rpm-build 4f3c61 
[allow-none]
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
soup_uri_get_fragment ()
rpm-build 4f3c61 
const char *
rpm-build 4f3c61 
soup_uri_get_fragment (SoupURI *uri);
rpm-build 4f3c61 
Gets uri
rpm-build 4f3c61 
's fragment.
rpm-build 4f3c61
rpm-build 4f3c61 
Parameters
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
uri
rpm-build 4f3c61 
a SoupURI
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Returns
rpm-build 4f3c61 
 uri
rpm-build 4f3c61 
's fragment.
rpm-build 4f3c61
rpm-build 4f3c61 
Since: 2.32
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Types and Values
rpm-build 4f3c61
rpm-build 4f3c61 
SoupURI
rpm-build 4f3c61 
typedef struct {
rpm-build 4f3c61 
	const char *scheme;
rpm-build 4f3c61
rpm-build 4f3c61 
	char       *user;
rpm-build 4f3c61 
	char       *password;
rpm-build 4f3c61
rpm-build 4f3c61 
	char       *host;
rpm-build 4f3c61 
	guint       port;
rpm-build 4f3c61
rpm-build 4f3c61 
	char       *path;
rpm-build 4f3c61 
	char       *query;
rpm-build 4f3c61
rpm-build 4f3c61 
	char       *fragment;
rpm-build 4f3c61 
} SoupURI;
rpm-build 4f3c61
rpm-build 4f3c61 
A SoupURI represents a (parsed) URI. SoupURI supports RFC 3986
rpm-build 4f3c61 
(URI Generic Syntax), and can parse any valid URI. However, libsoup
rpm-build 4f3c61 
only uses "http" and "https" URIs internally; You can use
rpm-build 4f3c61 
SOUP_URI_VALID_FOR_HTTP() to test if a SoupURI is a valid HTTP
rpm-build 4f3c61 
URI.
rpm-build 4f3c61 
scheme
rpm-build 4f3c61 
 will always be set in any URI. It is an interned string and
rpm-build 4f3c61 
is always all lowercase. (If you parse a URI with a non-lowercase
rpm-build 4f3c61 
scheme, it will be converted to lowercase.) The macros
rpm-build 4f3c61 
SOUP_URI_SCHEME_HTTP and SOUP_URI_SCHEME_HTTPS provide the
rpm-build 4f3c61 
interned values for "http" and "https" and can be compared against
rpm-build 4f3c61 
URI scheme
rpm-build 4f3c61 
 values.
rpm-build 4f3c61 
user
rpm-build 4f3c61 
 and password
rpm-build 4f3c61 
 are parsed as defined in the older URI specs
rpm-build 4f3c61 
(ie, separated by a colon; RFC 3986 only talks about a single
rpm-build 4f3c61 
"userinfo" field). Note that password
rpm-build 4f3c61 
 is not included in the
rpm-build 4f3c61 
output of soup_uri_to_string(). libsoup does not normally use these
rpm-build 4f3c61 
fields; authentication is handled via SoupSession signals.
rpm-build 4f3c61 
host
rpm-build 4f3c61 
 contains the hostname, and port
rpm-build 4f3c61 
 the port specified in the
rpm-build 4f3c61 
URI. If the URI doesn't contain a hostname, host
rpm-build 4f3c61 
 will be NULL,
rpm-build 4f3c61 
and if it doesn't specify a port, port
rpm-build 4f3c61 
 may be 0. However, for
rpm-build 4f3c61 
"http" and "https" URIs, host
rpm-build 4f3c61 
 is guaranteed to be non-NULL
rpm-build 4f3c61 
(trying to parse an http URI with no host
rpm-build 4f3c61 
 will return NULL), and
rpm-build 4f3c61 
port
rpm-build 4f3c61 
 will always be non-0 (because libsoup knows the default value
rpm-build 4f3c61 
to use when it is not specified in the URI).
rpm-build 4f3c61 
path
rpm-build 4f3c61 
 is always non-NULL. For http/https URIs, path
rpm-build 4f3c61 
 will never be
rpm-build 4f3c61 
an empty string either; if the input URI has no path, the parsed
rpm-build 4f3c61 
SoupURI will have a path
rpm-build 4f3c61 
 of "/".
rpm-build 4f3c61 
query
rpm-build 4f3c61 
 and fragment
rpm-build 4f3c61 
 are optional for all URI types.
rpm-build 4f3c61 
soup_form_decode() may be useful for parsing query
rpm-build 4f3c61 
.
rpm-build 4f3c61 
Note that path
rpm-build 4f3c61 
, query
rpm-build 4f3c61 
, and fragment
rpm-build 4f3c61 
 may contain
rpm-build 4f3c61 
%-encoded characters. soup_uri_new() calls
rpm-build 4f3c61 
soup_uri_normalize() on them, but not soup_uri_decode(). This is
rpm-build 4f3c61 
necessary to ensure that soup_uri_to_string() will generate a URI
rpm-build 4f3c61 
that has exactly the same meaning as the original. (In theory,
rpm-build 4f3c61 
SoupURI should leave user
rpm-build 4f3c61 
, password
rpm-build 4f3c61 
, and host
rpm-build 4f3c61 
 partially-encoded
rpm-build 4f3c61 
as well, but this would be more annoying than useful.)
rpm-build 4f3c61
rpm-build 4f3c61 
Members
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
const char *scheme;
rpm-build 4f3c61 
the URI scheme (eg, "http")
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *user;
rpm-build 4f3c61 
a username, or NULL
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *password;
rpm-build 4f3c61 
a password, or NULL
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *host;
rpm-build 4f3c61 
the hostname or IP address, or NULL
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
guint port;
rpm-build 4f3c61 
the port number on host
rpm-build 4f3c61
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *path;
rpm-build 4f3c61 
the path on host
rpm-build 4f3c61
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *query;
rpm-build 4f3c61 
a query for path
rpm-build 4f3c61 
, or NULL
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
char *fragment;
rpm-build 4f3c61 
a fragment identifier within path
rpm-build 4f3c61 
, or NULL
rpm-build 4f3c61 
 
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_SCHEME_HTTP
rpm-build 4f3c61 
#define SOUP_URI_SCHEME_HTTP     _SOUP_ATOMIC_INTERN_STRING (_SOUP_URI_SCHEME_HTTP, "http")
rpm-build 4f3c61
rpm-build 4f3c61 
"http" as an interned string; you can compare this directly to a
rpm-build 4f3c61 
SoupURI's scheme field using
rpm-build 4f3c61 
==.
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_SCHEME_HTTPS
rpm-build 4f3c61 
#define SOUP_URI_SCHEME_HTTPS    _SOUP_ATOMIC_INTERN_STRING (_SOUP_URI_SCHEME_HTTPS, "https")
rpm-build 4f3c61
rpm-build 4f3c61 
"https" as an interned string; you can compare this directly to a
rpm-build 4f3c61 
SoupURI's scheme field using
rpm-build 4f3c61 
==.
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_SCHEME_DATA
rpm-build 4f3c61 
#define SOUP_URI_SCHEME_DATA     _SOUP_ATOMIC_INTERN_STRING (_SOUP_URI_SCHEME_DATA, "data")
rpm-build 4f3c61
rpm-build 4f3c61 
"data" as an interned string; you can compare this directly to a
rpm-build 4f3c61 
SoupURI's scheme field using
rpm-build 4f3c61 
==.
rpm-build 4f3c61 
Since: 2.30
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_SCHEME_FILE
rpm-build 4f3c61 
#define SOUP_URI_SCHEME_FILE     _SOUP_ATOMIC_INTERN_STRING (_SOUP_URI_SCHEME_FILE, "file")
rpm-build 4f3c61
rpm-build 4f3c61 
"file" as an interned string; you can compare this directly to a
rpm-build 4f3c61 
SoupURI's scheme field using
rpm-build 4f3c61 
==.
rpm-build 4f3c61 
Since: 2.30
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_SCHEME_FTP
rpm-build 4f3c61 
#define SOUP_URI_SCHEME_FTP      _SOUP_ATOMIC_INTERN_STRING (_SOUP_URI_SCHEME_FTP, "ftp")
rpm-build 4f3c61
rpm-build 4f3c61 
"ftp" as an interned string; you can compare this directly to a
rpm-build 4f3c61 
SoupURI's scheme field using
rpm-build 4f3c61 
==.
rpm-build 4f3c61 
Since: 2.30
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_SCHEME_RESOURCE
rpm-build 4f3c61 
#define SOUP_URI_SCHEME_RESOURCE _SOUP_ATOMIC_INTERN_STRING (_SOUP_URI_SCHEME_RESOURCE, "resource")
rpm-build 4f3c61
rpm-build 4f3c61 
"data" as an interned string; you can compare this directly to a
rpm-build 4f3c61 
SoupURI's scheme field using
rpm-build 4f3c61 
==.
rpm-build 4f3c61 
Since: 2.42
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_SCHEME_WS
rpm-build 4f3c61 
#define SOUP_URI_SCHEME_WS       _SOUP_ATOMIC_INTERN_STRING (_SOUP_URI_SCHEME_WS, "ws")
rpm-build 4f3c61
rpm-build 4f3c61 
"ws" (WebSocket) as an interned string; you can compare this
rpm-build 4f3c61 
directly to a SoupURI's scheme field using
rpm-build 4f3c61 
==.
rpm-build 4f3c61 
Since: 2.50
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
SOUP_URI_SCHEME_WSS
rpm-build 4f3c61 
#define SOUP_URI_SCHEME_WSS      _SOUP_ATOMIC_INTERN_STRING (_SOUP_URI_SCHEME_WSS, "wss")
rpm-build 4f3c61
rpm-build 4f3c61 
"wss" (WebSocket over TLS) as an interned string; you can compare
rpm-build 4f3c61 
this directly to a SoupURI's scheme field using
rpm-build 4f3c61 
==.
rpm-build 4f3c61 
Since: 2.50
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61
rpm-build 4f3c61 
Generated by GTK-Doc V1.28.1
rpm-build 4f3c61 
</body>
rpm-build 4f3c61 
</html>

Powered by Pagure 5.13.3

SSH Hostkey/Fingerprint | Documentation