파이썬 초기화 구성¶

PyInitConfig C API¶

Added in version 3.14.

파이썬은 :c:func:`Py_InitializeFromInitConfig`를 사용하여 초기화할 수 있습니다.

Py_RunMain() 함수는 사용자 정의 Python 프로그램을 작성하는 데 사용될 수 있습니다.

초기화, 파이널리제이션 및 스레드도 참조하십시오.

PEP 741 “Python Configuration C API”.

예시¶

Python Development Mode <devmode>`가 활성화된 상태에서 항상 실행되는 사용자 맞춤형 파이썬의 예; 오류 시 `-1``을 반환합니다:

int init_python(void)
{
    PyInitConfig *config = PyInitConfig_Create();
    if (config == NULL) {
        printf("PYTHON INIT ERROR: 메모리 할당 실패\n");
        return -1;
    }

    // Python 개발자 모드 활성화
    if (PyInitConfig_SetInt(config, "dev_mode", 1) < 0) {
        goto error;
    }

    // 구성으로 파이썬 초기화
    if (Py_InitializeFromInitConfig(config) < 0) {
        goto error;
    }
    PyInitConfig_Free(config);
    return 0;

error:
    {
        // 에러 메시지 출력.
        //
        // 이 흔치 않은 중괄호 스타일은 goto 대상이 변수 선언을 가리킬 수 없기 때문에 사용됩니다.
        const char *err_msg;
        (void)PyInitConfig_GetError(config, &err_msg);
        printf("PYTHON INIT ERROR: %s\n", err_msg);
        PyInitConfig_Free(config);
        return -1;
    }
}

구성 생성¶

struct PyInitConfig¶: 파이썬 초기화를 구성하기 위한 불투명 구조체입니다.

PyInitConfig *PyInitConfig_Create(void)¶

Isolated Configuration 기본값을 사용하여 새로운 초기화 구성을 생성합니다.

이것은 :c:func:`PyInitConfig_Free`에 의해 해제되어야 합니다.

메모리 할당 실패 시 NULL 을 반환합니다.

void PyInitConfig_Free(PyInitConfig *config)¶

초기화 구성 config 의 메모리를 해제합니다.

config 가 NULL 인 경우 아무 작업도 수행되지 않습니다.

에러 처리¶

int PyInitConfig_GetError(PyInitConfig *config, const char **err_msg)¶

config 의 에러 메시지를 가져옵니다.

Set *err_msg and return 1 if an error is set.
Set *err_msg to NULL and return 0 otherwise.

에러 메시지는 UTF-8 인코딩된 문자열입니다.

만약 config 에 종료 코드가 있으면, 종료 코드를 에러 메시지 형태로 포맷합니다.

오류 메시지는 다른 PyInitConfig 함수와 config 함께 호출될 때까지 유효합니다. 호출자는 오류 메시지를 해제할 필요가 없습니다.

int PyInitConfig_GetExitCode(PyInitConfig *config, int *exitcode)¶

config 의 종료 코드를 가져옵니다.

Set *exitcode and return 1 if config has an exit code set.
config 에 종료 코드가 설정되어 있지 않으면 0 을 반환합니다.

Py_InitializeFromInitConfig() 함수는 parse_argv 옵션이 0이 아닌 경우에만 종료 코드를 설정할 수 있습니다.

명령줄 구문 분석 실패(종료 코드 2) 또는 명령줄 옵션에서 명령어 도움말 표시를 요청한 경우(종료 코드 0)에 종료 코드를 설정할 수 있습니다.

옵션 가져오기¶

구성 옵션 name 매개 변수는 NULL이 아닌 null 종단 UTF-8 인코딩된 문자열이어야 합니다. :ref:`Configuration Options <pyinitconfig-opts>`를 참조하십시오.

int PyInitConfig_HasOption(PyInitConfig *config, const char *name)¶

구성 필드에 name 이라는 옵션이 있는지 테스트합니다.

옵션이 존재하면 1 을 반환하고, 그렇지 않으면 0 을 반환합니다.

