# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2022, Python Software Foundation

# This file is distributed under the same license as the Python package.

#

# Translators:

# Adrian Liaw <adrianliaw2000@gmail.com>, 2018

msgid ""

msgstr ""

"Project-Id-Version: Python 3.12\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2023-08-01 00:03+0000\n"

"PO-Revision-Date: 2023-04-24 20:49+0800\n"

"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"

"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"

"tw)\n"

"Language: zh_TW\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=1; plural=0;\n"

"X-Generator: Poedit 3.2.2\n"

#: ../../c-api/init.rst:8

msgid "Initialization, Finalization, and Threads"

msgstr ""

#: ../../c-api/init.rst:10

msgid "See also :ref:`Python Initialization Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:15

msgid "Before Python Initialization"

msgstr ""

#: ../../c-api/init.rst:17

msgid ""

"In an application embedding Python, the :c:func:`Py_Initialize` function "

"must be called before using any other Python/C API functions; with the "

"exception of a few functions and the :ref:`global configuration variables "

"<global-conf-vars>`."

msgstr ""

#: ../../c-api/init.rst:22

msgid ""

"The following functions can be safely called before Python is initialized:"

msgstr ""

#: ../../c-api/init.rst:24

msgid "Configuration functions:"

msgstr ""

#: ../../c-api/init.rst:26

msgid ":c:func:`PyImport_AppendInittab`"

msgstr ":c:func:`PyImport_AppendInittab`"

#: ../../c-api/init.rst:27

msgid ":c:func:`PyImport_ExtendInittab`"

msgstr ":c:func:`PyImport_ExtendInittab`"

#: ../../c-api/init.rst:28

msgid ":c:func:`!PyInitFrozenExtensions`"

msgstr ":c:func:`!PyInitFrozenExtensions`"

#: ../../c-api/init.rst:29

msgid ":c:func:`PyMem_SetAllocator`"

msgstr ":c:func:`PyMem_SetAllocator`"

#: ../../c-api/init.rst:30

msgid ":c:func:`PyMem_SetupDebugHooks`"

msgstr ":c:func:`PyMem_SetupDebugHooks`"

#: ../../c-api/init.rst:31

msgid ":c:func:`PyObject_SetArenaAllocator`"

msgstr ":c:func:`PyObject_SetArenaAllocator`"

#: ../../c-api/init.rst:32

msgid ":c:func:`Py_SetPath`"

msgstr ":c:func:`Py_SetPath`"

#: ../../c-api/init.rst:33

msgid ":c:func:`Py_SetProgramName`"

msgstr ":c:func:`Py_SetProgramName`"

#: ../../c-api/init.rst:34

msgid ":c:func:`Py_SetPythonHome`"

msgstr ":c:func:`Py_SetPythonHome`"

#: ../../c-api/init.rst:35

msgid ":c:func:`Py_SetStandardStreamEncoding`"

msgstr ":c:func:`Py_SetStandardStreamEncoding`"

#: ../../c-api/init.rst:36

msgid ":c:func:`PySys_AddWarnOption`"

msgstr ":c:func:`PySys_AddWarnOption`"

#: ../../c-api/init.rst:37

msgid ":c:func:`PySys_AddXOption`"

msgstr ":c:func:`PySys_AddXOption`"

#: ../../c-api/init.rst:38

msgid ":c:func:`PySys_ResetWarnOptions`"

msgstr ":c:func:`PySys_ResetWarnOptions`"

#: ../../c-api/init.rst:40

msgid "Informative functions:"

msgstr ""

#: ../../c-api/init.rst:42

msgid ":c:func:`Py_IsInitialized`"

msgstr ":c:func:`Py_IsInitialized`"

#: ../../c-api/init.rst:43

msgid ":c:func:`PyMem_GetAllocator`"

msgstr ":c:func:`PyMem_GetAllocator`"

#: ../../c-api/init.rst:44

msgid ":c:func:`PyObject_GetArenaAllocator`"

msgstr ":c:func:`PyObject_GetArenaAllocator`"

#: ../../c-api/init.rst:45

msgid ":c:func:`Py_GetBuildInfo`"

msgstr ":c:func:`Py_GetBuildInfo`"

#: ../../c-api/init.rst:46

