[OpenSPARC-T2-SAM] / sam-t2 / devtools / v9 / html / python / lib / embedding-locale.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="lib.css" type='text/css' />
<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
<link rel='start' href='../index.html' title='Python Documentation Index' />
<link rel="first" href="lib.html" title='Python Library Reference' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="locale-gettext.html" />
<link rel="prev" href="node323.html" />
<link rel="parent" href="module-locale.html" />
<link rel="next" href="locale-gettext.html" />
<meta name='aesop' content='information' />
<title>6.27.2 For extension writers and programs that embed Python </title>
</head>
<body>
<DIV CLASS="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="6.27.1 Background, details, hints,"
  href="node323.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="6.27 locale  "
  href="module-locale.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="6.27.3 Access to message"
  href="locale-gettext.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node323.html">6.27.1 Background, details, hints,</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="module-locale.html">6.27 locale  </A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="locale-gettext.html">6.27.3 Access to message</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->

<H2><A NAME="SECTION0082720000000000000000"></A><A NAME="embedding-locale"></A>
<BR>
6.27.2 For extension writers and programs that embed Python
            
</H2>

<P>
Extension modules should never call <tt class="function">setlocale()</tt>, except to
find out what the current locale is.  But since the return value can
only be used portably to restore it, that is not very useful (except
perhaps to find out whether or not the locale is "<tt class="samp">C</tt>").

<P>
When Python code uses the <tt class="module">locale</tt> module to change the locale,
this also affects the embedding application.  If the embedding
application doesn't want this to happen, it should remove the
<tt class="module">_locale</tt> extension module (which does all the work) from the
table of built-in modules in the <span class="file">config.c</span> file, and make sure
that the <tt class="module">_locale</tt> module is not accessible as a shared library.

<P>

<DIV CLASS="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="6.27.1 Background, details, hints,"
  href="node323.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="6.27 locale  "
  href="module-locale.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="6.27.3 Access to message"
  href="locale-gettext.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node323.html">6.27.1 Background, details, hints,</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="module-locale.html">6.27 locale  </A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="locale-gettext.html">6.27.3 Access to message</A>
</div>
</div>
<hr />
<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
</DIV>
<!--End of Navigation Panel-->
<ADDRESS>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</ADDRESS>
</BODY>
</HTML>
Commit	Line	Data
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="locale-gettext.html" />
	13	<link rel="prev" href="node323.html" />
	14	<link rel="parent" href="module-locale.html" />
	15	<link rel="next" href="locale-gettext.html" />
	16	<meta name='aesop' content='information' />
	17	<title>6.27.2 For extension writers and programs that embed Python </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="6.27.1 Background, details, hints,"
	25	href="node323.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="6.27 locale "
	28	href="module-locale.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="6.27.3 Access to message"
	31	href="locale-gettext.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="node323.html">6.27.1 Background, details, hints,</A>
	46	<b class="navlabel">Up:</b>
	47	<a class="sectref" rel="parent" href="module-locale.html">6.27 locale </A>
	48	<b class="navlabel">Next:</b>
	49	<a class="sectref" rel="next" href="locale-gettext.html">6.27.3 Access to message</A>
	50	</div>
	51	<hr /></div>
	52	</DIV>
	53	<!--End of Navigation Panel-->
	54
	55	<H2><A NAME="SECTION0082720000000000000000"></A><A NAME="embedding-locale"></A>
	56	<BR>
	57	6.27.2 For extension writers and programs that embed Python
	58
	59	</H2>
	60
	61	<P>
	62	Extension modules should never call <tt class="function">setlocale()</tt>, except to
	63	find out what the current locale is. But since the return value can
	64	only be used portably to restore it, that is not very useful (except
65	perhaps to find out whether or not the locale is "<tt class="samp">C</tt>").
66
67	<P>
68	When Python code uses the <tt class="module">locale</tt> module to change the locale,
69	this also affects the embedding application. If the embedding
70	application doesn't want this to happen, it should remove the
71	<tt class="module">_locale</tt> extension module (which does all the work) from the
72	table of built-in modules in the <span class="file">config.c</span> file, and make sure
73	that the <tt class="module">_locale</tt> module is not accessible as a shared library.
74
75	<P>
76
77	<DIV CLASS="navigation">
78	<div class='online-navigation'>
79	<p></p><hr />
80	<table align="center" width="100%" cellpadding="0" cellspacing="2">
81	<tr>
82	<td class='online-navigation'><a rel="prev" title="6.27.1 Background, details, hints,"
83	href="node323.html"><img src='../icons/previous.png'
84	border='0' height='32' alt='Previous Page' width='32' /></A></td>
85	<td class='online-navigation'><a rel="parent" title="6.27 locale "
86	href="module-locale.html"><img src='../icons/up.png'
87	border='0' height='32' alt='Up One Level' width='32' /></A></td>
88	<td class='online-navigation'><a rel="next" title="6.27.3 Access to message"
89	href="locale-gettext.html"><img src='../icons/next.png'
90	border='0' height='32' alt='Next Page' width='32' /></A></td>
91	<td align="center" width="100%">Python Library Reference</td>
92	<td class='online-navigation'><a rel="contents" title="Table of Contents"
93	href="contents.html"><img src='../icons/contents.png'
94	border='0' height='32' alt='Contents' width='32' /></A></td>
95	<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
96	border='0' height='32' alt='Module Index' width='32' /></a></td>
97	<td class='online-navigation'><a rel="index" title="Index"
98	href="genindex.html"><img src='../icons/index.png'
99	border='0' height='32' alt='Index' width='32' /></A></td>
100	</tr></table>
101	<div class='online-navigation'>
102	<b class="navlabel">Previous:</b>
103	<a class="sectref" rel="prev" href="node323.html">6.27.1 Background, details, hints,</A>
104	<b class="navlabel">Up:</b>
105	<a class="sectref" rel="parent" href="module-locale.html">6.27 locale </A>
106	<b class="navlabel">Next:</b>
107	<a class="sectref" rel="next" href="locale-gettext.html">6.27.3 Access to message</A>
108	</div>
109	</div>
110	<hr />
111	<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
112	</DIV>
113	<!--End of Navigation Panel-->
114	<ADDRESS>
115	See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
116	</ADDRESS>
117	</BODY>
118	</HTML>