int PyInitConfig_GetInt(PyInitConfig *config, const char *name, int64_t *value)¶

정수 구성 옵션을 가져옵니다.

*value 를 설정하고 성공하면 0 을 반환합니다.
config 에 오류를 설정하고 오류가 발생하면 -1 을 반환합니다.

int PyInitConfig_GetStr(PyInitConfig *config, const char *name, char **value)¶

널 종단 UTF-8 인코딩된 문자열 형태로 문자열 구성 옵션을 가져옵니다.

*value 를 설정하고 성공하면 0 을 반환합니다.
config 에 오류를 설정하고 오류가 발생하면 -1 을 반환합니다.

옵션이 선택적 문자열이고 해당 옵션이 설정되지 않은 경우, value 는 NULL 로 설정될 수 있습니다.

성공적으로 반환된 경우, string은 NULL 이 아니면 free(value) 를 사용하여 해제해야 합니다.

int PyInitConfig_GetStrList(PyInitConfig *config, const char *name, size_t *length, char ***items)¶

널 종단 UTF-8 인코딩된 문자열 배열 형태로 문자열 리스트 구성 옵션을 가져옵니다.

*length 와 *value 를 설정하고 성공하면 0 을 반환합니다.
config 에 오류를 설정하고 오류가 발생하면 -1 을 반환합니다.

성공적으로 반환된 경우, 문자열 리스트는 `PyInitConfig_FreeStrList(length, items)`로 해제해야 합니다.

void PyInitConfig_FreeStrList(size_t length, char **items)¶: `PyInitConfig_GetStrList()`에 의해 생성된 문자열 리스트의 메모리를 해제합니다.

옵션 설정¶

구성 옵션 name 매개 변수는 NULL이 아닌 null 종단 UTF-8 인코딩된 문자열이어야 합니다. :ref:`Configuration Options <pyinitconfig-opts>`를 참조하십시오.

일부 구성 옵션은 다른 옵션에 부수 효과를 가집니다. 이 로직은 Py_InitializeFromInitConfig() 가 호출될 때만 구현되며, 아래의 “Set” 함수로는 설정되지 않습니다. 예를 들어, dev_mode 를 1 로 설정해도 faulthandler 는 1 로 설정되지 않습니다.

int PyInitConfig_SetInt(PyInitConfig *config, const char *name, int64_t value)¶

정수 구성 옵션을 설정합니다.

성공하면 0 을 반환합니다.
config 에 오류를 설정하고 오류가 발생하면 -1 을 반환합니다.

int PyInitConfig_SetStr(PyInitConfig *config, const char *name, const char *value)¶

널 종단 UTF-8 인코딩된 문자열로부터 문자열 구성 옵션을 설정합니다. 문자열은 복사됩니다.

성공하면 0 을 반환합니다.
config 에 오류를 설정하고 오류가 발생하면 -1 을 반환합니다.

int PyInitConfig_SetStrList(PyInitConfig *config, const char *name, size_t length, char *const *items)¶

널 종단 UTF-8 인코딩된 문자열 배열로부터 문자열 리스트 구성 옵션을 설정합니다. 문자열 리스트는 복사됩니다.

성공하면 0 을 반환합니다.
config 에 오류를 설정하고 오류가 발생하면 -1 을 반환합니다.

모듈¶

int PyInitConfig_AddModule(PyInitConfig *config, const char *name, PyObject *(*initfunc)(void))¶

빌트인 확장 모듈을 빌트인 모듈 테이블에 추가합니다.

새로운 모듈은 name 이라는 이름으로 가져올 수 있으며, 첫 번째 시도된 import 호출 시 초기화 함수로 initfunc 를 사용합니다.

성공하면 0 을 반환합니다.
config 에 오류를 설정하고 오류가 발생하면 -1 을 반환합니다.

Python이 여러 번 초기화되는 경우, PyInitConfig_AddModule() 을 각 Python 초기화마다 호출해야 합니다.

PyImport_AppendInittab() 함수와 유사합니다.

Python 초기화¶