msgid ":c:func:`Py_GetCompiler`"

msgstr ":c:func:`Py_GetCompiler`"

#: ../../c-api/init.rst:47

msgid ":c:func:`Py_GetCopyright`"

msgstr ":c:func:`Py_GetCopyright`"

#: ../../c-api/init.rst:48

msgid ":c:func:`Py_GetPlatform`"

msgstr ":c:func:`Py_GetPlatform`"

#: ../../c-api/init.rst:49

msgid ":c:func:`Py_GetVersion`"

msgstr ":c:func:`Py_GetVersion`"

#: ../../c-api/init.rst:51

msgid "Utilities:"

msgstr ""

#: ../../c-api/init.rst:53

msgid ":c:func:`Py_DecodeLocale`"

msgstr ":c:func:`Py_DecodeLocale`"

#: ../../c-api/init.rst:55

msgid "Memory allocators:"

msgstr ""

#: ../../c-api/init.rst:57

msgid ":c:func:`PyMem_RawMalloc`"

msgstr ":c:func:`PyMem_RawMalloc`"

#: ../../c-api/init.rst:58

msgid ":c:func:`PyMem_RawRealloc`"

msgstr ":c:func:`PyMem_RawRealloc`"

#: ../../c-api/init.rst:59

msgid ":c:func:`PyMem_RawCalloc`"

msgstr ":c:func:`PyMem_RawCalloc`"

#: ../../c-api/init.rst:60

msgid ":c:func:`PyMem_RawFree`"

msgstr ":c:func:`PyMem_RawFree`"

#: ../../c-api/init.rst:64

msgid ""

"The following functions **should not be called** before :c:func:"

"`Py_Initialize`: :c:func:`Py_EncodeLocale`, :c:func:`Py_GetPath`, :c:func:"

"`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, :c:func:"

"`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:"

"`Py_GetProgramName` and :c:func:`PyEval_InitThreads`."

msgstr ""

#: ../../c-api/init.rst:74

msgid "Global configuration variables"

msgstr ""

#: ../../c-api/init.rst:76

msgid ""

"Python has variables for the global configuration to control different "

"features and options. By default, these flags are controlled by :ref:"

"`command line options <using-on-interface-options>`."

msgstr ""

#: ../../c-api/init.rst:80

msgid ""

"When a flag is set by an option, the value of the flag is the number of "

"times that the option was set. For example, ``-b`` sets :c:data:"

"`Py_BytesWarningFlag` to 1 and ``-bb`` sets :c:data:`Py_BytesWarningFlag` to "

"2."

msgstr ""

#: ../../c-api/init.rst:86

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"bytes_warning` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:90

msgid ""

"Issue a warning when comparing :class:`bytes` or :class:`bytearray` with :"

"class:`str` or :class:`bytes` with :class:`int`. Issue an error if greater "

"or equal to ``2``."

msgstr ""

#: ../../c-api/init.rst:94

msgid "Set by the :option:`-b` option."

msgstr "由 :option:`-b` 選項設定。"

#: ../../c-api/init.rst:100

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"parser_debug` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:104

msgid ""

"Turn on parser debugging output (for expert only, depending on compilation "

"options)."

msgstr ""

#: ../../c-api/init.rst:107

msgid ""

"Set by the :option:`-d` option and the :envvar:`PYTHONDEBUG` environment "

"variable."

msgstr "由 :option:`-d` 選項與 :envvar:`PYTHONDEBUG` 環境變數設定。"

#: ../../c-api/init.rst:114

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"write_bytecode` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:118

msgid ""

"If set to non-zero, Python won't try to write ``.pyc`` files on the import "

"of source modules."

msgstr ""

#: ../../c-api/init.rst:121

msgid ""

"Set by the :option:`-B` option and the :envvar:`PYTHONDONTWRITEBYTECODE` "

"environment variable."

msgstr ""

"由 :option:`-B` 選項與 :envvar:`PYTHONDONTWRITEBYTECODE` 環境變數設定。"

#: ../../c-api/init.rst:128

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"pathconfig_warnings` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:132

msgid ""

"Suppress error messages when calculating the module search path in :c:func:"

"`Py_GetPath`."

msgstr ""

