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

  • swipl
    • library
      • error.pl
      • debug.pl
      • apply.pl
      • lists.pl
      • broadcast.pl
      • shlib.pl
      • option.pl -- Option list processing
      • thread_pool.pl -- Resource bounded thread management
      • gensym.pl
      • settings.pl -- Setting management
      • arithmetic.pl -- Extensible arithmetic
      • main.pl
      • readutil.pl -- Read utilities
      • operators.pl
      • pairs.pl -- Operations on key-value lists
      • prolog_source.pl
      • record.pl
      • quasi_quotations.pl
      • pure_input.pl -- Pure Input from files and streams
        • phrase_from_file/2
        • phrase_from_file/3
        • phrase_from_stream/2
        • syntax_error//1
        • lazy_list_location//1
        • lazy_list_character_count//1
        • stream_to_lazy_list/2
      • solution_sequences.pl
      • ordsets.pl
      • random.pl
      • base64.pl
      • aggregate.pl -- Aggregation operators on backtrackable predicates
      • yall.pl
      • sandbox.pl
      • apply_macros.pl -- Goal expansion rules to avoid meta-calling
      • assoc.pl
      • prolog_format.pl
      • predicate_options.pl
      • csv.pl -- Process CSV (Comma-Separated Values) data
      • pprint.pl -- Pretty Print Prolog terms
      • atom.pl
      • modules.pl
      • occurs.pl
      • prolog_xref.pl
      • prolog_colour.pl -- Prolog syntax colouring support.
      • lazy_lists.pl
      • ugraphs.pl
      • url.pl
      • www_browser.pl -- Open a URL in the users browser
      • prolog_pack.pl
      • git.pl
      • utf8.pl
      • dialect.pl -- Support multiple Prolog dialects
      • system.pl
      • terms.pl
      • date.pl -- Process dates and times
      • persistency.pl
      • iostream.pl -- Utilities to deal with streams
      • prolog_stack.pl
      • edinburgh.pl
      • prolog_clause.pl
      • prolog_breakpoints.pl -- Manage Prolog break-points
      • wfs.pl
      • prolog_code.pl
      • sort.pl
      • dicts.pl -- Dict utilities
      • dif.pl -- The dif/2 constraint
      • varnumbers.pl
      • pio.pl -- Pure I/O
      • tables.pl
      • base32.pl
      • charsio.pl
      • codesio.pl
      • coinduction.pl -- Co-Logic Programming
      • heaps.pl -- heaps/priority queues
      • rbtrees.pl -- Red black trees
      • statistics.pl
      • when.pl -- Conditional coroutining
      • backcomp.pl
      • quintus.pl -- Quintus compatibility
      • prolog_coverage.pl
      • ansi_term.pl -- Print decorated text to ANSI consoles
      • tty.pl
      • prolog_config.pl
      • exceptions.pl
      • make.pl
      • check.pl -- Consistency checking
      • optparse.pl
      • shell.pl -- Elementary shell commands
      • prolog_history.pl
      • fastrw.pl
      • edit.pl
      • nb_set.pl -- Non-backtrackable sets
      • thread.pl -- High level thread primitives
      • portray_text.pl
      • zip.pl
      • qsave.pl
      • prolog_autoload.pl
      • ctypes.pl -- Character code classification
      • increval.pl
      • listing.pl
      • files.pl
      • prolog_trace.pl
      • help.pl
      • intercept.pl
      • prolog_versions.pl -- Demand specific (Prolog) versions
      • prolog_jiti.pl
      • prolog_profile.pl
      • prolog_wrap.pl
      • strings.pl
      • macros.pl
      • prolog_codewalk.pl
      • prolog_metainference.pl
      • readln.pl
      • rwlocks.pl
      • streams.pl
      • threadutil.pl -- Interactive thread utilities
      • prolog_debug.pl
      • writef.pl
 phrase_from_file(:Grammar, +File) 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. 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).