int Py_InitializeFromInitConfig(PyInitConfig *config)¶

초기화 구성으로부터 Python을 초기화합니다.

성공하면 0 을 반환합니다.
config 에 오류를 설정하고 오류가 발생하면 -1 을 반환합니다.
config 에 종료 코드를 설정하고, Python이 종료하려는 경우 -1 을 반환합니다.

종료 코드 사례는 PyInitConfig_GetExitcode() 를 참조하십시오.

구성 옵션¶

옵션	PyConfig/PyPreConfig 멤버	타입	가시성
`"allocator"`	`allocator`	`int`	읽기 전용
`"argv"`	`argv`	`list[str]`	공개
`"base_exec_prefix"`	`base_exec_prefix`	`str`	공개
`"base_executable"`	`base_executable`	`str`	공개
`"base_prefix"`	`base_prefix`	`str`	공개
`"buffered_stdio"`	`buffered_stdio`	`bool`	읽기 전용
`"bytes_warning"`	`bytes_warning`	`int`	공개
`"check_hash_pycs_mode"`	`check_hash_pycs_mode`	`str`	읽기 전용
`"code_debug_ranges"`	`코드 디버그 범위`	`bool`	읽기 전용
`"coerce_c_locale"`	`로케일 변환`	`bool`	읽기 전용
`"coerce_c_locale_warn"`	`로케일 변환 경고`	`bool`	읽기 전용
`"configure_c_stdio"`	`stdio 설정`	`bool`	읽기 전용
`"configure_locale"`	`로케일 설정`	`bool`	읽기 전용
`"cpu_count"`	`CPU 코어 개수`	`int`	공개
`"dev_mode"`	`개발 모드`	`bool`	읽기 전용
`"dump_refs"`	`참조 덤프`	`bool`	읽기 전용
`"dump_refs_file"`	`참조 파일 덤프`	`str`	읽기 전용
`"exec_prefix"`	`실행 접두사`	`str`	공개
`"executable"`	`실행 파일`	`str`	공개
`"faulthandler"`	`faulthandler`	`bool`	읽기 전용
`"filesystem_encoding"`	`파일 시스템 인코딩`	`str`	읽기 전용
`"filesystem_errors"`	`파일 시스템 오류 처리`	`str`	읽기 전용
`"hash_seed"`	`해시 시드`	`int`	읽기 전용
`"home"`	`홈 디렉터리`	`str`	읽기 전용
`"import_time"`	`임포트 시간`	`int`	읽기 전용
`"inspect"`	`검사기`	`bool`	공개
`"install_signal_handlers"`	`시그널 핸들러 설치`	`bool`	읽기 전용
`"int_max_str_digits"`	`최대 문자열 자릿수`	`int`	공개
`"interactive"`	`상호작용 모드`	`bool`	공개
`"isolated"`	`격리된 환경`	`bool`	읽기 전용
`"legacy_windows_fs_encoding"`	`레거시 Windows FS 인코딩`	`bool`	읽기 전용
`"legacy_windows_stdio"`	`레거시 Windows stdio`	`bool`	읽기 전용
`"malloc_stats"`	`malloc 통계`	`bool`	읽기 전용
`"module_search_paths"`	`모듈 검색 경로`	`list[str]`	공개
`"optimization_level"`	`최적화 수준`	`int`	공개
`"orig_argv"`	`원본 인자 목록`	`list[str]`	읽기 전용
`"parse_argv"`	`인자 구문 분석`	`bool`	읽기 전용
`"parser_debug"`	`파서 디버그`	`bool`	공개
`"pathconfig_warnings"`	`경로 설정 경고`	`bool`	읽기 전용
`"perf_profiling"`	`성능 프로파일링`	`bool`	읽기 전용
`"platlibdir"`	`플랫폼 라이브러리 디렉터리`	`str`	공개
`"prefix"`	`접두사`	`str`	공개
`"program_name"`	`프로그램 이름`	`str`	읽기 전용
`"pycache_prefix"`	`파이캐시 접두사`	`str`	공개
`"quiet"`	`조용히 실행/무음`	`bool`	공개
`"run_command"`	`실행 명령`	`str`	읽기 전용
`"run_filename"`	`실행 파일명`	`str`	읽기 전용
`"run_module"`	`실행 모듈`	`str`	읽기 전용
`"run_presite"`	`사전 사이트 실행`	`str`	읽기 전용
`"safe_path"`	`안전 경로`	`bool`	읽기 전용
`"show_ref_count"`	`참조 횟수 표시`	`bool`	읽기 전용
`"site_import"`	`사이트 임포트`	`bool`	읽기 전용
`"skip_source_first_line"`	`소스 코드 첫 줄 건너뛰기`	`bool`	읽기 전용
`"stdio_encoding"`	`stdio 인코딩`	`str`	읽기 전용
`"stdio_errors"`	`stdio 오류 처리`	`str`	읽기 전용
`"stdlib_dir"`	`표준 라이브러리 디렉터리`	`str`	공개
`"tracemalloc"`	`tracemalloc`	`int`	읽기 전용
`"use_environment"`	`환경 사용`	`bool`	공개
`"use_frozen_modules"`	:c:member:`use_frozen_modules <PyConfig.use_frozen_modules>`를 사용합니다.	`bool`	읽기 전용
`"use_hash_seed"`	`use_hash_seed`	`bool`	읽기 전용
`"use_system_logger"`	`use_system_logger`	`bool`	읽기 전용
`"user_site_directory"`	`user_site_directory`	`bool`	읽기 전용
`"utf8_mode"`	`utf8_mode`	`bool`	읽기 전용
`"verbose"`	`verbose`	`int`	공개
`"warn_default_encoding"`	`warn_default_encoding`	`bool`	읽기 전용
`"warnoptions"`	`warnoptions`	`list[str]`	공개
`"write_bytecode"`	`write_bytecode`	`bool`	공개
`"xoptions"`	`xoptions`	`dict[str, str]`	공개
`"_pystats"`	`_pystats`	`bool`	읽기 전용