#: ../../c-api/init.rst:135

msgid "Private flag used by ``_freeze_module`` and ``frozenmain`` programs."

msgstr ""

#: ../../c-api/init.rst:141

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"hash_seed` and :c:member:`PyConfig.use_hash_seed` should be used instead, "

"see :ref:`Python Initialization Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:146

msgid ""

"Set to ``1`` if the :envvar:`PYTHONHASHSEED` environment variable is set to "

"a non-empty string."

msgstr ""

"如果環境變數 :envvar:`PYTHONHASHSEED` 被設定為一個非空字串則設為 ``1``。"

#: ../../c-api/init.rst:149

msgid ""

"If the flag is non-zero, read the :envvar:`PYTHONHASHSEED` environment "

"variable to initialize the secret hash seed."

msgstr ""

#: ../../c-api/init.rst:156

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"use_environment` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:160

msgid ""

"Ignore all :envvar:`!PYTHON*` environment variables, e.g. :envvar:"

"`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set."

msgstr ""

#: ../../c-api/init.rst:163

msgid "Set by the :option:`-E` and :option:`-I` options."

msgstr "由 :option:`-E` 與 :option:`-I` 選項設定。"

#: ../../c-api/init.rst:169

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"inspect` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:173

msgid ""

"When a script is passed as first argument or the :option:`-c` option is "

"used, enter interactive mode after executing the script or the command, even "

"when :data:`sys.stdin` does not appear to be a terminal."

msgstr ""

#: ../../c-api/init.rst:177

msgid ""

"Set by the :option:`-i` option and the :envvar:`PYTHONINSPECT` environment "

"variable."

msgstr "由 :option:`-i` 選項與 :envvar:`PYTHONINSPECT` 環境變數設定。"

#: ../../c-api/init.rst:184

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"interactive` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:188

msgid "Set by the :option:`-i` option."

msgstr "由 :option:`-i` 選項設定。"

#: ../../c-api/init.rst:194

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"isolated` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:198

msgid ""

"Run Python in isolated mode. In isolated mode :data:`sys.path` contains "

"neither the script's directory nor the user's site-packages directory."

msgstr ""

#: ../../c-api/init.rst:201

msgid "Set by the :option:`-I` option."

msgstr "由 :option:`-i` 選項設定。"

#: ../../c-api/init.rst:209

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyPreConfig."

"legacy_windows_fs_encoding` should be used instead, see :ref:`Python "

"Initialization Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:213

msgid ""

"If the flag is non-zero, use the ``mbcs`` encoding with ``replace`` error "

"handler, instead of the UTF-8 encoding with ``surrogatepass`` error handler, "

"for the :term:`filesystem encoding and error handler`."

msgstr ""

#: ../../c-api/init.rst:217

msgid ""

"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSFSENCODING` environment "

"variable is set to a non-empty string."

msgstr ""

"如果環境變數 :envvar:`PYTHONLEGACYWINDOWSFSENCODING` 被設定為一個非空字串則設"

"為 ``1``。"

#: ../../c-api/init.rst:220

msgid "See :pep:`529` for more details."

msgstr "更多詳情請見 :pep:`529`\\ 。"

#: ../../c-api/init.rst:222 ../../c-api/init.rst:240

msgid ":ref:`Availability <availability>`: Windows."

msgstr ":ref:`適用 <availability>`：Windows。"

#: ../../c-api/init.rst:228

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"legacy_windows_stdio` should be used instead, see :ref:`Python "

"Initialization Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:232

msgid ""

"If the flag is non-zero, use :class:`io.FileIO` instead of :class:`!io."

"_WindowsConsoleIO` for :mod:`sys` standard streams."

msgstr ""

#: ../../c-api/init.rst:235

msgid ""

"Set to ``1`` if the :envvar:`PYTHONLEGACYWINDOWSSTDIO` environment variable "

"is set to a non-empty string."

msgstr ""

#: ../../c-api/init.rst:238

msgid "See :pep:`528` for more details."

msgstr "更多詳情請見 :pep:`528`\\ 。"

#: ../../c-api/init.rst:246

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"site_import` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:250

msgid ""

"Disable the import of the module :mod:`site` and the site-dependent "

