| 
									
										
										
										
											2006-02-10 17:44:05 +00:00
										 |  |  | <?xml version="1.0" encoding="utf-8"?> | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" | 
					
						
							|  |  |  |     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | <head> | 
					
						
							| 
									
										
										
										
											2006-02-10 17:44:05 +00:00
										 |  |  | 	<meta http-equiv="content-type" content="application/xml+xhtml; charset=utf-8" /> | 
					
						
							| 
									
										
										
										
											2003-12-30 13:33:51 +00:00
										 |  |  | 	<title>Logtalk built-in predicate: create_protocol/3</title> | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | 	<link rel="stylesheet" href="../../screen.css" type="text/css" media="screen"/> | 
					
						
							|  |  |  | 	<link rel="stylesheet" href="../../print.css" type="text/css" media="print"/> | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | </head> | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | <body> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | <div class="top-left">Logtalk reference manual</div>  | 
					
						
							|  |  |  | <div class="top-right">Built-in predicate: create_protocol/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> > <a href="../index.html">reference manual</a> > <a href="../index.html#builtins">built-in predicates</a></div> | 
					
						
							| 
									
										
										
										
											2003-12-30 13:33:51 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-11-07 17:11:47 +00:00
										 |  |  | <h2 class="codenp">create_protocol/3<span id="builtins_create_protocol3"/></h2> | 
					
						
							| 
									
										
										
										
											2003-12-30 13:33:51 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | <h4>Description</h4> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2003-12-30 13:33:51 +00:00
										 |  |  | <pre>create_protocol(Identifier, Relations, Directives)</pre> | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | <p> | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | Creates a new, dynamic, protocol. | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | </p> | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | <h4>Template and modes</h4> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2003-12-30 13:33:51 +00:00
										 |  |  | <pre>create_protocol(+protocol_identifier, +list, +list)</pre> | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2001-12-05 23:57:48 +00:00
										 |  |  | <h4>Errors</h4> | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-11-07 17:11:47 +00:00
										 |  |  | <dl> | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | 	<dt>One of the predicate arguments is a variable:</dt> | 
					
						
							|  |  |  | 		<dd><code>instantiation_error</code></dd> | 
					
						
							|  |  |  | 	<dt>Identifier is not a valid protocol identifier:</dt> | 
					
						
							|  |  |  | 		<dd><code>type_error(protocol_identifier, Identifier)</code></dd> | 
					
						
							|  |  |  | 	<dt>Identifier is already in use:</dt> | 
					
						
							|  |  |  | 		<dd><code>permission_error(replace, category, Identifier)</code></dd> | 
					
						
							|  |  |  | 		<dd><code>permission_error(replace, object, Identifier)</code></dd> | 
					
						
							|  |  |  | 		<dd><code>permission_error(replace, protocol, Identifier)</code></dd> | 
					
						
							| 
									
										
										
										
											2006-02-10 17:44:05 +00:00
										 |  |  | 	<dt>Relations is neither a variable nor a proper list:</dt> | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | 		<dd><code>type_error(list, Relations)</code></dd> | 
					
						
							| 
									
										
										
										
											2006-02-10 17:44:05 +00:00
										 |  |  | 	<dt>Directives is neither a variable nor a proper list:</dt> | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | 		<dd><code>type_error(list, Directives)</code></dd> | 
					
						
							|  |  |  | </dl> | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | <h4>Examples</h4> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2003-12-30 13:33:51 +00:00
										 |  |  | <pre>| ?- create_protocol(foo, [extends(bar)], [public(foo/1)]).</pre> | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2003-12-30 13:33:51 +00:00
										 |  |  | <div class="footer"> | 
					
						
							| 
									
										
										
										
											2006-11-07 17:11:47 +00:00
										 |  |  | 	<div class="copyright"> | 
					
						
							|  |  |  | 		<span>Copyright © <a href="mailto:pmoura@logtalk.org">Paulo Moura</a> — <a href="http://logtalk.org">Logtalk.org</a></span><br/>	 | 
					
						
							|  |  |  | 		<span>Last updated on: October 26, 2006</span> | 
					
						
							|  |  |  | 	</div> | 
					
						
							|  |  |  | 	<div class="navbottom"> | 
					
						
							|  |  |  | 		<span><a href="create_object4.html">previous</a> | <a href="../../glossary.html">glossary</a> | <a href="../index.html#builtins">next</a></span><br/> | 
					
						
							|  |  |  | 		<span><a href="http://validator.w3.org/check/referer">XHTML</a> + <a href="http://jigsaw.w3.org/css-validator/check/referer">CSS</a></span> | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | 	</div> | 
					
						
							| 
									
										
										
										
											2003-12-30 13:33:51 +00:00
										 |  |  | </div> | 
					
						
							| 
									
										
										
										
											2005-12-24 18:00:21 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2003-12-30 13:33:51 +00:00
										 |  |  | </body> | 
					
						
							| 
									
										
										
										
											2006-11-07 17:11:47 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2001-06-06 20:07:01 +00:00
										 |  |  | </html> |