가시성:

Public: :c:func:`PyConfig_Get`를 통해 가져오거나, :c:func:`PyConfig_Set`으로 설정할 수 있습니다.
Read-only: :c:func:`PyConfig_Get`로 가져올 수는 있으나, :c:func:`PyConfig_Set`으로는 설정할 수 없습니다.

실행 시간 파이썬 구성 API¶

런타임 시에는 PyConfig_Get() 및 PyConfig_Set() 함수를 사용하여 구성 옵션을 가져오고 설정할 수 있습니다.

구성 옵션 name 매개 변수는 NULL이 아닌 null 종단 UTF-8 인코딩된 문자열이어야 합니다. :ref:`Configuration Options <pyinitconfig-opts>`를 참조하십시오.

일부 옵션은 sys 속성으로부터 읽어옵니다. 예를 들어, “argv” 옵션은 :data:`sys.argv`에서 읽어옵니다.

PyObject *PyConfig_Get(const char *name)¶

구성 옵션의 현재 런타임 값을 파이썬 객체로 가져옵니다.

성공 시 새 참조를 반환합니다.
오류 발생 시 예외를 설정하고 NULL 을 반환합니다.

객체 유형은 구성 옵션에 따라 다릅니다. 다음과 같습니다:

bool
int
str
list[str]
dict[str, str]

호출하는 쪽은 :term:`attached thread state`가 필요합니다. 이 함수는 파이썬 초기화 전이나 파이썬 최종화 후에 호출될 수 없습니다.

Added in version 3.14.

int PyConfig_GetInt(const char *name, int *value)¶

:c:func:`PyConfig_Get`과 유사하지만, C int로 값을 가져옵니다.

성공하면 0 을 반환합니다.
오류 발생 시 예외를 설정하고 -1 을 반환합니다.

Added in version 3.14.

PyObject *PyConfig_Names(void)¶

모든 구성 옵션 이름을 frozenset 형태로 가져옵니다.

성공 시 새 참조를 반환합니다.
오류 발생 시 예외를 설정하고 NULL 을 반환합니다.

