Name

XmHTMLGetURLType - obtain the classification of a Uniform Resource Locator.

Synopsis

URLType XmHTMLGetURLType(String href)

Description

XmHTMLGetURLType classifies Uniform Resource Locators (URLs). A URL can be thought of as a networked extension of the standard filename concept: not only can it point to a file (in a directory), but that file (and directory) can exist on any machine in a network, and can be served via any of several methods. It might not even be a file: URLs can also point to queries, documents stored within databases, the results of commands,...

href

Specifies the URL to be classified.

Return Value

One of the following constants (port numbers are only shown for demonstration purposes):

	typedef enum{
		ANCHOR_UNKNOWN = 0,  /* unknown href                      */
		ANCHOR_NAMED,        /* name="...."                       */
		ANCHOR_JUMP,         /* href="#..."                       */
		ANCHOR_FILE_LOCAL,   /* href="file.html"
                              * href="file:/file.html" (clearly local)
                              * href="file:///file.html" (NULL host)
                              * href="file://localhost/file.html" (localhost)
                              */
		ANCHOR_FILE_REMOTE,  /* href="file://foo.bar/file.html"   */
		ANCHOR_FTP,          /* href="ftp://foo.bar/file"         */
		ANCHOR_HTTP,         /* href="http://foo.bar/file.html"   */
		ANCHOR_SECURE_HTTP,  /* href="https://foo.bar/file.html"  */
		ANCHOR_GOPHER,       /* href="gopher://foo.bar:70"        */
		ANCHOR_WAIS,         /* href="wais://foo.bar"             */
		ANCHOR_NEWS,         /* href="news://foo.bar"             */
		ANCHOR_TELNET,       /* href="telnet://foo.bar:23"        */
		ANCHOR_MAILTO,       /* href="mailto:foo@bar"             */
		ANCHOR_EXEC,         /* href="exec:foo_bar"               */
		ANCHOR_PIPE          /* href="pipe:foo_bar"               */
	}URLType

See Also

XmHTML(3X), RFC 1738