<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">

<head>
	<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
	<title>Logtalk built-in method: phrase/3</title>
	<link rel="stylesheet" href="../../screen.css" type="text/css" media="screen"/>
	<link rel="stylesheet" href="../../print.css" type="text/css" media="print"/>
</head>

<body>

<div class="top-left">Logtalk reference manual</div> 
<div class="top-right">Built-in method: phrase/3</div>
<div class="bottom-left"><span class="page"/></div> 
<div class="bottom-right"><span class="page"/></div>
<div class="navtop"><a href="../../index.html">contents</a> &gt; <a href="../index.html">reference manual</a> &gt; <a href="../index.html#methods">built-in methods</a></div>

<h2 class="code">phrase/3</h2>


<h4>Description</h4>

<pre>phrase(Ruleset, Input, Rest)</pre>
<p>
	True if the list <code>Input</code> can be parsed using the specified non-terminal <code>Ruleset</code>. The list <code>Rest</code> is what remains of the list <code>Input</code> after parsing succeeded.
</p>

<h4>Template and modes</h4>

<pre>phrase(+callable, ?list, ?list)</pre>

<h4>Errors</h4>

<dl class="errors">
	<dt>Ruleset is a variable:</dt>
		<dd><code>instantiation_error</code></dd>
	<dt>Ruleset is neither a variable nor a callable term:</dt>
		<dd><code>type_error(callable, Ruleset)</code></dd>
	<dt>Input is neither a variable nor a proper list:</dt>
		<dd><code>type_error(list, Input)</code></dd>
	<dt>Rest is neither a variable nor a proper list:</dt>
		<dd><code>type_error(list, Rest)</code></dd>
	<dt>The predicate Pred corresponding to Ruleset is private:</dt>
		<dd><code>permission_error(access, private_predicate, Pred)</code></dd>
	<dt>The predicate Pred corresponding to Ruleset is protected:</dt>
		<dd><code>permission_error(access, protected_predicate, Pred)</code></dd>
	<dt>The predicate Pred corresponding to Ruleset is not declared:</dt>
		<dd><code>existence_error(predicate_declaration, Pred)</code></dd>
</dl>

<h4>Examples</h4>

<pre>| ?- sentence::phrase(noun_phrase, [the, girl, likes, the, boy], Rest).

Rest = [likes, the, boy]
yes</pre>

<div class="footer">
	<div class="navbottom"><a href="phrase2.html">previous</a> | <a href="../../glossary.html">glossary</a> | <a href="../index.html#methods">next</a></div>
	<div class="copyright">Copyright &copy; <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> &mdash; <a href="http://www.logtalk.org">Logtalk.org</a></div>
	<div class="footnote">
		<span class="validators"><a href="http://validator.w3.org/check/referer">XHTML</a> + <a href="http://jigsaw.w3.org/css-validator/check/referer">CSS</a></span>
		<span class="date">Last updated on: November 16, 2005</span>
	</div>
</div>

</body>
</html>