호출하는 쪽은 :term:`attached thread state`가 필요합니다. 이 함수는 파이썬 초기화 전이나 파이썬 최종화 후에 호출될 수 없습니다.

Added in version 3.14.

int PyConfig_Set(const char *name, PyObject *value)¶

구성 옵션의 현재 런타임 값을 설정합니다.

선택한 오퍼레이터 name 이 존재하지 않으면 ValueError 를 발생시킵니다.
value 가 유효한 값이 아니면 ValueError 를 발생시킵니다.
옵션이 읽기 전용이면 (설정할 수 없으면) :exc:`ValueError`를 발생시킵니다.
value 가 적절한 타입이 아니면 TypeError 를 발생시킵니다.

호출하는 쪽은 :term:`attached thread state`가 필요합니다. 이 함수는 파이썬 초기화 전이나 파이썬 최종화 후에 호출될 수 없습니다.

인자 name, value 와 함께 auditing event cpython.PyConfig_Set 을 발생시킵니다.

Added in version 3.14.

PyConfig C API¶

Added in version 3.8.

파이썬은 Py_InitializeFromConfig() 와 PyConfig 구조체를 사용하여 초기화할 수 있습니다. 또한, Py_PreInitialize() 및 PyPreConfig 구조체로 미리 초기화할 수 있습니다.

다음 두 종류의 구성이 있습니다:

:ref:`Python Configuration <init-python-config>`은 일반 파이썬처럼 동작하는 맞춤화된 파이썬을 구축하는 데 사용할 수 있습니다. 예를 들어, 환경 변수 및 명령줄 인자가 파이썬을 구성하는 데 사용됩니다.
:ref:`Isolated Configuration <init-isolated-conf>`은 파이썬을 애플리케이션에 임베드(embed)할 때 사용할 수 있습니다. 이는 시스템으로부터 파이썬을 격리합니다. 예를 들어, 환경 변수는 무시되고, LC_CTYPE 로케일은 변경되지 않으며, 시그널 핸들러는 등록되지 않습니다.

Py_RunMain() 함수는 사용자 정의 Python 프로그램을 작성하는 데 사용될 수 있습니다.

초기화, 파이널리제이션 및 스레드도 참조하십시오.

PEP 587 “파이썬 초기화 구성”.

예시¶

항상 격리 모드에서 실행되는 사용자 정의 파이썬의 예:

int main(int argc, char **argv)
{
    PyStatus status;

    PyConfig config;
    PyConfig_InitPythonConfig(&config);
    config.isolated = 1;

    /* Decode command line arguments.
       Implicitly preinitialize Python (in isolated mode). */
    status = PyConfig_SetBytesArgv(&config, argc, argv);
    if (PyStatus_Exception(status)) {
        goto exception;
    }

    status = Py_InitializeFromConfig(&config);
    if (PyStatus_Exception(status)) {
        goto exception;
    }
    PyConfig_Clear(&config);

    return Py_RunMain();

exception:
    PyConfig_Clear(&config);
    if (PyStatus_IsExit(status)) {
        return status.exitcode;
    }
    /* Display the error message and exit the process with
       non-zero exit code */
    Py_ExitStatusException(status);
}

PyWideStringList¶

type PyWideStringList¶

wchar_t* 문자열의 리스트.

length가 0이 아니면, items는 NULL이 아니어야 하고 모든 문자열은 NULL이 아니어야 합니다.

메서드:

PyStatus PyWideStringList_Append(PyWideStringList *list, const wchar_t *item)¶

item을 list에 추가합니다.

이 함수를 호출하려면 파이썬을 사전 초기화해야 합니다.

PyStatus PyWideStringList_Insert(PyWideStringList *list, Py_ssize_t index, const wchar_t *item)¶

item을 list의 index에 삽입합니다.

index가 list 길이보다 크거나 같으면, item을 list에 추가(append)합니다.

index 는 0 보다 크거나 같아야 합니다.

이 함수를 호출하려면 파이썬을 사전 초기화해야 합니다.

