참고: 이 자습서의 코드 예제는 를 사용하여 실제로 작동하는지 확인합니다. 일부 코드 예제는 리눅스, 윈도우 또는 맥 OS X에서 다르게 동작하므로, 주석에 doctest 지시문이 포함되어 있습니다.

　　참고: 일부 코드 예제는 ctypes 형을 참조합니다. 인 플랫폼에서, 이는 의 별칭입니다. 따라서 를 기대할 때 가 인쇄되더라도 혼란스러워하지 않아도 됩니다 — 이것들은 실제로 같은 형입니다.

　　는 동적 링크 라이브러리 로드를 위해 cdll을, 그리고 윈도우에서는 windll 및 oledll 객체를, 全球排名第一오피스타노출합니다.

　　이 객체의 어트리뷰트를 액세스하여 라이브러리를 로드합니다. cdll은 표준 호출 규칙을 사용하는 함수를 내보내는 라이브러리를 로드하는 반면, windll 라이브러리는 호출 규칙을 사용하여 함수를 호출합니다. oledll 또한 호출 규칙을 사용하고, 함수가 윈도우 에러 코드를 반환한다고 가정합니다. 에러 코드는 함수 호출이 실패할 때 예외를 자동으로 발생시키는 데 사용됩니다.

　　다음은 윈도우 용 예제입니다. 는 대부분 표준 C 함수가세계랭킹1위오피스타 포함된 MS 표준 C 라이브러리며, cdecl 호출 규칙을 사용합니다:

　　윈도우는 일반적인 파일 접미사를 자동으로 추가합니다.

　　리눅스에서, 라이브러리를 로드하기 위해서는 확장자를 포함하는 파일명을 지정해야 하므로, 어트리뷰트 액세스를 사용하여 라이브러리를 로드 할 수 없습니다. dll 로더의 메서드를 사용하거나 CDLL의 생성자를 호출하여 인스턴스를 만들어 라이브러리를 로드해야 합니다:

　　함수는 dll 객체의 어트리뷰트로 액세스 됩니다:

　　와 와 같은 win32 시스템 dll은 종종 ANSI뿐만 아니라 UNICODE 버전의 함수를 내보냅니다. UNICODE 버전은 이름에 가 추가된 상태로 내보내지고, ANSI 버전은 이름에 가 추가되어 내보내 집니다. 지정된 모듈 이름의 모듈 핸들을 반환하는 win32 함수는, 다음과 같은 C 프로토타입을 가지며, UNICODE가 정의되어 있는지에 따라 그중 하나를 로 노출하기 위해 매크로가 사용됩니다:

　　windll는 마술적으로 이 중 하나를 선택하려고 하지 않으므로, 나 를 명시적으로 지정하여 필요한 버전에 액세스해야 하고, 그런 다음 각각 바이트열이나 문자열 객체로 호출해야 합니다.

　　때때로, dll은 와 같은 유효한 파이썬 식별자가 아닌 이름으로 함수를 내보냅니다. 이때는 를 사용하여 함수를 조회해야 합니다:

　　윈도우에서, 일부 dll은 이름이 아니라 서수(ordinal)로 함수를 내보냅니다. 이 함수는 서수로 dll 객체를 인덱싱하여 액세스할 수 있습니다:

　　다른 파이썬 콜러블처럼 이 함수를 호출할 수 있습니다. 이 예제에서는 시스템 시간을 유닉스 에포크부터의 초로 반환하는 함수와 win32 모듈 핸들을 반환하는 함수를 사용합니다.

　　이 예는 포인터로 두 함수를 호출합니다 (을 포인터로 사용해야 합니다):

　　호출 규칙을 사용하여 함수를 호출하면 가 발생하고, 그 반대도 마찬가지입니다:

　　올바른 호출 규칙을 찾으려면 C 헤더 파일이나 호출할 함수에 대한 설명서를 살펴봐야 합니다.

　　윈도우에서, 는 함수가 유효하지 않은 인자 값을 사용하여 호출될 때, 일반적인 보호 오류로 인한 충돌을 방지하기 위해 win32 구조적 예외 처리를 사용합니다:

