Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / devtools / amd64 / html / python / lib / weakref-example.html
CommitLineData
920dae64
AT
1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<html>
3<head>
4<link rel="STYLESHEET" href="lib.css" type='text/css' />
5<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
6<link rel='start' href='../index.html' title='Python Documentation Index' />
7<link rel="first" href="lib.html" title='Python Library Reference' />
8<link rel='contents' href='contents.html' title="Contents" />
9<link rel='index' href='genindex.html' title='Index' />
10<link rel='last' href='about.html' title='About this document...' />
11<link rel='help' href='about.html' title='About this document...' />
12<link rel="next" href="weakref-extension.html" />
13<link rel="prev" href="weakref-objects.html" />
14<link rel="parent" href="module-weakref.html" />
15<link rel="next" href="weakref-extension.html" />
16<meta name='aesop' content='information' />
17<title>3.3.2 Example </title>
18</head>
19<body>
20<DIV CLASS="navigation">
21<div id='top-navigation-panel' xml:id='top-navigation-panel'>
22<table align="center" width="100%" cellpadding="0" cellspacing="2">
23<tr>
24<td class='online-navigation'><a rel="prev" title="3.3.1 Weak Reference Objects"
25 href="weakref-objects.html"><img src='../icons/previous.png'
26 border='0' height='32' alt='Previous Page' width='32' /></A></td>
27<td class='online-navigation'><a rel="parent" title="3.3 weakref "
28 href="module-weakref.html"><img src='../icons/up.png'
29 border='0' height='32' alt='Up One Level' width='32' /></A></td>
30<td class='online-navigation'><a rel="next" title="3.3.3 Weak References in"
31 href="weakref-extension.html"><img src='../icons/next.png'
32 border='0' height='32' alt='Next Page' width='32' /></A></td>
33<td align="center" width="100%">Python Library Reference</td>
34<td class='online-navigation'><a rel="contents" title="Table of Contents"
35 href="contents.html"><img src='../icons/contents.png'
36 border='0' height='32' alt='Contents' width='32' /></A></td>
37<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
38 border='0' height='32' alt='Module Index' width='32' /></a></td>
39<td class='online-navigation'><a rel="index" title="Index"
40 href="genindex.html"><img src='../icons/index.png'
41 border='0' height='32' alt='Index' width='32' /></A></td>
42</tr></table>
43<div class='online-navigation'>
44<b class="navlabel">Previous:</b>
45<a class="sectref" rel="prev" href="weakref-objects.html">3.3.1 Weak Reference Objects</A>
46<b class="navlabel">Up:</b>
47<a class="sectref" rel="parent" href="module-weakref.html">3.3 weakref </A>
48<b class="navlabel">Next:</b>
49<a class="sectref" rel="next" href="weakref-extension.html">3.3.3 Weak References in</A>
50</div>
51<hr /></div>
52</DIV>
53<!--End of Navigation Panel-->
54
55<H2><A NAME="SECTION005320000000000000000"></A><A NAME="weakref-example"></A>
56<BR>
573.3.2 Example
58</H2>
59
60<P>
61This simple example shows how an application can use objects IDs to
62retrieve objects that it has seen before. The IDs of the objects can
63then be used in other data structures without forcing the objects to
64remain alive, but the objects can still be retrieved by ID if they
65do.
66
67<P>
68<div class="verbatim"><pre>
69import weakref
70
71_id2obj_dict = weakref.WeakValueDictionary()
72
73def remember(obj):
74 oid = id(obj)
75 _id2obj_dict[oid] = obj
76 return oid
77
78def id2obj(oid):
79 return _id2obj_dict[oid]
80</pre></div>
81
82<P>
83
84<DIV CLASS="navigation">
85<div class='online-navigation'>
86<p></p><hr />
87<table align="center" width="100%" cellpadding="0" cellspacing="2">
88<tr>
89<td class='online-navigation'><a rel="prev" title="3.3.1 Weak Reference Objects"
90 href="weakref-objects.html"><img src='../icons/previous.png'
91 border='0' height='32' alt='Previous Page' width='32' /></A></td>
92<td class='online-navigation'><a rel="parent" title="3.3 weakref "
93 href="module-weakref.html"><img src='../icons/up.png'
94 border='0' height='32' alt='Up One Level' width='32' /></A></td>
95<td class='online-navigation'><a rel="next" title="3.3.3 Weak References in"
96 href="weakref-extension.html"><img src='../icons/next.png'
97 border='0' height='32' alt='Next Page' width='32' /></A></td>
98<td align="center" width="100%">Python Library Reference</td>
99<td class='online-navigation'><a rel="contents" title="Table of Contents"
100 href="contents.html"><img src='../icons/contents.png'
101 border='0' height='32' alt='Contents' width='32' /></A></td>
102<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
103 border='0' height='32' alt='Module Index' width='32' /></a></td>
104<td class='online-navigation'><a rel="index" title="Index"
105 href="genindex.html"><img src='../icons/index.png'
106 border='0' height='32' alt='Index' width='32' /></A></td>
107</tr></table>
108<div class='online-navigation'>
109<b class="navlabel">Previous:</b>
110<a class="sectref" rel="prev" href="weakref-objects.html">3.3.1 Weak Reference Objects</A>
111<b class="navlabel">Up:</b>
112<a class="sectref" rel="parent" href="module-weakref.html">3.3 weakref </A>
113<b class="navlabel">Next:</b>
114<a class="sectref" rel="next" href="weakref-extension.html">3.3.3 Weak References in</A>
115</div>
116</div>
117<hr />
118<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
119</DIV>
120<!--End of Navigation Panel-->
121<ADDRESS>
122See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
123</ADDRESS>
124</BODY>
125</HTML>