구조체 필드:

Py_ssize_t length¶: 리스트 길이.

wchar_t **items¶: 리스트 항목들.

PyStatus¶

type PyStatus¶

초기화 함수 상태를 저장하는 구조체: 성공, 에러 또는 종료.

에러의 경우, 에러를 만든 C 함수 이름을 저장할 수 있습니다.

구조체 필드:

int exitcode¶: 종료 코드. exit()에 전달된 인자.

const char *err_msg¶: 에러 메시지.

const char *func¶: 에러를 만든 함수의 이름, NULL일 수 있습니다.

상태를 만드는 함수:

PyStatus PyStatus_Ok(void)¶: 성공.

PyStatus PyStatus_Error(const char *err_msg)¶

메시지가 포함된 초기화 에러.

err_msg 는 NULL 이 아니어야 합니다.

PyStatus PyStatus_NoMemory(void)¶: 메모리 할당 실패 (메모리 부족).

PyStatus PyStatus_Exit(int exitcode)¶: 지정된 종료 코드로 파이썬을 종료합니다.

상태를 처리하는 함수:

int PyStatus_Exception(PyStatus status)¶: 상태가 에러입니까? 아니면 종료입니까? 참이면, 예외를 처리해야 합니다; 예를 들어 Py_ExitStatusException() 을 호출하여.

int PyStatus_IsError(PyStatus status)¶: 결과가 에러입니까?

int PyStatus_IsExit(PyStatus status)¶: 결과가 종료입니까?

void Py_ExitStatusException(PyStatus status)¶: status가 종료이면 exit(exitcode)를 호출합니다. status가 에러이면 에러 메시지를 인쇄하고 0이 아닌 종료 코드로 종료합니다. PyStatus_Exception(status)가 0이 아닐 때만 호출해야 합니다.

참고

내부적으로, 파이썬은 PyStatus.func를 설정하는 데는 매크로를 사용하는 반면, func가 NULL로 설정된 상태를 만드는 데는 함수를 사용합니다.

예:

PyStatus alloc(void **ptr, size_t size)
{
    *ptr = PyMem_RawMalloc(size);
    if (*ptr == NULL) {
        return PyStatus_NoMemory();
    }
    return PyStatus_Ok();
}

int main(int argc, char **argv)
{
    void *ptr;
    PyStatus status = alloc(&ptr, 16);
    if (PyStatus_Exception(status)) {
        Py_ExitStatusException(status);
    }
    PyMem_Free(ptr);
    return 0;
}

PyPreConfig¶

type PyPreConfig¶

파이썬을 미리 초기화하는 데 사용되는 구조체입니다.

사전 구성을 초기화하는 함수:

void PyPreConfig_InitPythonConfig(PyPreConfig *preconfig)¶: 파이썬 구성으로 사전 구성을 초기화합니다.

void PyPreConfig_InitIsolatedConfig(PyPreConfig *preconfig)¶: 격리된 구성으로 사전 구성을 초기화합니다.

구조체 필드:

int allocator¶

파이썬 메모리 할당자의 이름:

PYMEM_ALLOCATOR_NOT_SET (0): 메모리 할당자를 변경하지 않습니다 (기본값을 사용합니다).
PYMEM_ALLOCATOR_DEFAULT (1): default memory allocators.
PYMEM_ALLOCATOR_DEBUG (2): :ref:`default memory allocators <default-memory-allocators>`에 :ref:`debug hooks <pymem-debug-hooks>`를 추가합니다.
PYMEM_ALLOCATOR_MALLOC (3): C 라이브러리의 malloc() 을 사용합니다.
PYMEM_ALLOCATOR_MALLOC_DEBUG (4): debug hooks 사용 시 디버그 훅 <pymem-debug-hooks>을 강제합니다.
PYMEM_ALLOCATOR_PYMALLOC (5): :ref:`Python pymalloc 메모리 할당자 <pymalloc>`입니다.
PYMEM_ALLOCATOR_PYMALLOC_DEBUG (6): :ref:`Python pymalloc 메모리 할당자 <pymalloc>`에 :ref:`디버그 훅 <pymem-debug-hooks>`을 포함합니다.
PYMEM_ALLOCATOR_MIMALLOC (6): 빠르고 성능이 좋은 `mimalloc`을 사용합니다.
PYMEM_ALLOCATOR_MIMALLOC_DEBUG (7): :ref:`디버그 훅 <pymem-debug-hooks>`이 있는 빠르고 성능이 좋은 `mimalloc`을 사용합니다.