　　그러나, 로 파이썬을 충돌시킬 방법이 많으므로, 어쨌든 주의해야 합니다. 모듈은 충돌을 디버깅하는 데 도움이 될 수 있습니다 (예를 들어, 오류가 있는 C 라이브러리 호출로 인한 세그먼트 오류).

　　, 정수, 바이트열 객체 및 (유니코드) 문자열은 이러한 함수 호출에서 매개 변수로 직접 사용할 수 있는 유일한 파이썬 자체의 객체입니다. 는 C 포인터로 전달되고, 바이트열 객체와 문자열은 데이터가 저장된 메모리 블록에 대한 포인터로 전달됩니다 ( 이나 ). 파이썬 정수는 플랫폼의 기본 C 형으로 전달되며, 그 값은 C 형에 맞게 마스크 됩니다.

　　다른 매개 변수 형으로 함수를 호출하기 전에, 데이터형에 대해 더 알아야 합니다.

　　는 많은 기본적인 C 호환 데이터형을 정의합니다.:

　　이 모든 형은 올바른 형과 값의 선택적 초기화자로 호출해서 만들어질 수 있습니다:

　　이러한 형은 가변이므로, 값을 나중에 변경할 수도 있습니다:

　　, 및 포인터형의 인스턴스에 새 값을 대입하면 포인터가 가리키는 메모리 위치가 변경됩니다, 메모리 블록의 내용이 아닙니다 (당연히 아닙니다, 파이썬 바이트열 객체는 불변입니다):

　　그러나, 이것들을 가변 메모리에 대한 포인터를 예상하는 함수에 전달하지 않도록 주의해야 합니다. 가변 메모리 블록이 필요하다면, ctypes에는 다양한 방법으로 이를 만드는 함수가 있습니다. 현재 메모리 블록 내용은 프로퍼티를 사용하여 액세스(또는 변경)할 수 있습니다; NUL 종료 문자열로 액세스하려면 프로퍼티를 사용하십시오:

　　함수는 이전 ctypes 배포에 있는 함수뿐만 아니라 함수(아직 별칭으로 사용할 수 있습니다)를 대체합니다. C 형 의 유니코드 문자를 포함하는 가변 메모리 블록을 생성하려면 함수를 사용하십시오.

　　printf는 이 아니라 실제 표준 출력으로 인쇄하므로, 이 예제는 콘솔 프롬프트에서만 작동하고 IDLE 이나 PythonWin에서는 작동하지 않음에 유의하십시오:

　　이전에 언급했듯이, 정수, 문자열 및 바이트열 객체를 제외한 모든 파이썬 형은 필요한 C 데이터형으로 변환될 수 있도록 해당하는 형으로 래핑 되어야 합니다:

　　또한 인자 변환을 사용자 정의하여 사용자 고유 클래스의 인스턴스를 함수 인자로 사용할 수 있습니다. 는 어트리뷰트를 찾고, 이를 함수 인자로 사용합니다. 물론 정수, 문자열 또는 바이트열 중 하나여야 합니다:

　　인스턴스 변수에 인스턴스의 데이터를 저장하지 않으려면, 를 정의하여 요청 시 어트리뷰트를 사용할 수 있게 할 수 있습니다.

　　어트리뷰트를 설정하여 DLL에서 내보낸 함수의 필수 인자 형을 지정할 수 있습니다.

　　는 C 데이터형의 시퀀스 여야 합니다 ( 함수는 포맷 문자열에 따라 개수와 형이 다른 매개 변수를 받아들이기 때문에, 여기서는 좋은 예가 아닐 수 있습니다. 반면에 이 기능을 실험하기에 매우 편리하기도 합니다):

　　포맷을 지정하면 호환되지 않는 인자 형으로부터 보호하고(C 함수의 프로토타입처럼), 유효한 형으로 인자를 변환하려고 시도합니다:

　　함수 호출에 전달하는 여러분 자신의 클래스를 정의했으면, 시퀀스에서 해당 클래스를 사용할 수 있도록, 클래스 메서드를 全球排名第一오피스타구현해야 합니다. 클래스 메서드는 함수 호출에 전달된 파이썬 객체를 받습니다. 형 검사나 이 객체가 수용 가능한지 확인하는 데 필요한 모든 작업을 수행한 다음, 객체 자체나 어트리뷰트나 무엇이건 이 경우에 C 함수 인자로 전달되길 원하는 것을 반환해야 합니다. 다시 말하지만, 결과는 정수, 문자열, 바이트열, 인스턴스 또는 어트리뷰트가 있는 객체여야 합니다.

　　기본적으로 함수는 C 형을 반환한다고 가정합니다. 다른 반환형은 함수 객체의 어트리뷰트를 설정하여 지정할 수 있습니다.

　　다음은 더 고급 예제입니다. 함수를 사용하는데, 문자열 포인터와 char을 기대하고, 문자열에 대한 포인터를 반환합니다:

　　위의 호출을 피하려면, 어트리뷰트를 설정할 수 있으며, 두 번째 인자는 한 글자 파이썬 바이트열 객체에서 C char로 변환됩니다:

　　외부 함수가 정수를 반환하면, 콜러블 파이썬 객체(예를 들어, 함수나 클래스)를 어트리뷰트로 사용할 수도 있습니다. 콜러블은 C 함수가 돌려주는 정수로 호출되며, 이 호출의 결과는 함수 호출의 결과로 사용됩니다. 이것은 에러 반환 값을 검사하고 자동으로 예외를 발생시키는 데 유용합니다:

　　는 윈도우 api를 호출하여 에러 코드의 문자열 표현을 가져오고, 예외를 반환하는 함수입니다. 는 선택적 에러 코드 매개 변수를 취합니다, 제공하지 않으면 를 호출하여 에러 코드를 가져옵니다.

　　훨씬 더 강력한 에러 검사 메커니즘을 어트리뷰트를 통해 사용할 수 있음에 유의하십시오; 자세한 내용은 레퍼런스 설명서를 참조하십시오.

　　때때로 C api 함수는 매개 변수로 데이터형을 가리키는 포인터를 기대합니다, 아마도 해당 위치에 쓰기 위해서, 또는 데이터가 너무 커서 값으로 전달할 수 없어서. 이것은 참조로 매개 변수 전달하기로 알려져 있기도 합니다.

　　는 매개 변수를 참조로 전달하는 데 사용되는 함수를 내보냅니다. 같은 효과를 함수로도 얻을 수 있습니다. 하지만 는 실제 포인터 객체를 생성하기 때문에 더 많은 작업을 수행하므로, 파이썬 자체에서 포인터 객체가 필요하지 않으면 를 사용하는 것이 더 빠릅니다.:

　　구조체와 공용체는 모듈에 정의된 와 베이스 클래스에서 파생되어야 합니다. 각 서브 클래스는 어트리뷰트를 정의해야 합니다. 는 필드 이름 과 필드형을 포함하는 2 세계랭킹1위오피스타-튜플의 리스트여야 합니다.

　　필드형은 와 같은 형이거나 다른 파생된 형(구조체, 공용체, 배열, 포인터)이어야 합니다.

　　다음은 x 및 y라는 두 개의 정수가 포함된 POINT 구조체의 간단한 예제이며, 생성자에서 구조체를 초기화하는 방법도 보여줍니다:

　　그러나, 훨씬 복잡한 구조를 만들 수 있습니다. 구조체는 필드형으로 구조체를 사용하여 다른 구조체를 포함할 수 있습니다.

　　다음은 upperleft 및 lowerright라는 두 개의 POINT를 포함하는 RECT 구조체입니다:

　　중첩된 구조체는 여러 가지 방법으로 생성자에서 초기화할 수 있습니다:

　　필드 는 클래스에서 조회할 수 있습니다. 유용한 정보를 제공할 수 있으므로 디버깅에 유용합니다:

　　기본적으로, Structure와 Union 필드는 C 컴파일러와 같은 방식으로 정렬됩니다. 서브 클래스 정의에서 클래스 어트리뷰트를 지정하면, 이 동작을 재정의할 수 있습니다. 이 값은 양의 정수로 설정해야 하고, 필드의 최대 정렬을 지정합니다. 이것은 MSVC에서 가 수행하는 것입니다.