"manipulations of :data:`sys.path` that it entails. Also disable these "

"manipulations if :mod:`site` is explicitly imported later (call :func:`site."

"main` if you want them to be triggered)."

msgstr ""

#: ../../c-api/init.rst:255

msgid "Set by the :option:`-S` option."

msgstr "由 :option:`-S` 選項設定。"

#: ../../c-api/init.rst:261

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"user_site_directory` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:265

msgid ""

"Don't add the :data:`user site-packages directory <site.USER_SITE>` to :data:"

"`sys.path`."

msgstr ""

#: ../../c-api/init.rst:268

msgid ""

"Set by the :option:`-s` and :option:`-I` options, and the :envvar:"

"`PYTHONNOUSERSITE` environment variable."

msgstr ""

"由 :option:`-s` 選項、:option:`-I` 選項與 :envvar:`PYTHONNOUSERSITE` 環境變數"

"設定。"

#: ../../c-api/init.rst:275

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"optimization_level` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:279

msgid ""

"Set by the :option:`-O` option and the :envvar:`PYTHONOPTIMIZE` environment "

"variable."

msgstr "由 :option:`-O` 選項與 :envvar:`PYTHONOPTIMIZE` 環境變數設定。"

#: ../../c-api/init.rst:286

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"quiet` should be used instead, see :ref:`Python Initialization Configuration "

"<init-config>`."

msgstr ""

#: ../../c-api/init.rst:290

msgid ""

"Don't display the copyright and version messages even in interactive mode."

msgstr ""

#: ../../c-api/init.rst:292

msgid "Set by the :option:`-q` option."

msgstr "由 :option:`-q` 選項設定。"

#: ../../c-api/init.rst:300

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"buffered_stdio` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:304

msgid "Force the stdout and stderr streams to be unbuffered."

msgstr ""

#: ../../c-api/init.rst:306

msgid ""

"Set by the :option:`-u` option and the :envvar:`PYTHONUNBUFFERED` "

"environment variable."

msgstr "由 :option:`-u` 選項與 :envvar:`PYTHONUNBUFFERED` 環境變數設定。"

#: ../../c-api/init.rst:313

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"verbose` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:317

msgid ""

"Print a message each time a module is initialized, showing the place "

"(filename or built-in module) from which it is loaded. If greater or equal "

"to ``2``, print a message for each file that is checked for when searching "

"for a module. Also provides information on module cleanup at exit."

msgstr ""

#: ../../c-api/init.rst:322

msgid ""

"Set by the :option:`-v` option and the :envvar:`PYTHONVERBOSE` environment "

"variable."

msgstr "由 :option:`-v` 選項與 :envvar:`PYTHONVERBOSE` 環境變數設定。"

#: ../../c-api/init.rst:329

msgid "Initializing and finalizing the interpreter"

msgstr ""

#: ../../c-api/init.rst:347

msgid ""

"Initialize the Python interpreter. In an application embedding Python, "

"this should be called before using any other Python/C API functions; see :"

"ref:`Before Python Initialization <pre-init-safe>` for the few exceptions."

msgstr ""

#: ../../c-api/init.rst:351

msgid ""

"This initializes the table of loaded modules (``sys.modules``), and creates "

"the fundamental modules :mod:`builtins`, :mod:`__main__` and :mod:`sys`. It "

"also initializes the module search path (``sys.path``). It does not set "

"``sys.argv``; use :c:func:`PySys_SetArgvEx` for that. This is a no-op when "

"called for a second time (without calling :c:func:`Py_FinalizeEx` first). "

"There is no return value; it is a fatal error if the initialization fails."

msgstr ""

#: ../../c-api/init.rst:359 ../../c-api/init.rst:373

msgid ""

"Use the :c:func:`Py_InitializeFromConfig` function to customize the :ref:"

"`Python Initialization Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:363

msgid ""

"On Windows, changes the console mode from ``O_TEXT`` to ``O_BINARY``, which "

"will also affect non-Python uses of the console using the C Runtime."

msgstr ""

#: ../../c-api/init.rst:369

msgid ""

"This function works like :c:func:`Py_Initialize` if *initsigs* is ``1``. If "

"*initsigs* is ``0``, it skips initialization registration of signal "

