• 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

/usr/lib/swipl/library/url.pl
All Application Manual Name SummaryHelp

  • swipl
    • library
      • error.pl
      • debug.pl -- Print debug messages and test assertions
      • apply.pl -- Apply predicates on a list
      • lists.pl -- List Manipulation
      • broadcast.pl -- Event service
      • predicate_options.pl -- Access and analyse predicate options
      • shlib.pl -- Utility library for loading foreign objects (DLLs, shared objects)
      • option.pl
      • thread_pool.pl
      • gensym.pl
      • settings.pl
      • arithmetic.pl
      • main.pl -- Provide entry point for scripts
      • readutil.pl -- Read utilities
      • operators.pl -- Manage operators
      • pairs.pl -- Operations on key-value lists
      • prolog_source.pl -- Examine Prolog source-files
      • quasi_quotations.pl -- Define Quasi Quotation syntax
      • 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
      • 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
      • iostream.pl -- Utilities to deal with streams
      • atom.pl -- Operations on atoms
      • prolog_pack.pl -- A package manager for Prolog
      • solution_sequences.pl -- Modify solution sequences
      • git.pl -- Run GIT commands
      • ctypes.pl -- Character code classification
      • utf8.pl -- UTF-8 encoding/decoding on lists of character codes.
      • base64.pl -- Base64 encoding and decoding
      • persistency.pl -- Provide persistent dynamic predicates
      • pure_input.pl -- Pure Input from files and streams
      • nb_set.pl -- Non-backtrackable sets
      • aggregate.pl -- Aggregation operators on backtrackable predicates
      • csv.pl -- Process CSV (Comma-Separated Values) data
      • dialect.pl -- Support multiple Prolog dialects
      • apply_macros.pl -- Goal expansion rules to avoid meta-calling
      • yall.pl -- Lambda expressions
      • prolog_code.pl -- Utilities for reasoning about code
      • dif.pl -- The dif/2 constraint
      • thread.pl -- High level thread primitives
      • rbtrees.pl -- Red black trees
      • nb_rbtrees.pl -- Non-backtrackable operations on red black trees
      • random.pl -- Random numbers
      • sandbox.pl -- Sandboxed Prolog code
      • prolog_format.pl -- Analyse format specifications
      • 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
      • check.pl -- Consistency checking
      • ansi_term.pl -- Print decorated text to ANSI consoles
      • backcomp.pl -- Backward compatibility
      • writef.pl -- Old-style formatted write
      • charsio.pl -- I/O on Lists of Character Codes
      • sort.pl
      • base32.pl -- Base32 encoding and decoding
      • tables.pl -- XSB interface to tables
      • statistics.pl -- Get information about resource usage
      • varnumbers.pl -- Utilities for numbered terms
      • prolog_jiti.pl -- Just In Time Indexing (JITI) utilities
      • intercept.pl -- Intercept and signal interface
      • terms.pl -- Term manipulation
      • quintus.pl -- Quintus compatibility
      • codesio.pl -- I/O on Lists of Character Codes
      • prolog_debug.pl -- User level debugging tools
      • listing.pl -- List programs and pretty print clauses
      • make.pl -- Reload modified source files
      • increval.pl -- Incremental dynamic predicate modification
      • strings.pl -- String utilities
      • date.pl -- Process dates and times
      • help.pl -- Text based manual
      • prolog_wrap.pl -- Wrapping predicates
      • rwlocks.pl -- Read/write locks
      • shell.pl -- Elementary shell commands
      • explain.pl -- Describe Prolog Terms
      • threadutil.pl -- Interactive thread utilities
      • prolog_versions.pl -- Demand specific (Prolog) versions
      • wfs.pl -- Well Founded Semantics interface
      • optparse.pl -- command line parsing
      • prolog_profile.pl -- Execution profiler
      • qsave.pl -- Save current program as a state or executable
      • zip.pl -- Access resource ZIP archives
      • heaps.pl -- heaps/priority queues
      • prolog_history.pl -- Per-directory persistent commandline history
      • when.pl -- Conditional coroutining
      • prolog_trace.pl -- Print access to predicates
      • edit.pl -- Editor interface
      • prolog_stack.pl -- Examine the Prolog stack
      • prolog_codewalk.pl -- Prolog code walker
      • prolog_metainference.pl -- Infer meta-predicate properties
      • prolog_coverage.pl -- Coverage analysis tool
      • macros.pl -- Macro expansion
      • exceptions.pl -- Exception classification
      • oset.pl -- Ordered set manipulation
      • hashtable.pl -- Hash tables
      • coinduction.pl -- Co-Logic Programming
      • system.pl -- System utilities
      • prolog_autoload.pl -- Autoload all dependencies
      • prolog_config.pl -- Provide configuration information
      • portray_text.pl -- Portray text
      • win_menu.pl -- Console window menu
      • tty.pl -- Terminal operations
      • fastrw.pl -- Fast reading and writing of terms
      • files.pl
      • streams.pl -- Manage Prolog streams
 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-51-ga0b30a5)