• Places
    • Home
    • Graphs
    • Prefixes
  • Admin
    • Users
    • Settings
    • Plugins
    • Statistics
  • CPACK
    • Home
    • List packs
    • Submit pack
  • Repository
    • Load local file
    • Load from HTTP
    • Load from library
    • Remove triples
    • Clear repository
  • Query
    • YASGUI SPARQL Editor
    • Simple Form
    • SWISH Prolog shell
  • Help
    • Documentation
    • Tutorial
    • Roadmap
    • HTTP Services
  • Login

/home/swipl/lib/swipl/library/url.pl
AllApplicationManualNameSummaryHelp

  • swipl
    • library
      • error.pl -- Error generating support
      • apply.pl -- Apply predicates on a list
      • lists.pl -- List Manipulation
      • debug.pl -- Print debug messages and test assertions
      • broadcast.pl -- Event service
      • socket.pl -- Network socket (TCP and UDP) library
      • predicate_options.pl -- Access and analyse predicate options
      • shlib.pl -- Utility library for loading foreign objects (DLLs, shared objects)
      • option.pl -- Option list processing
      • uid.pl -- User and group management on Unix systems
      • unix.pl -- Unix specific operations
      • syslog.pl -- Unix syslog interface
      • thread_pool.pl -- Resource bounded thread management
      • gensym.pl -- Generate unique symbols
      • settings.pl -- Setting management
      • arithmetic.pl -- Extensible arithmetic
      • main.pl -- Provide entry point for scripts
      • readutil.pl -- Read utilities
      • ssl.pl -- Secure Socket Layer (SSL) library
      • crypto.pl -- Cryptography and authentication library
      • filesex.pl -- Extended operations on files
      • doc_http.pl -- Documentation server
      • pldoc.pl -- Process source documentation
      • operators.pl -- Manage operators
      • pairs.pl -- Operations on key-value lists
      • prolog_source.pl -- Examine Prolog source-files
      • sgml.pl -- SGML, XML and HTML parser
      • quasi_quotations.pl -- Define Quasi Quotation syntax
      • uri.pl -- Process URIs
      • url.pl -- Analysing and constructing URL
        • global_url/3
        • is_absolute_url/1
        • http_location/2
        • parse_url/2
        • parse_url/3
        • www_form_encode/2
        • set_url_encoding/2
        • url_iri/2
        • parse_url_search/2
        • file_name_to_url/2
      • www_browser.pl -- Open a URL in the users browser
      • prolog_colour.pl -- Prolog syntax colouring support.
      • record.pl -- Access compound arguments by name
      • prolog_xref.pl -- Prolog cross-referencer data collection
      • occurs.pl -- Finding and counting sub-terms
      • ordsets.pl -- Ordered set manipulation
      • assoc.pl -- Binary associations
      • ugraphs.pl -- Graph manipulation library
      • memfile.pl
      • xpath.pl -- Select nodes in an XML DOM
      • iostream.pl -- Utilities to deal with streams
      • atom.pl -- Operations on atoms
      • porter_stem.pl
      • solution_sequences.pl -- Modify solution sequences
      • prolog_pack.pl -- A package manager for Prolog
      • prolog_config.pl -- Provide configuration information
      • process.pl -- Create processes and redirect I/O
      • git.pl -- Run GIT commands
      • ctypes.pl -- Character code classification
      • time.pl -- Time and alarm library
      • utf8.pl -- UTF-8 encoding/decoding on lists of character codes.
      • base64.pl -- Base64 encoding and decoding
      • sha.pl -- SHA secure hashes
      • crypt.pl
      • persistency.pl -- Provide persistent dynamic predicates
      • pure_input.pl -- Pure Input from files and streams
      • nb_set.pl -- Non-backtrackable sets
      • xsdp_types.pl -- XML-Schema primitive types
      • uuid.pl -- Universally Unique Identifier (UUID) Library
      • pcre.pl -- Perl compatible regular expression matching for SWI-Prolog
      • aggregate.pl -- Aggregation operators on backtrackable predicates
      • rdf_write.pl -- Write RDF/XML from a list of triples
      • rdf.pl -- RDF/XML parser
      • sgml_write.pl -- XML/SGML writer module
      • archive.pl -- Access several archive formats
      • csv.pl -- Process CSV (Comma-Separated Values) data
      • dialect.pl -- Support multiple Prolog dialects
      • apply_macros.pl -- Goal expansion rules to avoid meta-calling
      • prolog_code.pl -- Utilities for reasoning about code
      • dif.pl -- The dif/2 constraint
      • thread.pl -- High level thread primitives
      • rdf_triple.pl -- Create triples from intermediate representation
      • rdf_parser.pl
      • rewrite_term.pl
      • rbtrees.pl -- Red black trees
      • nb_rbtrees.pl -- Non-backtrackable operations on red black trees
      • pengines.pl -- Pengines: Web Logic Programming Made Easy
      • yall.pl -- Lambda expressions
      • sandbox.pl -- Sandboxed Prolog code
      • prolog_format.pl -- Analyse format specifications
      • random.pl -- Random numbers
      • pengines_io.pl -- Provide Prolog I/O for HTML clients
      • zlib.pl -- Zlib wrapper for SWI-Prolog
      • bdb.pl -- Berkeley DB interface
      • hash_stream.pl -- Maintain a hash on a stream
      • md5.pl -- MD5 hashes
      • pprint.pl -- Pretty Print Prolog terms
      • modules.pl -- Module utility predicates
      • lazy_lists.pl -- Lazy list handling
      • edinburgh.pl -- Some traditional Edinburgh predicates
      • prolog_clause.pl -- Get detailed source-information about a clause
      • prolog_breakpoints.pl -- Manage Prolog break-points
      • dicts.pl -- Dict utilities
      • backcomp.pl -- Backward compatibility
      • date.pl -- Process dates and times
      • term_to_json.pl
      • snowball.pl -- The Snowball multi-lingual stemmer library
      • system.pl -- System utilities
      • quintus.pl -- Quintus compatibility
      • make.pl -- Reload modified source files
      • edit.pl -- Editor interface
      • prolog_debug.pl -- User level debugging tools
      • intercept.pl -- Intercept and signal interface
      • unicode.pl -- Unicode string handling
      • udp_broadcast.pl -- A UDP broadcast proxy
      • strings.pl -- String utilities
      • charsio.pl -- I/O on Lists of Character Codes
      • statistics.pl -- Get information about resource usage
      • jpl.pl -- A Java interface for SWI Prolog 7.x
      • heaps.pl -- heaps/priority queues
      • tables.pl -- XSB interface to tables
      • increval.pl -- Incremental dynamic predicate modification
      • base32.pl -- Base32 encoding and decoding
      • prolog_history.pl -- Per-directory persistent commandline history
      • readline.pl -- GNU readline interface
      • table.pl
      • sort.pl
      • paxos.pl -- A Replicated Data Store
      • odbc.pl
      • oset.pl -- Ordered set manipulation
      • zip.pl -- Access resource ZIP archives
      • redis.pl -- Redis client
      • check.pl -- Consistency checking
      • prolog_stack.pl -- Examine the Prolog stack
      • threadutil.pl -- Interactive thread utilities
      • prolog_autoload.pl -- Autoload all dependencies
      • qsave.pl -- Save current program as a state or executable
      • stomp.pl -- STOMP client.
      • redis_streams.pl -- Using Redis streams
      • editline.pl -- BSD libedit based command line editing
      • optparse.pl -- command line parsing
      • win_menu.pl -- Console window menu
      • tty.pl -- Terminal operations
      • streampool.pl -- Input multiplexing
      • plunit.pl -- Unit Testing
      • ansi_term.pl -- Print decorated text to ANSI consoles
      • listing.pl -- List programs and pretty print clauses
      • doc_latex.pl -- PlDoc LaTeX backend
      • explain.pl -- Describe Prolog Terms
      • prolog_trace.pl -- Print access to predicates
      • prolog_wrap.pl -- Wrapping predicates
      • wfs.pl -- Well Founded Semantics interface
      • prolog_stream.pl -- A stream with Prolog callbacks
      • shell.pl -- Elementary shell commands
      • terms.pl -- Term manipulation
      • when.pl -- Conditional coroutining
      • mqi.pl
      • prolog_codewalk.pl -- Prolog code walker
      • help.pl -- Text based manual
      • varnumbers.pl -- Utilities for numbered terms
      • hashtable.pl -- Hash tables
      • fastrw.pl -- Fast reading and writing of terms
      • isub.pl -- isub: a string similarity measure
      • files.pl
      • yaml.pl -- Process YAML data
      • protobufs.pl -- Google's Protocol Buffers ("protobufs")
      • codesio.pl -- I/O on Lists of Character Codes
      • coinduction.pl -- Co-Logic Programming
      • portray_text.pl -- Portray text
      • c14n2.pl -- C14n2 canonical XML documents
      • prolog_metainference.pl -- Infer meta-predicate properties
      • pdt_console.pl
      • prolog_jiti.pl -- Just In Time Indexing (JITI) utilities
      • writef.pl -- Old-style formatted write
      • test_cover.pl -- Clause coverage analysis
      • xmlenc.pl -- XML encryption library
      • double_metaphone.pl -- Phonetic string matching
      • xmldsig.pl -- XML Digital signature
      • pwp.pl -- Prolog Well-formed Pages
      • rlimit.pl
      • cgi.pl -- Read CGI parameters
      • doc_files.pl -- Create stand-alone documentation files
 parse_url(?URL, ?Attributes) is det