　　는 구조체와 공용체에 기본(native) 바이트 순서를 사용합니다. 기본이 아닌 바이트 순서로 구조체를 만들려면 , , 및 베이스 클래스 중 하나를 사용할 수 있습니다. 이러한 클래스들은 포인터 필드를 포함할 수 없습니다.

　　비트 필드를 포함하는 구조체와 공용체를 만드는 것이 가능합니다. 비트 필드는 정수 필드에만 가능하며, 비트 폭은 튜플의 세 번째 항목으로 지정됩니다:

　　배열은 같은 형의 고정 된 수의 인스턴스를 포함하는 시퀀스입니다.

　　배열형을 만드는 데 권장되는 방법은 데이터형에 양의 정수를 곱하는 것입니다:

　　다음은 다소 인공적인 데이터형의 예입니다. 다른 항목들과 함께 4개의 POINT를 포함하는 구조체입니다:

　　인스턴스는 클래스를 호출하는 일반적인 방법으로 만들어집니다:

　　위 코드는 배열 내용이 0으로 초기화되기 때문에, 일련의 줄을 인쇄합니다.

　　올바른 형의 초기화자를 지정할 수도 있습니다:

　　포인터 인스턴스는 형에 함수를 호출해서 만듭니다:

　　포인터 인스턴스는 포인터가 가리키는 객체(위에서는 객체)를 반환하는 어트리뷰트를 가집니다:

　　에는 OOR(원래 객체 반환, original object return)이 없다는 것에 유의하십시오. 어트리뷰트를 가져올 때마다 (동등하지만) 새로운 객체를 만듭니다:

　　다른 인스턴스를 포인터의 contents 어트리뷰트에 대입하면 포인터는 이 인스턴스가 저장되어있는 메모리 위치를 가리키게 됩니다:

　　포인터 인스턴스는 정수로도 인덱싱할 수 있습니다.:

　　정수 인덱스에 대입하면 가리키고 있는 값이 바뀝니다:

　　0이 아닌 인덱스를 사용할 수도 있지만, C에서와 마찬가지로 자신이 하는 일을 알아야 합니다: 임의의 메모리 위치를 액세스하거나 변경할 수 있습니다. 일반적으로 C 함수에서 포인터를 받고, 포인터가 실제로 단일 항목 대신 배열을 가리키는 것을 알 때만 이 기능을 사용합니다.

　　장막 뒤에서, 함수는 단순히 포인터 인스턴스를 만드는 것 이상을 수행합니다. 먼저 포인터 형을 만들어야 합니다. 이것은 임의의 형을 받아들이고, 새로운 형을 반환하는 함수로 수행됩니다:

　　인자 없이 포인터형을 호출하면 포인터가 만들어집니다. 포인터는 논릿값을 갖습니다:

　　는 포인터를 역참조(dereference)할 때 인지 확인합니다 (하지만 이 아닌 잘못된 포인터를 역참조하면 파이썬을 충돌시킵니다):

　　일반적으로, ctypes는 엄격한 형 검사를 수행합니다. 이는 함수의 목록에 가 있거나, 구조체 멤버 필드의 형이 그런 형이라면, 정확히 같은 형의 인스턴스만 허용됨을 뜻합니다. 이 규칙에는 ctypes가 다른 객체를 허용하는 몇 가지 예외가 있습니다. 예를 들어, 포인터형 대신 호환 가능한 배열 인스턴스를 전달할 수 있습니다. 따라서 의 경우, ctype은 c_int 배열을 허용합니다:

　　또한, 함수 인자가 에 포인터형(가령 )으로 명시적으로 선언되면, 대상형(이 경우 )의 객체를 함수에 전달할 수 있습니다. 이때 ctypes는 필요한 변환을 자동으로 적용합니다.

　　POINTER 형 필드를 로 설정하려면, 을 대입할 수 있습니다:

　　때에 따라 호환되지 않는 형의 인스턴스가 있을 수 있습니다. C에서는, 한 형을 다른 형으로 강제 변환(cast)할 수 있습니다. 는 같은 방식으로 사용할 수 있는 함수를 제공합니다. 위에 정의된 구조체는 필드에 대해 포인터나 배열을 받아들이지만 다른 형의 인스턴스는 허용하지 않습니다:

　　이럴 때, 함수가 편리합니다.

　　함수는 ctypes 인스턴스를 다른 ctypes 데이터형에 대한 포인터로 변환하는 데 사용할 수 있습니다. 는 두 개의 매개 변수, 어떤 종류의 포인터로 변환될 수 있는 ctypes 객체와 ctypes 포인터형을 받아들입니다. 첫 번째 인자와 같은 메모리 블록을 참조하는 두 번째 인자의 인스턴스를 반환합니다:

　　따라서, 는 구조체의 필드에 대입하는 데 사용할 수 있습니다:

　　불완전한 형은 멤버가 아직 지정되지 않은 구조체, 공용체 또는 배열입니다. C에서, 이것들은 나중에 정의되는 전방 선언(forward declaration)으로 지정됩니다:

　　ctypes 코드로 그대로 옮기면 이렇게 되지만, 작동하지는 않습니다:

　　새 은 클래스 문 자체에서 사용할 수 없기 때문입니다. 에서는, 클래스를 정의한 다음, class 문 뒤에서 어트리뷰트를 설정할 수 있습니다:

　　해 봅시다. 우리는 두 개의 인스턴스를 만들고, 서로를 가리키도록 한 다음, 마지막으로 포인터 체인을 몇 번 따라갑니다:

　　는 파이썬 콜러블로부터 C에서 호출 가능한 함수 포인터를 만들 수 있습니다. 이들은 때로 콜백 함수(callback functions)라고 불립니다.

　　먼저, 콜백 함수를 위한 클래스를 만들어야 합니다. 클래스는 호출 규칙, 반환형 및 이 함수가 받는 인자의 수와 형을 알고 있습니다.

　　팩토리 함수는 호출 규칙을 사용하여 콜백 함수의 형을 만듭니다. 윈도우에서, 팩토리 함수는 호출 규칙을 사용하여 콜백 함수 형을 만듭니다.

　　이러한 팩토리 함수는 모두 첫 번째 인자로 결과 형을, 나머지 인자로 콜백 함수가 기대하는 인자 형들로 호출됩니다.

　　콜백 함수의 도움을 받아 항목을 정렬하는 데 사용되는 표준 C 라이브러리의 함수를 사용하는 예제를 제시합니다. 는 정수 배열을 정렬하는 데 사용될 것입니다:

　　는 정렬 할 데이터에 대한 포인터, 데이터 배열의 항목 수, 항목 하나의 크기 및 비교 함수에 대한 포인터인 콜백으로 호출해야 합니다세계 랭킹 1 위오피스타공식 홈페이지는 무엇입니까?. 콜백은 항목에 대한 두 개의 포인터로 호출되며, 첫 번째 항목이 두 번째 항목보다 작으면 음의 정수를, 같으면 0을, 그렇지 않으면 양수 정수를 반환해야 합니다.

　　따라서 콜백 함수는 정수에 대한 포인터들을 받고 정수를 반환해야 합니다. 먼저 콜백 함수를 위한 을 만듭니다:

　　시작하기 위해, 전달된 값을 보여주는 간단한 콜백이 있습니다:

　　결과:

　　이제 실제로 두 항목을 비교하여 유용한 결과를 반환할 수 있습니다:

　　쉽게 확인할 수 있듯이, 배열은 이제 정렬되었습니다:

　　함수 팩토리는 데코레이터 팩토리로 사용할 수 있으므로, 다음과 같이 작성할 수도 있습니다:

　　일부 공유 라이브러리는 함수를 내보낼 뿐만 아니라 변수도 내보냅니다. 파이썬 라이브러리 자체에 있는 예는 인데, 시작 시 주어진 나 플래그에 따라, 0, 1 또는 2로 설정된 정수입니다.

