• 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/pure_input.pl
All Application Manual Name SummaryHelp

  • swipl
    • library
      • error.pl
      • debug.pl
      • apply.pl -- Apply predicates on a list
      • lists.pl -- List Manipulation
      • broadcast.pl -- Event service
      • shlib.pl -- Utility library for loading foreign objects (DLLs, shared objects)
      • option.pl -- Option list processing
      • thread_pool.pl -- Resource bounded thread management
      • gensym.pl -- Generate unique symbols
      • settings.pl
      • arithmetic.pl -- Extensible arithmetic
      • main.pl -- Provide entry point for scripts
      • readutil.pl
      • operators.pl -- Manage operators
      • pairs.pl -- Operations on key-value lists
      • prolog_source.pl -- Examine Prolog source-files
      • quasi_quotations.pl
      • url.pl -- Analysing and constructing URL
      • www_browser.pl
      • 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
      • solution_sequences.pl -- Modify solution sequences
      • atom.pl -- Operations on atoms
      • prolog_pack.pl
      • 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
        • phrase_from_file/2
        • phrase_from_file/3
        • phrase_from_stream/2
        • phrase_from_stream/3
        • syntax_error//1
        • lazy_list_location//1
        • lazy_list_character_count//1
        • stream_to_lazy_codes/2
        • stream_to_lazy_chars/2
        • stream_to_lazy_list/2
      • nb_set.pl -- Non-backtrackable sets
      • aggregate.pl -- Aggregation operators on backtrackable predicates
      • csv.pl -- Process CSV (Comma-Separated Values) data
      • iostream.pl -- Utilities to deal with streams
      • 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
      • predicate_options.pl -- Access and analyse predicate options
      • rbtrees.pl
      • nb_rbtrees.pl -- Non-backtrackable operations on red black trees
      • sandbox.pl
      • prolog_format.pl -- Analyse format specifications
      • random.pl -- Random numbers
      • 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
      • prolog_breakpoints.pl -- Manage Prolog break-points
      • dicts.pl -- Dict utilities
      • help.pl -- Text based manual
      • tables.pl -- XSB interface to tables
      • tableutil.pl -- Table inspection and statistics utilities
      • listing.pl -- List programs and pretty print clauses
      • prolog_profile.pl -- Execution profiler
      • date.pl -- Process dates and times
      • backcomp.pl -- Backward compatibility
      • edit.pl
      • make.pl -- Reload modified source files
      • threadutil.pl -- Interactive thread utilities
      • shell.pl -- Elementary shell commands
      • optparse.pl -- command line parsing
      • prolog_codewalk.pl
      • check.pl
      • heaps.pl -- heaps/priority queues
      • terms.pl
      • quintus.pl
      • strings.pl -- String utilities
      • prolog_stack.pl -- Examine the Prolog stack
      • wfs.pl
      • statistics.pl -- Get information about resource usage
      • charsio.pl -- I/O on Lists of Character Codes
      • oset.pl -- Ordered set manipulation
      • increval.pl
      • coinduction.pl -- Co-Logic Programming
      • varnumbers.pl -- Utilities for numbered terms
      • ansi_term.pl -- Print decorated text to ANSI consoles
      • explain.pl
      • prolog_coverage.pl -- Coverage analysis tool
      • sort.pl
      • fastrw.pl
      • portray_text.pl
      • intercept.pl -- Intercept and signal interface
      • prolog_versions.pl -- Demand specific (Prolog) versions
      • codesio.pl -- I/O on Lists of Character Codes
      • prolog_wrap.pl
      • prolog_debug.pl -- User level debugging tools
      • prolog_metainference.pl -- Infer meta-predicate properties
      • base32.pl -- Base32 encoding and decoding
      • when.pl -- Conditional coroutining
      • prolog_autoload.pl -- Autoload all dependencies
      • system.pl -- System utilities
      • prolog_config.pl
      • prolog_trace.pl
      • rwlocks.pl
      • zip.pl -- Access resource ZIP archives
      • streams.pl -- Manage Prolog streams
      • tty.pl -- Terminal operations
      • prolog_history.pl -- Per-directory persistent commandline history
      • writef.pl -- Old-style formatted write
      • prolog_jiti.pl -- Just In Time Indexing (JITI) utilities
      • prolog_qlfmake.pl -- Compile the library to QLF format
      • hashtable.pl -- Hash tables
      • exceptions.pl -- Exception classification
      • files.pl
      • macros.pl
      • qsave.pl
 phrase_from_file(:Grammar, +File) is nondet
 phrase_from_file(:Grammar, +File, +Options) is nondet
Process the content of File using the DCG rule Grammar. The space usage of this mechanism depends on the length of the not committed part of Grammar. Committed parts of the temporary list are reclaimed by the garbage collector, while the list is extended on demand due to unification of the attributed tail variable.

Options are passed to open/4 and phrase_from_stream/3. The latter notable allows for as(chars) to call a DCG compiled for dealing with character lists rather than codes.

Below is an example that counts the number of times a string appears in a file. The library dcg/basics provides string//1 matching an arbitrary string and remainder//1 which matches the remainder of the input without parsing.

:- use_module(library(dcg/basics)).

file_contains(File, Pattern) :-
        phrase_from_file(match(Pattern), File).

match(Pattern) -->
        string(_),
        string(Pattern),
        remainder(_).

match_count(File, Pattern, Count) :-
        aggregate_all(count, file_contains(File, Pattern), Count).

This can be called as (note that the pattern must be a string (code list)):

?- match_count('pure_input.pl', `file`, Count).
ClioPatria (version V3.1.1-59-g7b9a7a3)