<?xml version="1.0" encoding="iso-8859-1"?>
<?xml-stylesheet type="text/css" href="../../styles.css" ?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

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

<head>
	<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
	<title>Logtalk built-in predicate: create_category/4</title>
	<link rel="stylesheet" href="../../styles.css" type="text/css" />
</head>

<body>

<div class="navtop">
<a href="../../index.html">contents</a> &gt; <a href="../index.html">reference manual</a> &gt; <a href="../index.html#builtins">built-in predicates</a>
</div>

<h2><code>create_category/4</code></h2>


<h4>Description</h4>

<blockquote>
<pre>create_category(Identifier, Relations, Directives, Clauses)</pre>
<p>
	Creates a new, dynamic, category.
</p>
</blockquote>

<h4>Template and modes</h4>

<blockquote>
<pre>create_category(+category_identifier, +list, +list, +list)</pre>
</blockquote>

<h4>Errors</h4>

<blockquote>
	<dl>
		<dt>Identifier is a variable:</dt>
			<dd><code>instantiation_error</code></dd>
		<dt>Identifier is not a valid category identifier:</dt>
			<dd><code>type_error(category_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>
		<dt>Relations is not a list:</dt>
			<dd><code>type_error(list, Relations)</code></dd>
		<dt>Directives is not a list:</dt>
			<dd><code>type_error(list, Directives)</code></dd>
		<dt>Clauses is not a list:</dt>
			<dd><code>type_error(list, Clauses)</code></dd>
	</dl>
</blockquote>

<h4>Examples</h4>

<blockquote>
<pre>| ?- create_category(foo, [implements(bar)], [], [bar(1), bar(2)]).</pre>
</blockquote>

<div class="navbottom">
<a href="protocol_property2.html">previous</a> | <a href="../../glossary.html">glossary</a> | <a href="create_object4.html">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="footer">
<p><span class="bleft"><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="bright">Last updated on: December 23, 2003</span></p>
</div>
</body>
</html>