　　는 형의 클래스 메서드를 사용하여 이와 같은 값을 액세스할 수 있습니다. pythonapi는 파이썬 C API에 대한 액세스를 제공하는 미리 정의된 심볼입니다:

　　인터프리터가 로 시작되면, 예는 를, 가 지정되면 를 인쇄합니다.

　　포인터의 사용법도 보여주는 확장 예제는 파이썬이 내 보낸 포인터에 액세스합니다.

　　해당 값에 대한 문서를 인용하면:

　　이 포인터는 멤버가 모두 이나 0인 것으로 끝나는 레코드 배열을 가리키도록 초기화됩니다. 프로즌 모듈이 임포트될 때, 이 테이블에서 검색됩니다. 제삼자 코드는 동적으로 만들어진 프로즌 모듈의 컬렉션을 제공하기 위해 이것을 조작할 수 있습니다.

　　따라서, 이 포인터를 조작하는 것이 유용할 수도 있습니다. 예제 크기를 제한하기 위해, 로 이 테이블을 읽는 방법만 보여줍니다:

　　데이터형을 정의했으므로, 테이블에 대한 포인터를 얻을 수 있습니다:

　　이 레코드의 배열에 대한 이므로, 이터레이션할 수 있습니다. 하지만 포인터는 크기가 없으므로 루프를 종료하는 방법이 필요합니다. 조만간 액세스 위반 등으로 인해 충돌이 발생할 수 있으므로, 엔트리가 발견되자마자 루프에서 벗어나는 것이 좋습니다:

　　표준 파이썬이 프로즌 모듈과 프로즌 패키지(음수 멤버로 표시됨)를 가지고 있다는 사실은 잘 알려지지 않았으며, 테스트용으로만 사용됩니다. 예를 들어 를 시도해보십시오.

　　에는 여러분이 기대하는 것과 실제로 일어나는 것이 다른 가장자리가 있습니다.

　　다음 예제를 고려해보십시오:

　　흠. 아마도 마지막 문장이 를 인쇄할 것으로 기대했을 겁니다. 어떻게 된 걸까요? 위의 줄의 단계는 다음과 같습니다:

　　과 은 여전히 위의 객체의 내부 버퍼를 사용하는 객체입니다. 따라서 를 실행하면 의 버퍼 내용이 의 버퍼로 복사됩니다. 이것은, 결과적으로 의 내용을 변경합니다. 따라서 마지막 대입인 은 기대하는 효과를 주지 못합니다.

　　Structure, Union 및 Array에서 서브 객체를 가져오는 것은 서브 객체를 복사하지 않고, 대신 루트 객체의 하부 버퍼에 액세스하는 래퍼 객체를 가져온다는 점에 유의하십시오.

　　예상과 다른 행동을 하는 또 다른 예는 다음과 같습니다:

　　를 인쇄하는 이유는 무엇일까요? ctypes 인스턴스는 메모리 블록과 메모리 내용에 액세스하는 어떤 를 포함하는 객체입니다. 메모리 블록에 파이썬 객체를 저장하면 객체 자체를 저장하지 않고, 대신 객체의 을 저장합니다. 내용에 다시 액세스하면 매번 새로운 파이썬 객체가 생성됩니다!

　　는 가변 크기 배열과 구조체에 대한 일부 지원을 제공합니다.

　　함수는 기존 ctypes 객체의 메모리 버퍼 크기를 바꾸는 데 사용할 수 있습니다. 이 함수는 객체를 첫 번째 인자로 가져오고, 바이트 단위의 요청 된 크기를 두 번째 인자로 가져옵니다. 메모리 블록을 객체 형이 지정하는 원래 메모리 블록보다 작게 만들 수 없습니다. 시도하면 가 발생합니다:

　　훌륭합니다, 하지만 이 배열에 포함된 추가 요소에 어떻게 액세스할 수 있습니까? 형은 여전히 4개의 요소만 알고 있으므로, 다른 요소에 액세스하면 에러가 발생합니다:

　　에서 가변 크기 데이터형을 사용하는 또 다른 방법은, 파이썬의 동적 특성을 사용하고 필요한 크기가 이미 알려진 후 매번 데이터형을 (재) 정의하는 것입니다.