Construct or analyse a URL. URL is an atom holding a URL or a variable. Attributes is a list of components. Each component is of the format Name(Value). Defined components are:
protocol(Protocol)
The used protocol. This is, after the optional url:, an identifier separated from the remainder of the URL using :. parse_url/2 assumes the http protocol if no protocol is specified and the URL can be parsed as a valid HTTP url. In addition to the RFC-1738 specified protocols, the file protocol is supported as well.
host(Host)
Host-name or IP-address on which the resource is located. Supported by all network-based protocols.
port(Port)
Integer port-number to access on the \arg{Host}. This only appears if the port is explicitly specified in the URL. Implicit default ports (e.g., 80 for HTTP) do not appear in the part-list.
path(Path)
(File-) path addressed by the URL. This is supported for the ftp, http and file protocols. If no path appears, the library generates the path /.
search(ListOfNameValue)
Search-specification of HTTP URL. This is the part after the ?, normally used to transfer data from HTML forms that use the HTTP GET method. In the URL it consists of a www-form-encoded list of Name=Value pairs. This is mapped to a list of Prolog Name=Value terms with decoded names and values.
fragment(Fragment)
Fragment specification of HTTP URL. This is the part after the # character.

The example below illustrates all of this for an HTTP URL.

?- parse_url('http://www.xyz.org/hello?msg=Hello+World%21#x',
       P).

P = [ protocol(http),
      host('www.xyz.org'),
      fragment(x),
      search([ msg = 'Hello World!'
             ]),
      path('/hello')
    ]

By instantiating the parts-list this predicate can be used to create a URL.

ClioPatria (version V3.1.1-42-gd6a756b-DIRTY)