67 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
		
		
			
		
	
	
			67 lines
		
	
	
		
			2.8 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
|   | <?xml version="1.0" encoding="utf-8"?> | ||
|  | <!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="application/xml+xhtml; charset=utf-8" /> | ||
|  | 	<title>Logtalk built-in method: expand_term/2</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: expand_term/2</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> > <a href="../index.html">reference manual</a> > <a href="../index.html#methods">built-in methods</a></div> | ||
|  | 
 | ||
|  | <h2 class="code">expand_term/2</h2> | ||
|  | 
 | ||
|  | 
 | ||
|  | <h4>Description</h4> | ||
|  | 
 | ||
|  | <pre>expand_term(Term, Expansion)</pre> | ||
|  | <p> | ||
|  | Expands a term. The most common use is to expand a grammar rule into a clause. Users may override the default Logtalk grammar rule translator by defining clauses for the predicate <a href="term_expansion2.html"><code>term_expansion/2</code></a>. | ||
|  | <p> | ||
|  | </p> | ||
|  | The expansion works as follows: if the first argument is a variable, then it is unified with the second argument; if the first argument is not a variable and clauses for the <code>term_expansion/2</code> predicate are within scope, then this predicate is called to provide an expansion that is then unified with the second argument; if the <code>term_expansion/2</code> predicate is not used and the first argument is a compound term with functor <code>-->/2</code> then the default Logtalk grammar rule translator is used, with the resulting clause being unified with the second argument; when the translator is not used, the two arguments are unified. | ||
|  | </p> | ||
|  | <p> | ||
|  | This built-in method may be used to expand a grammar rule into a clause for use with the built-in database methods. | ||
|  | </p> | ||
|  | 
 | ||
|  | <h4>Template and modes</h4> | ||
|  | 
 | ||
|  | <pre>expand_term(?term, ?term)</pre> | ||
|  | 
 | ||
|  | <h4>Errors</h4> | ||
|  | 
 | ||
|  | <dl class="errors"> | ||
|  | 	<dt>(none)</dt> | ||
|  | </dl> | ||
|  | 
 | ||
|  | <h4>Examples</h4> | ||
|  | 
 | ||
|  | <blockquote> | ||
|  | <dl> | ||
|  | 	<dt>(none)</dt> | ||
|  | </dl> | ||
|  | </blockquote> | ||
|  | 
 | ||
|  | <div class="footer"> | ||
|  | 	<div class="navbottom"><a href="../index.html#methods">previous</a> | <a href="../../glossary.html">glossary</a> | <a href="term_expansion2.html">next</a></div> | ||
|  | 	<div class="copyright">Copyright © <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> — <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: January 29, 2006</span> | ||
|  | 	</div> | ||
|  | </div> | ||
|  | 
 | ||
|  | </body> | ||
|  | </html> |