PYMEM_ALLOCATOR_PYMALLOC and PYMEM_ALLOCATOR_PYMALLOC_DEBUG are not supported if Python is configured using --without-pymalloc.

PYMEM_ALLOCATOR_MIMALLOC and PYMEM_ALLOCATOR_MIMALLOC_DEBUG are not supported if Python is configured using --without-mimalloc or if the underlying atomic support isn’t available.

메모리 관리를 참조하십시오.

기본값: PYMEM_ALLOCATOR_NOT_SET 입니다.

int configure_locale¶

LC_CTYPE 로케일을 사용자 선호 로케일로 설정합니다.

If equals to 0, set coerce_c_locale and coerce_c_locale_warn members to 0.

:term:`로케일 인코딩 <locale encoding>`을 참조하세요.

기본값: Python 구성에서 1, 격리된 구성에서 0 입니다.

int coerce_c_locale¶

값이 2 인 경우, C 로케일을 강제합니다.

값이 1 인 경우, LC_CTYPE 로케일을 읽어 강제해야 하는지 결정합니다.

:term:`로케일 인코딩 <locale encoding>`을 참조하세요.

기본값: Python 구성에서 -1, 격리된 구성에서 0 입니다.

int coerce_c_locale_warn¶

0이 아니면, C 로케일이 강제될 때 경고가 발생합니다.

기본값: Python 구성에서 -1, 격리된 구성에서 0 입니다.

int dev_mode¶

Python 개발 모드: :c:member:`PyConfig.dev_mode`를 참조하세요.

기본값: Python 모드에서 -1, 격리된 모드에서 0 입니다.

int isolated¶

격리 모드: :c:member:`PyConfig.isolated`를 참조하세요.

기본값: Python 모드에서 0, 격리된 모드에서 1 입니다.

int legacy_windows_fs_encoding¶

0이 아닌 경우:

PyPreConfig.utf8_mode 를 0 으로 설정합니다.
PyConfig.filesystem_encoding 을 "mbcs" 로 설정합니다.
PyConfig.filesystem_errors 를 "replace" 로 설정합니다.

PYTHONLEGACYWINDOWSFSENCODING 환경 변수 값을 통해 초기화되었습니다.

윈도우에서만 사용 가능합니다. #ifdef MS_WINDOWS 매크로는 윈도우 특정 코드에 사용할 수 있습니다.

기본값: 0 입니다.

int parse_argv¶

0이 아니면, Py_PreInitializeFromArgs()와 Py_PreInitializeFromBytesArgs()는 일반 파이썬이 명령 줄 인자를 구문 분석하는 것과 같은 방식으로 argv 인자를 구문 분석합니다. 명령 줄 인자를 참조하십시오.

기본값: Python 구성에서 1, 격리된 구성에서 0 입니다.

int use_environment¶

:ref:`환경 변수 <using-on-envvars>`를 사용하겠습니까? :c:member:`PyConfig.use_environment`를 참조하세요.

기본값: Python 구성에서 1, 격리된 구성에서 0 입니다.

int utf8_mode¶

0이 아닌 경우 :ref:`Python UTF-8 모드 <utf8-mode>`를 활성화합니다.

-X utf8 명령줄 옵션과 PYTHONUTF8 환경 변수에 의해 0 또는 1 로 설정됩니다.

기본값: 1 입니다.

PyPreConfig을 사용하여 Python을 사전 초기화합니다.¶

Python의 사전 초기화:

Python 메모리 할당자 설정 (PyPreConfig.allocator)
Configure the LC_CTYPE locale (locale encoding)
Python UTF-8 모드 (PyPreConfig.utf8_mode)를 설정합니다.

현재 사전 구성 (PyPreConfig 타입)은 _PyRuntime.preconfig 에 저장됩니다.

파이썬을 사전 초기화하는 함수:

PyStatus Py_PreInitialize(const PyPreConfig *preconfig)¶

preconfig 사전 구성에서 파이썬을 사전 초기화합니다.

preconfig 는 NULL 이 아니어야 합니다.

PyStatus Py_PreInitializeFromBytesArgs(const PyPreConfig *preconfig, int argc, char *const *argv)¶

preconfig 사전 구성에서 파이썬을 사전 초기화합니다.

:c:member:`~PyPreConfig.parse_argv`가 0이 아닌 경우 preconfig*의 *argv 명령줄 인자(바이트 문자열)를 구문 분석합니다.

preconfig 는 NULL 이 아니어야 합니다.

PyStatus Py_PreInitializeFromArgs(const PyPreConfig *preconfig, int argc, wchar_t *const *argv)¶

preconfig 사전 구성에서 파이썬을 사전 초기화합니다.

:c:member:`~PyPreConfig.parse_argv`가 0이 아닌 경우 preconfig*의 *argv 명령줄 인자(와이드 문자열)를 구문 분석합니다.

preconfig 는 NULL 이 아니어야 합니다.

호출자는 PyStatus_Exception()과 Py_ExitStatusException() 을 사용하여 예외(에러나 종료)를 처리해야 합니다.

Python 초기화 구성 (PyPreConfig_InitPythonConfig())의 경우, Python이 명령줄 인자와 함께 초기화되면, 해당 인자들은 인코딩과 같이 사전 구성에 영향을 미치므로 preinitialize Python으로 전달되어야 합니다. 예를 들어, -X utf8 명령줄 옵션은 :ref:`Python UTF-8 모드 <utf8-mode>`를 활성화합니다.

PyMem_SetAllocator()는 Py_PreInitialize() 이후에 Py_InitializeFromConfig() 이전에 호출하여 사용자 정의 메모리 할당자를 설치할 수 있습니다. PyPreConfig.allocator가 PYMEM_ALLOCATOR_NOT_SET으로 설정되면 Py_PreInitialize() 전에 호출할 수 있습니다.

PyMem_RawMalloc() 와 같은 Python 메모리 할당 함수는 Python 사전 초기화 이전에 사용해서는 안 되며, malloc() 및 free() 를 직접 호출하는 것은 항상 안전합니다. Py_DecodeLocale() 은 Python 사전 초기화 전에 호출되어서는 안 됩니다.

:ref:`Python UTF-8 모드 <utf8-mode>`를 활성화하는 사전 초기화 예시:

PyStatus status;
PyPreConfig preconfig;
PyPreConfig_InitPythonConfig(&preconfig);

preconfig.utf8_mode = 1;

status = Py_PreInitialize(&preconfig);
if (PyStatus_Exception(status)) {
    Py_ExitStatusException(status);
}

/* 이 시점에서 파이썬은 UTF-8을 사용하여 통신합니다 */

Py_Initialize();
/* ... 여기서 Python API를 사용 ... */
Py_Finalize();

PyConfig¶

type PyConfig¶

파이썬을 구성하기 위한 대부분의 파라미터를 포함하는 구조체.

완료되면, 구성 메모리를 해제하기 위해 PyConfig_Clear() 함수를 사용해야 합니다.

구조체 메서드:

void PyConfig_InitPythonConfig(PyConfig *config)¶: :ref:`Python Configuration <init-python-config>`으로 구성을 초기화합니다.

void PyConfig_InitIsolatedConfig(PyConfig *config)¶: :ref:`Isolated Configuration <init-isolated-conf>`으로 구성을 초기화합니다.

PyStatus PyConfig_SetString(PyConfig *config, wchar_t *const *config_str, const wchar_t *str)¶

와이드 문자열 str을 *config_str로 복사합니다.