"handlers, which might be useful when Python is embedded."

msgstr ""

#: ../../c-api/init.rst:379

msgid ""

"Return true (nonzero) when the Python interpreter has been initialized, "

"false (zero) if not. After :c:func:`Py_FinalizeEx` is called, this returns "

"false until :c:func:`Py_Initialize` is called again."

msgstr ""

#: ../../c-api/init.rst:386

msgid ""

"Undo all initializations made by :c:func:`Py_Initialize` and subsequent use "

"of Python/C API functions, and destroy all sub-interpreters (see :c:func:"

"`Py_NewInterpreter` below) that were created and not yet destroyed since the "

"last call to :c:func:`Py_Initialize`. Ideally, this frees all memory "

"allocated by the Python interpreter. This is a no-op when called for a "

"second time (without calling :c:func:`Py_Initialize` again first). Normally "

"the return value is ``0``. If there were errors during finalization "

"(flushing buffered data), ``-1`` is returned."

msgstr ""

#: ../../c-api/init.rst:395

msgid ""

"This function is provided for a number of reasons. An embedding application "

"might want to restart Python without having to restart the application "

"itself. An application that has loaded the Python interpreter from a "

"dynamically loadable library (or DLL) might want to free all memory "

"allocated by Python before unloading the DLL. During a hunt for memory leaks "

"in an application a developer might want to free all memory allocated by "

"Python before exiting from the application."

msgstr ""

#: ../../c-api/init.rst:403

msgid ""

"**Bugs and caveats:** The destruction of modules and objects in modules is "

"done in random order; this may cause destructors (:meth:`~object.__del__` "

"methods) to fail when they depend on other objects (even functions) or "

"modules. Dynamically loaded extension modules loaded by Python are not "

"unloaded. Small amounts of memory allocated by the Python interpreter may "

"not be freed (if you find a leak, please report it). Memory tied up in "

"circular references between objects is not freed. Some memory allocated by "

"extension modules may not be freed. Some extensions may not work properly "

"if their initialization routine is called more than once; this can happen if "

"an application calls :c:func:`Py_Initialize` and :c:func:`Py_FinalizeEx` "

"more than once."

msgstr ""

#: ../../c-api/init.rst:414

msgid ""

"Raises an :ref:`auditing event <auditing>` ``cpython."

"_PySys_ClearAuditHooks`` with no arguments."

msgstr ""

"引發一個不附帶引數的\\ :ref:`稽核事件 <auditing>` ``cpython."

"_PySys_ClearAuditHooks``。"

#: ../../c-api/init.rst:420

msgid ""

"This is a backwards-compatible version of :c:func:`Py_FinalizeEx` that "

"disregards the return value."

msgstr ""

#: ../../c-api/init.rst:425

msgid "Process-wide parameters"

msgstr ""

#: ../../c-api/init.rst:435

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"stdio_encoding` and :c:member:`PyConfig.stdio_errors` should be used "

"instead, see :ref:`Python Initialization Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:440

msgid ""

"This function should be called before :c:func:`Py_Initialize`, if it is "

"called at all. It specifies which encoding and error handling to use with "

"standard IO, with the same meanings as in :func:`str.encode`."

msgstr ""

#: ../../c-api/init.rst:444

msgid ""

"It overrides :envvar:`PYTHONIOENCODING` values, and allows embedding code to "

"control IO encoding when the environment variable does not work."

msgstr ""

#: ../../c-api/init.rst:447

msgid ""

"*encoding* and/or *errors* may be ``NULL`` to use :envvar:`PYTHONIOENCODING` "

"and/or default values (depending on other settings)."

msgstr ""

#: ../../c-api/init.rst:451

msgid ""

"Note that :data:`sys.stderr` always uses the \"backslashreplace\" error "

"handler, regardless of this (or any other) setting."

msgstr ""

#: ../../c-api/init.rst:454

msgid ""

"If :c:func:`Py_FinalizeEx` is called, this function will need to be called "

"again in order to affect subsequent calls to :c:func:`Py_Initialize`."

msgstr ""

#: ../../c-api/init.rst:457

msgid ""

"Returns ``0`` if successful, a nonzero value on error (e.g. calling after "

"the interpreter has already been initialized)."

msgstr ""

