1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
<html><head>
<title>nx::next - </title>
<link rel="stylesheet" href="man.css" type="text/css">
</head>
<! -- Generated from file 'next.man' by tcllib/doctools with format 'html'
-->
<! -- Copyright © 2014 Stefan Sobernig <stefan.sobernig@wu.ac.at>, Gustaf Neumann <gustaf.neumann@wu.ac.at>
-->
<! -- CVS: $Id$ nx::next.3
-->
<body><div class="doctools">
<h1 class="title">nx::next(3) 2.0 next ""</h1>
<div id="name" class="section"><h2><a name="name">Name</a></h2>
<p>nx::next - Skip to the next most specific method implementation</p>
</div>
<div id="toc" class="section"><h2><a name="toc">Table Of Contents</a></h2>
<ul class="toc">
<li class="section"><a href="#toc">Table Of Contents</a></li>
<li class="section"><a href="#synopsis">Synopsis</a></li>
<li class="section"><a href="#section1">Description</a></li>
<li class="section"><a href="#copyright">Copyright</a></li>
</ul>
</div>
<div id="synopsis" class="section"><h2><a name="synopsis">Synopsis</a></h2>
<div class="synopsis">
<ul class="syntax">
<li><a href="#1"><b class="cmd">next</b> <span class="opt">?<i class="arg">arguments</i>?</span></a></li>
</ul>
</div>
</div>
<div id="section1" class="section"><h2><a name="section1">Description</a></h2>
<dl class="definitions">
<dt><a name="1"><b class="cmd">next</b> <span class="opt">?<i class="arg">arguments</i>?</span></a></dt>
<dd><p>This command is invoked inside a method body to call the next most
specific method implementation in the list of available methods. This
list of available methods is specific to the current method-call
context. This context is set by the usage context of <b class="cmd">nx::next</b>
(method combination vs. method-call interception; see below). The optional
<i class="arg">arguments</i> are the argument values to be passed into the next
most specific method implementation. If omitted, the arguments of the
current method call are automatically forwarded. To call the next most
specific method implementation without arguments (or to suppress
argument forwarding), <i class="arg">arguments</i> must be set to an empty
string. To pass an empty string as a (single) argument value, protect
it as a list. The result of a call to <b class="cmd">nx::next</b> is the result of
the next most specific method implementation.
If there are no more further applicable methods, the result of <b class="cmd">nx::next</b> will
depend on its usage context: method combination or
method-call interception. If <b class="cmd">nx::next</b> is used in a method body for
method combination, the result will be an empty string. If <b class="cmd">nx::next</b> is
used in the body of a filter method for method-call interception, the
result will be an error.</p>
<p>When executing a method call, the NX dispatch mechanism computes a
list of applicable method implementations for the method name
requested from a given object receiving the call; in support of method
combination and method-call interception.</p>
<p>For <em>method combination</em>, the computed list contains any object-local
method implementation and any method implementations inherited by the
object from the classes in its precedence list. Examples are
overloading method implementations in the class hierarchy of the
object, as well as from mixin classes of the object. For <em>method-call interception</em>,
the computed list contains the applicable filter methods, again
ordered by their definition order according to the precedence list of the called
object.</p>
<p>To retrieve the next most specific method implementation to be invoked
by <b class="cmd">nx::current</b> from the internally computed list, if any, use
<b class="cmd">nx::current</b>.</p></dd>
</dl>
</div>
<div id="copyright" class="section"><h2><a name="copyright">Copyright</a></h2>
<p>Copyright © 2014 Stefan Sobernig <stefan.sobernig@wu.ac.at>, Gustaf Neumann <gustaf.neumann@wu.ac.at></p>
</div>
</div></body></html>
|
