diff options
Diffstat (limited to 'doc/pydoc/sys.html')
| -rw-r--r-- | doc/pydoc/sys.html | 105 |
1 files changed, 53 insertions, 52 deletions
diff --git a/doc/pydoc/sys.html b/doc/pydoc/sys.html index 84cd6ce5..65a2a515 100644 --- a/doc/pydoc/sys.html +++ b/doc/pydoc/sys.html @@ -1,6 +1,6 @@ + <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html><head><title>Python: built-in module sys</title> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> </head><body bgcolor="#f0f0f8"> <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading"> @@ -23,8 +23,11 @@ excepthook -- called to handle any uncaught e To customize printing in an interactive session or to install a custom<br> top-level exception handler, assign other functions to replace these.<br> <br> -stdin -- standard input file object; used by input()<br> -stdout -- standard output file object; used by print()<br> +exitfunc -- if sys.exitfunc exists, this routine is called when Python exits<br> + Assigning to sys.exitfunc is deprecated; use the atexit module instead.<br> + <br> +stdin -- standard input file object; used by raw_input() and input()<br> +stdout -- standard output file object; used by the print statement<br> stderr -- standard error object; used for error messages<br> By assigning other file objects (or objects that behave like files)<br> to these, it is possible to redirect all of the interpreter's I/O.<br> @@ -35,23 +38,26 @@ last_traceback -- traceback of last uncaught excep These three are only available in an interactive session after a<br> traceback has been printed.<br> <br> +exc_type -- type of exception currently being handled<br> +exc_value -- value of exception currently being handled<br> +exc_traceback -- traceback of exception currently being handled<br> + The function <a href="#-exc_info">exc_info</a>() should be used instead of these three,<br> + because it is thread-safe.<br> + <br> Static objects:<br> <br> -float_info -- a dict with information about the float implementation.<br> -int_info -- a struct sequence with information about the int implementation.<br> +maxint -- the largest supported integer (the smallest is -maxint-1)<br> maxsize -- the largest supported length of containers.<br> maxunicode -- the largest supported character<br> builtin_module_names -- tuple of module names built into this interpreter<br> -subversion -- subversion information of the build as tuple<br> version -- the version of this interpreter as a string<br> -version_info -- version information as a named tuple<br> +version_info -- version information as a tuple<br> hexversion -- version information encoded as a single integer<br> copyright -- copyright notice pertaining to this interpreter<br> platform -- platform identifier<br> executable -- pathname of this Python interpreter<br> prefix -- prefix used to find the Python library<br> exec_prefix -- prefix used to find the machine-specific Python library<br> -float_repr_style -- string indicating the style of repr() output for floats<br> __stdin__ -- the original stdin; don't touch!<br> __stdout__ -- the original stdout; don't touch!<br> __stderr__ -- the original stderr; don't touch!<br> @@ -60,9 +66,10 @@ __excepthook__ -- the original excepthook; don't t <br> Functions:<br> <br> -<a href="#-displayhook">displayhook</a>() -- print an object to the screen, and save it in builtins._<br> +<a href="#-displayhook">displayhook</a>() -- print an object to the screen, and save it in __builtin__._<br> <a href="#-excepthook">excepthook</a>() -- print an exception and its traceback to sys.stderr<br> <a href="#-exc_info">exc_info</a>() -- return thread-safe information about the current exception<br> +<a href="#-exc_clear">exc_clear</a>() -- clear the exception state for the current thread<br> <a href="#-exit">exit</a>() -- exit the interpreter by raising SystemExit<br> <a href="#-getdlopenflags">getdlopenflags</a>() -- returns flags to be used for dlopen() calls<br> <a href="#-getprofile">getprofile</a>() -- get the global profiling function<br> @@ -84,7 +91,7 @@ Functions:<br> <tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td> <td width="100%"><dl><dt><a name="-__displayhook__"><strong>__displayhook__</strong></a> = displayhook(...)</dt><dd><tt><a href="#-displayhook">displayhook</a>(object) -> None<br> <br> -Print an object to sys.stdout and also save it in builtins.</tt></dd></dl> +Print an object to sys.stdout and also save it in __builtin__.</tt></dd></dl> <dl><dt><a name="-__excepthook__"><strong>__excepthook__</strong></a> = excepthook(...)</dt><dd><tt><a href="#-excepthook">excepthook</a>(exctype, value, traceback) -> None<br> <br> Handle an exception by displaying it with a traceback on sys.stderr.</tt></dd></dl> @@ -115,7 +122,13 @@ a 11-tuple where the entries in the tuple&nbs 10. Number of stack pops performed by call_function()</tt></dd></dl> <dl><dt><a name="-displayhook"><strong>displayhook</strong></a>(...)</dt><dd><tt><a href="#-displayhook">displayhook</a>(object) -> None<br> <br> -Print an object to sys.stdout and also save it in builtins.</tt></dd></dl> +Print an object to sys.stdout and also save it in __builtin__.</tt></dd></dl> + <dl><dt><a name="-exc_clear"><strong>exc_clear</strong></a>(...)</dt><dd><tt><a href="#-exc_clear">exc_clear</a>() -> None<br> + <br> +Clear global information on the current exception. Subsequent calls to<br> +<a href="#-exc_info">exc_info</a>() will return (None,None,None) until another exception is raised<br> +in the current thread or the execution stack returns to a frame where<br> +another exception is being handled.</tt></dd></dl> <dl><dt><a name="-exc_info"><strong>exc_info</strong></a>(...)</dt><dd><tt><a href="#-exc_info">exc_info</a>() -> (type, value, traceback)<br> <br> Return information about the most recent exception caught by an except<br> @@ -137,8 +150,8 @@ Return the current default string encoding used&nb implementation.</tt></dd></dl> <dl><dt><a name="-getdlopenflags"><strong>getdlopenflags</strong></a>(...)</dt><dd><tt><a href="#-getdlopenflags">getdlopenflags</a>() -> int<br> <br> -Return the current value of the flags that are used for dlopen calls.<br> -The flag constants are defined in the ctypes and DLFCN modules.</tt></dd></dl> +Return the current value of the flags that are used for dlopen()<br> +calls. The flag constants are defined in the dl module.</tt></dd></dl> <dl><dt><a name="-getfilesystemencoding"><strong>getfilesystemencoding</strong></a>(...)</dt><dd><tt><a href="#-getfilesystemencoding">getfilesystemencoding</a>() -> string<br> <br> Return the encoding used to convert Unicode filenames in<br> @@ -164,30 +177,17 @@ Return the size of object in bytes.</tt></dd></dl> <br> Return the global debug tracing function set with sys.settrace.<br> See the debugger chapter in the library manual.</tt></dd></dl> - <dl><dt><a name="-intern"><strong>intern</strong></a>(...)</dt><dd><tt><a href="#-intern">intern</a>(string) -> string<br> - <br> -``Intern'' the given string. This enters the string in the (global)<br> -table of interned strings whose purpose is to speed up dictionary lookups.<br> -Return the string itself or the previously interned string object with the<br> -same value.</tt></dd></dl> <dl><dt><a name="-setcheckinterval"><strong>setcheckinterval</strong></a>(...)</dt><dd><tt><a href="#-setcheckinterval">setcheckinterval</a>(n)<br> <br> Tell the Python interpreter to check for asynchronous events every<br> n instructions. This also affects how often thread switches occur.</tt></dd></dl> <dl><dt><a name="-setdlopenflags"><strong>setdlopenflags</strong></a>(...)</dt><dd><tt><a href="#-setdlopenflags">setdlopenflags</a>(n) -> None<br> <br> -Set the flags used by the interpreter for dlopen calls, such as when the<br> -interpreter loads extension modules. Among other things, this will enable<br> -a lazy resolving of symbols when importing a module, if called as<br> -sys.<a href="#-setdlopenflags">setdlopenflags</a>(0). To share symbols across extension modules, call as<br> -sys.<a href="#-setdlopenflags">setdlopenflags</a>(ctypes.RTLD_GLOBAL). Symbolic names for the flag modules<br> -can be either found in the ctypes module, or in the DLFCN module. If DLFCN<br> -is not available, it can be generated from /usr/include/dlfcn.h using the<br> -h2py script.</tt></dd></dl> - <dl><dt><a name="-setfilesystemencoding"><strong>setfilesystemencoding</strong></a>(...)</dt><dd><tt><a href="#-setfilesystemencoding">setfilesystemencoding</a>(string) -> None<br> - <br> -Set the encoding used to convert Unicode filenames in<br> -operating system filenames.</tt></dd></dl> +Set the flags that will be used for dlopen() calls. Among other<br> +things, this will enable a lazy resolving of symbols when importing<br> +a module, if called as sys.<a href="#-setdlopenflags">setdlopenflags</a>(0)<br> +To share symbols across extension modules, call as<br> +sys.<a href="#-setdlopenflags">setdlopenflags</a>(dl.RTLD_NOW|dl.RTLD_GLOBAL)</tt></dd></dl> <dl><dt><a name="-setprofile"><strong>setprofile</strong></a>(...)</dt><dd><tt><a href="#-setprofile">setprofile</a>(function)<br> <br> Set the profiling function. It will be called on each function call<br> @@ -209,36 +209,37 @@ function call. See the debugger chapter in&n <font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr> <tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td> -<td width="100%"><strong>__stderr__</strong> = <_io.TextIOWrapper name='<stderr>' encoding='UTF-8'><br> -<strong>__stdin__</strong> = <_io.TextIOWrapper name='<stdin>' encoding='UTF-8'><br> -<strong>__stdout__</strong> = <_io.TextIOWrapper name='<stdout>' encoding='UTF-8'><br> +<td width="100%"><strong>__stderr__</strong> = <open file '<stderr>', mode 'w' at 0x7fdbe72451c8><br> +<strong>__stdin__</strong> = <open file '<stdin>', mode 'r' at 0x7fdbe72450b8><br> +<strong>__stdout__</strong> = <open file '<stdout>', mode 'w' at 0x7fdbe7245140><br> <strong>api_version</strong> = 1013<br> <strong>argv</strong> = ['./make_doc.py']<br> -<strong>builtin_module_names</strong> = ('__main__', '_ast', '_codecs', '_functools', '_io', '_locale', '_sre', '_symtable', '_thread', '_warnings', '_weakref', 'builtins', 'errno', 'gc', 'imp', 'marshal', 'posix', 'pwd', 'signal', 'sys', ...)<br> +<strong>builtin_module_names</strong> = ('__builtin__', '__main__', '_ast', '_codecs', '_sre', '_symtable', '_warnings', 'errno', 'exceptions', 'gc', 'imp', 'marshal', 'posix', 'pwd', 'signal', 'sys', 'thread', 'xxsubtype', 'zipimport')<br> <strong>byteorder</strong> = 'little'<br> <strong>copyright</strong> = 'Copyright (c) 2001-2009 Python Software Foundati...ematisch Centrum, Amsterdam.<font color="#c040c0">\n</font>All Rights Reserved.'<br> <strong>dont_write_bytecode</strong> = False<br> +<strong>exc_value</strong> = TypeError('arg is a built-in module',)<br> <strong>exec_prefix</strong> = '/usr'<br> -<strong>executable</strong> = '/usr/bin/python3'<br> -<strong>flags</strong> = sys.flags(debug=0, division_warning=0, inspect=0...ignore_environment=0, verbose=0, bytes_warning=0)<br> -<strong>float_info</strong> = sys.floatinfo(max=1.7976931348623157e+308, max_e...epsilon=2.220446049250313e-16, radix=2, rounds=1)<br> -<strong>float_repr_style</strong> = 'short'<br> -<strong>hexversion</strong> = 50397680<br> -<strong>int_info</strong> = sys.int_info(bits_per_digit=30, sizeof_digit=4)<br> +<strong>executable</strong> = '/usr/bin/python'<br> +<strong>flags</strong> = sys.flags(debug=0, py3k_warning=0, division_warn...abcheck=0, verbose=0, unicode=0, bytes_warning=0)<br> +<strong>float_info</strong> = sys.floatinfo(max=1.7976931348623157e+308, max_e...psilon=2.2204460492503131e-16, radix=2, rounds=1)<br> +<strong>hexversion</strong> = 33948912<br> +<strong>maxint</strong> = 9223372036854775807<br> <strong>maxsize</strong> = 9223372036854775807<br> -<strong>maxunicode</strong> = 1114111<br> +<strong>maxunicode</strong> = 65535<br> <strong>meta_path</strong> = []<br> -<strong>modules</strong> = {'__future__': <module '__future__' from '/usr/lib/python3.1/__future__.py'>, '__main__': <module '__main__' from './make_doc.py'>, '_abcoll': <module '_abcoll' from '/usr/lib/python3.1/_abcoll.py'>, '_bisect': <module '_bisect' from '/usr/lib/python3.1/lib-dynload/_bisect.so'>, '_codecs': <module '_codecs' (built-in)>, '_collections': <module '_collections' from '/usr/lib/python3.1/lib-dynload/_collections.so'>, '_compat_pickle': <module '_compat_pickle' from '/usr/lib/python3.1/_compat_pickle.py'>, '_curses': <module '_curses' from '/usr/lib/python3.1/lib-dynload/_curses.so'>, '_functools': <module '_functools' (built-in)>, '_heapq': <module '_heapq' from '/usr/lib/python3.1/lib-dynload/_heapq.so'>, ...}<br> -<strong>path</strong> = ['/home/hut/work/ranger', '/usr/lib/python31.zip', '/usr/lib/python3.1', '/usr/lib/python3.1/plat-linux2', '/usr/lib/python3.1/lib-dynload', '/usr/lib/python3.1/site-packages', '/home/hut/.ranger']<br> -<strong>path_hooks</strong> = [<class 'zipimport.zipimporter'>]<br> -<strong>path_importer_cache</strong> = {'.': None, './make_doc.py': <imp.NullImporter object at 0x7f6a922d69e0>, '/home/hut/.ranger': None, '/home/hut/work/ranger': None, '/home/hut/work/ranger/ranger': None, '/home/hut/work/ranger/ranger/colorschemes': None, '/home/hut/work/ranger/ranger/container': None, '/home/hut/work/ranger/ranger/defaults': None, '/home/hut/work/ranger/ranger/ext': None, '/home/hut/work/ranger/ranger/fsobject': None, ...}<br> +<strong>modules</strong> = {'UserDict': <module 'UserDict' from '/usr/lib/python2.6/UserDict.pyc'>, '__builtin__': <module '__builtin__' (built-in)>, '__future__': <module '__future__' from '/usr/lib/python2.6/__future__.pyc'>, '__main__': <module '__main__' from './make_doc.py'>, '_abcoll': <module '_abcoll' from '/usr/lib/python2.6/_abcoll.pyc'>, '_codecs': <module '_codecs' (built-in)>, '_collections': <module '_collections' from '/usr/lib/python2.6/lib-dynload/_collections.so'>, '_curses': <module '_curses' from '/usr/lib/python2.6/lib-dynload/_curses.so'>, '_random': <module '_random' from '/usr/lib/python2.6/lib-dynload/_random.so'>, '_socket': <module '_socket' from '/usr/lib/python2.6/lib-dynload/_socket.so'>, ...}<br> +<strong>path</strong> = ['/home/hut/.ranger', '/home/hut/ranger', '/usr/lib/python26.zip', '/usr/lib/python2.6', '/usr/lib/python2.6/plat-linux2', '/usr/lib/python2.6/lib-tk', '/usr/lib/python2.6/lib-old', '/usr/lib/python2.6/lib-dynload', '/usr/lib/python2.6/site-packages', '/usr/lib/python2.6/site-packages/PIL', '/usr/lib/python2.6/site-packages/gst-0.10', '/usr/lib/python2.6/site-packages/gtk-2.0', '/home/hut/.ranger']<br> +<strong>path_hooks</strong> = [<type 'zipimport.zipimporter'>]<br> +<strong>path_importer_cache</strong> = {'.': None, './make_doc.py': <imp.NullImporter object at 0x7fdbe71e8080>, '/home/hut/.ranger': None, '/home/hut/.ranger/colorschemes': None, '/home/hut/ranger': None, '/home/hut/ranger/ranger': None, '/home/hut/ranger/ranger/api': None, '/home/hut/ranger/ranger/colorschemes': None, '/home/hut/ranger/ranger/container': None, '/home/hut/ranger/ranger/defaults': None, ...}<br> <strong>platform</strong> = 'linux2'<br> <strong>prefix</strong> = '/usr'<br> -<strong>stderr</strong> = <_io.TextIOWrapper name='<stderr>' encoding='UTF-8'><br> -<strong>stdin</strong> = <_io.TextIOWrapper name='<stdin>' encoding='UTF-8'><br> -<strong>stdout</strong> = <_io.TextIOWrapper name='<stdout>' encoding='UTF-8'><br> -<strong>subversion</strong> = ('CPython', 'tags/r311', '74480')<br> -<strong>version</strong> = '3.1.1 (r311:74480, Aug 27 2009, 04:56:37) <font color="#c040c0">\n</font>[GCC 4.4.1]'<br> -<strong>version_info</strong> = sys.version_info(major=3, minor=1, micro=1, releaselevel='final', serial=0)<br> +<strong>py3kwarning</strong> = False<br> +<strong>stderr</strong> = <open file '<stderr>', mode 'w' at 0x7fdbe72451c8><br> +<strong>stdin</strong> = <open file '<stdin>', mode 'r' at 0x7fdbe72450b8><br> +<strong>stdout</strong> = <open file '<stdout>', mode 'w' at 0x7fdbe7245140><br> +<strong>subversion</strong> = ('CPython', 'tags/r264', '75706')<br> +<strong>version</strong> = '2.6.4 (r264:75706, Oct 27 2009, 06:25:13) <font color="#c040c0">\n</font>[GCC 4.4.1]'<br> +<strong>version_info</strong> = (2, 6, 4, 'final', 0)<br> <strong>warnoptions</strong> = []</td></tr></table> </body></html> \ No newline at end of file |