#: ../../c-api/init.rst:472

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"program_name` should be used instead, see :ref:`Python Initialization "

"Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:476

msgid ""

"This function should be called before :c:func:`Py_Initialize` is called for "

"the first time, if it is called at all. It tells the interpreter the value "

"of the ``argv[0]`` argument to the :c:func:`main` function of the program "

"(converted to wide characters). This is used by :c:func:`Py_GetPath` and "

"some other functions below to find the Python run-time libraries relative to "

"the interpreter executable. The default value is ``'python'``. The "

"argument should point to a zero-terminated wide character string in static "

"storage whose contents will not change for the duration of the program's "

"execution. No code in the Python interpreter will change the contents of "

"this storage."

msgstr ""

#: ../../c-api/init.rst:487

msgid ""

"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a :c:expr:"

"`wchar_t *` string."

msgstr ""

#: ../../c-api/init.rst:497

msgid ""

"Return the program name set with :c:func:`Py_SetProgramName`, or the "

"default. The returned string points into static storage; the caller should "

"not modify its value."

msgstr ""

#: ../../c-api/init.rst:501 ../../c-api/init.rst:520 ../../c-api/init.rst:561

#: ../../c-api/init.rst:580 ../../c-api/init.rst:604 ../../c-api/init.rst:827

msgid ""

"This function should not be called before :c:func:`Py_Initialize`, otherwise "

"it returns ``NULL``."

msgstr ""

#: ../../c-api/init.rst:504 ../../c-api/init.rst:523 ../../c-api/init.rst:564

#: ../../c-api/init.rst:583 ../../c-api/init.rst:609 ../../c-api/init.rst:830

msgid "It now returns ``NULL`` if called before :c:func:`Py_Initialize`."

msgstr ""

#: ../../c-api/init.rst:510

msgid ""

"Return the *prefix* for installed platform-independent files. This is "

"derived through a number of complicated rules from the program name set "

"with :c:func:`Py_SetProgramName` and some environment variables; for "

"example, if the program name is ``'/usr/local/bin/python'``, the prefix is "

"``'/usr/local'``. The returned string points into static storage; the caller "

"should not modify its value. This corresponds to the :makevar:`prefix` "

"variable in the top-level :file:`Makefile` and the :option:`--prefix` "

"argument to the :program:`configure` script at build time. The value is "

"available to Python code as ``sys.prefix``. It is only useful on Unix. See "

"also the next function."

msgstr ""

#: ../../c-api/init.rst:529

msgid ""

"Return the *exec-prefix* for installed platform-*dependent* files. This is "

"derived through a number of complicated rules from the program name set "

"with :c:func:`Py_SetProgramName` and some environment variables; for "

"example, if the program name is ``'/usr/local/bin/python'``, the exec-prefix "

"is ``'/usr/local'``. The returned string points into static storage; the "

"caller should not modify its value. This corresponds to the :makevar:"

"`exec_prefix` variable in the top-level :file:`Makefile` and the ``--exec-"

"prefix`` argument to the :program:`configure` script at build time. The "

"value is available to Python code as ``sys.exec_prefix``. It is only useful "

"on Unix."

msgstr ""

#: ../../c-api/init.rst:539

msgid ""

"Background: The exec-prefix differs from the prefix when platform dependent "

"files (such as executables and shared libraries) are installed in a "

"different directory tree. In a typical installation, platform dependent "

"files may be installed in the :file:`/usr/local/plat` subtree while platform "

"independent may be installed in :file:`/usr/local`."

msgstr ""

#: ../../c-api/init.rst:545

msgid ""

"Generally speaking, a platform is a combination of hardware and software "

"families, e.g. Sparc machines running the Solaris 2.x operating system are "

"considered the same platform, but Intel machines running Solaris 2.x are "

"another platform, and Intel machines running Linux are yet another "

"platform. Different major revisions of the same operating system generally "

"also form different platforms. Non-Unix operating systems are a different "

"story; the installation strategies on those systems are so different that "

"the prefix and exec-prefix are meaningless, and set to the empty string. "

"Note that compiled Python bytecode files are platform independent (but not "

"independent from the Python version by which they were compiled!)."

msgstr ""

#: ../../c-api/init.rst:556

