File: ref_c_class.html

package info (click to toggle)
rubybook 0.2.1-1
  • links: PTS
  • area: non-free
  • in suites: etch, etch-m68k, lenny, squeeze, wheezy
  • size: 4,248 kB
  • ctags: 1,042
  • sloc: xml: 60,486; makefile: 25
file content (155 lines) | stat: -rw-r--r-- 7,646 bytes parent folder | download | duplicates (3)
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
<html><title>Programming Ruby: The Pragmatic Programmer's Guide</title><head><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><STYLE TYPE="text/css"><!--
       BODY    { margin-left: 1in;
                 width: 6in;
                 font-family: helvetica, arial, sans-serif;
               }
       H1      { color: #000080;
                 font-family: helvetica, arial, sans-serif;
                 font-size: 22pt;
                 margin-left: 0in
               }
       H2      { color: #000080;  font: bold x-large helvetica, sans-serif;
                 margin-left: 0in }
       H3      { color: #000080;  font: bold   large helvetica, sans-serif; }
       H4      { color: #000080;  font: italic large helvetica, sans-serif; }
       .ruby   { background: #fff0f0 }
       .header { color: white }
       .subheader { color: #ffdddd }
       .sidebar   { width: 6in }
       span.sans { font-family: helvetica, arial, sans-serif }
       -->
   </STYLE><table bgcolor="#a03030" cellpadding="3" border="0" cellspacing="0"><tr><td colspan="3"><table bgcolor="#902020" cellpadding="20"><tr><td><h1 class="header">Programming Ruby</h1><h3 class="subheader">The Pragmatic Programmer's Guide</h3></td></tr></table></td></tr><tr><td width="33%" align="left"><a class="subheader" href="ref_c_binding.html">Previous &lt;</a></td><td width="33%" align="center" valign="middle"><a class="subheader" href="builtins.html">Contents ^</a><br></td><td width="33%" align="right"><a class="subheader" href="ref_c_continuation.html">Next ></a><br></td></tr></table></head><body bgcolor="white">
<!--
    Copyright (c) 2001 by Addison Wesley Longman.  This
    material may be distributed only subject to the terms and
    conditions set forth in the Open Publication License, v1.0 or
    later (the latest version is presently available at
    http://www.opencontent.org/openpub/).
-->
<table><tr><td height="20"><img src="dot.gif" width="1" height="20"></td></tr></table><table border="0" width="100%" bgcolor="660066" cellpadding="10"><tr><td valign="center"><font color="white" size="7">class Class</font></td><td><table border="0"><tr><td><font color="white">
                Parent:
              </font></td><td><font color="white">Module</font></td></tr><tr><td><font color="white">
                Version:
              </font></td><td><font color="white">
               1.6
              </font></td></tr></table></td></tr></table><p></p><H3>Index:</H3><a href="#inherited">inherited</a> <a href="#new">new</a> <a href="#new"><i>new</i></a> <a href="#superclass"><i>superclass</i></a> <p></p><hr>
<P></P>
  Classes in Ruby are first-class objects---each is an instance of
  class <code>Class</code>.
<P></P>
  When a new class is created (typically using
  <code>class&nbsp;Name&nbsp;...&nbsp;end</code>), an object of type <code>Class</code> is created
  and assigned to a global constant (<code>Name</code> in this case). When
  <code>Name.new</code> is called to create a new object, the <code>new</code>
  method in <code>Class</code> is run by default. This can be demonstrated by
  overriding <code>new</code> in <code>Class</code>:
<P></P>

<table bgcolor="#fff0f0" cellspacing="0" border="0" cellpadding="3" width="400"><tr><td><pre>
class&nbsp;Class
&nbsp;&nbsp;&nbsp;alias&nbsp;oldNew&nbsp;&nbsp;new
&nbsp;&nbsp;&nbsp;def&nbsp;new(*args)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"Creating&nbsp;a&nbsp;new&nbsp;",&nbsp;self.name,&nbsp;"\n"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;oldNew(*args)
&nbsp;&nbsp;&nbsp;end
&nbsp;end
<P></P>
&nbsp;class&nbsp;Name
&nbsp;end
<P></P>
&nbsp;n&nbsp;=&nbsp;Name.new
</pre></td></tr></table>

<em>produces:</em>
<table bgcolor="#fff0f0" cellspacing="0" border="0" cellpadding="3" width="400"><tr><td><pre>
Creating&nbsp;a&nbsp;new&nbsp;Name
</pre></td></tr></table>

<P></P>
  <table border="0" width="100%" cellpadding="10"><tr><td valign="center" colspan="2" bgcolor="990066"><font color="white" size="6">class methods
       </font></td></tr><tr><td valign="center" bgcolor="#ff9999"><font size="4"><a name="inherited"><b>inherited</b></a></font></td><td bgcolor="#ffaaaa">
        <i>aClass</i>.inherited( <i>aSubClass</i> )
      </td></tr><td></td><td>
<P></P>
      This is a singleton method (per class) invoked by Ruby when a subclass
      of <i>aClass</i> is created. The new subclass is passed as a
      parameter.
<P></P>

<table bgcolor="#fff0f0" cellspacing="0" border="0" cellpadding="3" width="400"><tr><td><pre>
class&nbsp;Top
&nbsp;&nbsp;def&nbsp;Top.inherited(sub)
&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;"New&nbsp;subclass:&nbsp;",&nbsp;sub,&nbsp;"\n"
&nbsp;&nbsp;end
end
<P></P>
class&nbsp;Middle&nbsp;&lt;&nbsp;Top
end
<P></P>
class&nbsp;Bottom&nbsp;&lt;&nbsp;Middle
end
</pre></td></tr></table>

<em>produces:</em>
<table bgcolor="#fff0f0" cellspacing="0" border="0" cellpadding="3" width="400"><tr><td><pre>
New&nbsp;subclass:&nbsp;Middle
New&nbsp;subclass:&nbsp;Bottom
</pre></td></tr></table>

<P></P>
      </td><tr><td valign="center" bgcolor="#ff9999"><font size="4"><a name="new"><b>new</b></a></font></td><td bgcolor="#ffaaaa">
        Class.new( <i>aSuperClass</i>=<code>Object</code> )
        -> <i>aClass</i>
      </td></tr><td></td><td>
<P></P>
      Creates a new anonymous (unnamed)            
      class with the given superclass (or
      <code>Object</code> if no parameter is given).
<P></P>
      </td></table>
<P></P>
  <table border="0" width="100%" cellpadding="10"><tr><td valign="center" colspan="2" bgcolor="990066"><font color="white" size="6">instance methods
       </font></td></tr><tr><td valign="center" bgcolor="#ff9999"><font size="4"><a name="new"><b>new</b></a></font></td><td bgcolor="#ffaaaa">
        <i>aClass</i>.new( <i>[</i><i>args</i><i>]<sup>*</sup></i> )
        -> <i>anObject</i>
      </td></tr><td></td><td>
<P></P>
      Creates a new object of <i>aClass</i>'s class, then invokes that object's
      <code>initialize</code> method, passing it <i>args</i>.
<P></P>
      </td><tr><td valign="center" bgcolor="#ff9999"><font size="4"><a name="superclass"><b>superclass</b></a></font></td><td bgcolor="#ffaaaa">
        <i>aClass</i>.superclass
        -> <i>aSuperClass</i> or <code>nil</code>
      </td></tr><td></td><td>
<P></P>
      Returns the superclass of <i>aClass</i>, or <code>nil</code>.
<P></P>

<table bgcolor="#fff0f0" cellspacing="0" border="0" cellpadding="3" width="500">
<tr>
  <td valign="top"><code>Class.superclass</code></td>
  <td valign="top"></td>
  <td valign="top"><code>Module</code></td>
</tr>
<tr>
  <td valign="top"><code>Object.superclass</code></td>
  <td valign="top"></td>
  <td valign="top"><code>nil</code></td>
</tr>
</table>
<P></P>

<P></P>
      </td></table>
<P></P>

<p></p><hr><table bgcolor="#a03030" cellpadding="10" border="0" cellspacing="0"><tr><td width="33%" align="left"><a class="subheader" href="ref_c_binding.html">Previous &lt;</a></td><td width="33%" align="center" valign="middle"><a class="subheader" href="builtins.html">Contents ^</a><br></td><td width="33%" align="right"><a class="subheader" href="ref_c_continuation.html">Next ></a><br></td></tr></table><p></p><font size="-1">Extracted from the book "Programming Ruby -
     The Pragmatic Programmer's Guide"</font><br><font size="-3">
      Copyright
      &#169;
      2000 Addison Wesley Longman, Inc. Released under the terms of the
      <a href="http://www.opencontent.org/openpub/">Open Publication License</a> V1.0.
        <br>
      This reference is available for
        <a href="http://www.pragmaticprogrammer.com/ruby/downloads/book.html">download</a>.
   </font></body></html>