Function

Coguri_guess_from_user_input

Declaration [src]

char*
cog_uri_guess_from_user_input (
  const char* uri_like,
  gboolean is_cli_arg,
  GError** error
)

Description [src]

Tries to assemble a valid URI from input that resembles an URI.

First, if is_cli_arg is set, the input string is converted to UTF-8. Then, the following heuristics may applied:

If the input is already a valid URI with a known scheme, return it as-is.
If the input is a relative path, or resembles a local file path, try to resolve it to a full path and return a file:// URI.
If an URI does not have any path, set / as the path.
As a last resort, try to prepend the http:// scheme.

The main use case for this function is turning some “simpler” version of an URI, as typically entered by an user in a browser URL entry (e.g. wpewebkit.org/release) and turn it into an actual URI (http://wpewebkit.org/release/) which can be then passed to WebKit.WebView.load_uri.

Parameters

`uri_like`	`const char*`
	String containing an URI-like value.
	The data is owned by the caller of the function.
	The string is a NUL terminated UTF-8 string.
`is_cli_arg`	`gboolean`
	Whether the URI-like string is from a command line option.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`char*`
	A valid, full URI as a string. If `NULL` is returned, the `error` will also be set.
	The caller of the function takes ownership of the data, and is responsible for freeing it.
	The string is a NUL terminated UTF-8 string.