msgid ""

"System administrators will know how to configure the :program:`mount` or :"

"program:`automount` programs to share :file:`/usr/local` between platforms "

"while having :file:`/usr/local/plat` be a different filesystem for each "

"platform."

msgstr ""

#: ../../c-api/init.rst:574

msgid ""

"Return the full program name of the Python executable; this is computed as "

"a side-effect of deriving the default module search path from the program "

"name (set by :c:func:`Py_SetProgramName` above). The returned string points "

"into static storage; the caller should not modify its value. The value is "

"available to Python code as ``sys.executable``."

msgstr ""

#: ../../c-api/init.rst:594

msgid ""

"Return the default module search path; this is computed from the program "

"name (set by :c:func:`Py_SetProgramName` above) and some environment "

"variables. The returned string consists of a series of directory names "

"separated by a platform dependent delimiter character. The delimiter "

"character is ``':'`` on Unix and macOS, ``';'`` on Windows. The returned "

"string points into static storage; the caller should not modify its value. "

"The list :data:`sys.path` is initialized with this value on interpreter "

"startup; it can be (and usually is) modified later to change the search path "

"for loading modules."

msgstr ""

#: ../../c-api/init.rst:620

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"module_search_paths` and :c:member:`PyConfig.module_search_paths_set` should "

"be used instead, see :ref:`Python Initialization Configuration <init-"

"config>`."

msgstr ""

#: ../../c-api/init.rst:625

msgid ""

"Set the default module search path. If this function is called before :c:"

"func:`Py_Initialize`, then :c:func:`Py_GetPath` won't attempt to compute a "

"default search path but uses the one provided instead. This is useful if "

"Python is embedded by an application that has full knowledge of the location "

"of all modules. The path components should be separated by the platform "

"dependent delimiter character, which is ``':'`` on Unix and macOS, ``';'`` "

"on Windows."

msgstr ""

#: ../../c-api/init.rst:633

msgid ""

"This also causes :data:`sys.executable` to be set to the program full path "

"(see :c:func:`Py_GetProgramFullPath`) and for :data:`sys.prefix` and :data:"

"`sys.exec_prefix` to be empty. It is up to the caller to modify these if "

"required after calling :c:func:`Py_Initialize`."

msgstr ""

#: ../../c-api/init.rst:638 ../../c-api/init.rst:753 ../../c-api/init.rst:789

#: ../../c-api/init.rst:815

msgid ""

"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a :c:expr:"

"`wchar_*` string."

msgstr ""

#: ../../c-api/init.rst:641

msgid ""

"The path argument is copied internally, so the caller may free it after the "

"call completes."

msgstr ""

#: ../../c-api/init.rst:644

msgid ""

"The program full path is now used for :data:`sys.executable`, instead of the "

"program name."

msgstr ""

#: ../../c-api/init.rst:653

msgid ""

"Return the version of this Python interpreter. This is a string that looks "

"something like ::"

msgstr ""

#: ../../c-api/init.rst:660

msgid ""

"The first word (up to the first space character) is the current Python "

"version; the first characters are the major and minor version separated by a "

"period. The returned string points into static storage; the caller should "

"not modify its value. The value is available to Python code as :data:`sys."

"version`."

msgstr ""

#: ../../c-api/init.rst:665

msgid "See also the :c:var:`Py_Version` constant."

msgstr ""

#: ../../c-api/init.rst:672

msgid ""

"Return the platform identifier for the current platform. On Unix, this is "

"formed from the \"official\" name of the operating system, converted to "

"lower case, followed by the major revision number; e.g., for Solaris 2.x, "

"which is also known as SunOS 5.x, the value is ``'sunos5'``. On macOS, it "

"is ``'darwin'``. On Windows, it is ``'win'``. The returned string points "

"into static storage; the caller should not modify its value. The value is "

"available to Python code as ``sys.platform``."

msgstr ""

#: ../../c-api/init.rst:683

msgid ""

"Return the official copyright string for the current Python version, for "

"example"

msgstr ""

#: ../../c-api/init.rst:685

msgid "``'Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam'``"

msgstr "``'Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam'``"

#: ../../c-api/init.rst:689

msgid ""

"The returned string points into static storage; the caller should not modify "

"its value. The value is available to Python code as ``sys.copyright``."

msgstr ""

#: ../../c-api/init.rst:695

msgid ""

"Return an indication of the compiler used to build the current Python "

"version, in square brackets, for example::"

msgstr ""

#: ../../c-api/init.rst:702 ../../c-api/init.rst:716

msgid ""

"The returned string points into static storage; the caller should not modify "

"its value. The value is available to Python code as part of the variable "

"``sys.version``."

msgstr ""

#: ../../c-api/init.rst:709

msgid ""

"Return information about the sequence number and build date and time of the "

"current Python interpreter instance, for example ::"

msgstr ""

#: ../../c-api/init.rst:728

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"argv`, :c:member:`PyConfig.parse_argv` and :c:member:`PyConfig.safe_path` "

"should be used instead, see :ref:`Python Initialization Configuration <init-"

"config>`."

msgstr ""

#: ../../c-api/init.rst:733

msgid ""

"Set :data:`sys.argv` based on *argc* and *argv*. These parameters are "

"similar to those passed to the program's :c:func:`main` function with the "

"difference that the first entry should refer to the script file to be "

"executed rather than the executable hosting the Python interpreter. If "

"there isn't a script that will be run, the first entry in *argv* can be an "

"empty string. If this function fails to initialize :data:`sys.argv`, a "

"fatal condition is signalled using :c:func:`Py_FatalError`."

msgstr ""

#: ../../c-api/init.rst:741

msgid ""

"If *updatepath* is zero, this is all the function does. If *updatepath* is "

"non-zero, the function also modifies :data:`sys.path` according to the "

"following algorithm:"

msgstr ""

#: ../../c-api/init.rst:745

msgid ""

"If the name of an existing script is passed in ``argv[0]``, the absolute "

"path of the directory where the script is located is prepended to :data:`sys."

"path`."

msgstr ""

#: ../../c-api/init.rst:748

msgid ""

"Otherwise (that is, if *argc* is ``0`` or ``argv[0]`` doesn't point to an "

"existing file name), an empty string is prepended to :data:`sys.path`, which "

"is the same as prepending the current working directory (``\".\"``)."

msgstr ""

#: ../../c-api/init.rst:756 ../../c-api/init.rst:792

msgid ""

"See also :c:member:`PyConfig.orig_argv` and :c:member:`PyConfig.argv` "

"members of the :ref:`Python Initialization Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:760

msgid ""

"It is recommended that applications embedding the Python interpreter for "

"purposes other than executing a single script pass ``0`` as *updatepath*, "

"and update :data:`sys.path` themselves if desired. See `CVE-2008-5983 "

"<https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-5983>`_."

msgstr ""

#: ../../c-api/init.rst:765

msgid ""

"On versions before 3.1.3, you can achieve the same effect by manually "

"popping the first :data:`sys.path` element after having called :c:func:"

"`PySys_SetArgv`, for example using::"

msgstr ""

#: ../../c-api/init.rst:781

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"argv` and :c:member:`PyConfig.parse_argv` should be used instead, see :ref:"

"`Python Initialization Configuration <init-config>`."

msgstr ""

#: ../../c-api/init.rst:785

msgid ""

"This function works like :c:func:`PySys_SetArgvEx` with *updatepath* set to "

"``1`` unless the :program:`python` interpreter was started with the :option:"

"`-I`."

msgstr ""

#: ../../c-api/init.rst:795

msgid "The *updatepath* value depends on :option:`-I`."

msgstr ""

#: ../../c-api/init.rst:802

msgid ""

"This API is kept for backward compatibility: setting :c:member:`PyConfig."

"home` should be used instead, see :ref:`Python Initialization Configuration "

"<init-config>`."

msgstr ""

#: ../../c-api/init.rst:806

msgid ""

"Set the default \"home\" directory, that is, the location of the standard "

"Python libraries. See :envvar:`PYTHONHOME` for the meaning of the argument "

"string."

msgstr ""

#: ../../c-api/init.rst:810

msgid ""

"The argument should point to a zero-terminated character string in static "

"storage whose contents will not change for the duration of the program's "

"execution. No code in the Python interpreter will change the contents of "

"this storage."

msgstr ""