# Genişletme/Ekleme SSS

## C’de kendi fonksiyonlarımı oluşturabilir miyim?

Evet, C’de fonksiyonlar, değişkenler, istisnalar ve hatta yeni tipler içeren yerleşik modüller oluşturabilirsiniz. Bu konu Python Yorumlayıcısını Genişletme ve Gömme dosyasında açıklanmıştır.

Çoğu orta veya ileri seviye Python kitabı da bu konuyu ele alacaktır.

## C++’da kendi fonksiyonlarımı oluşturabilir miyim?

Evet, C++’da bulunan C uyumluluk özelliklerini kullanarak. `extern "C" { ... }` komutunu Python include dosyalarının etrafına yerleştirin ve Python yorumlayıcısı tarafından çağrılacak her fonksiyonun önüne `extern "C"` koyun. Yapıcıları olan global veya statik C++ nesneleri muhtemelen iyi bir fikir değildir.

## C yazmak zor; başka alternatifler var mı?

There are a number of alternatives to writing your own C extensions, depending on what you’re trying to do. Recommended third party tools offer both simpler and more sophisticated approaches to creating C and C++ extensions for Python.

## C’den rastgele Python komutlarını nasıl çalıştırabilirim?

Bunu yapan en üst düzey fonksiyon `PyRun_SimpleString()` olup, `__main__` modülü bağlamında çalıştırılmak üzere tek bir string argüman alır ve başarı için `0`, bir istisna oluştuğunda (`SyntaxError` dahil) `-1` döndürür. Daha fazla kontrol istiyorsanız, `PyRun_String()` kullanın; `PyRun_SimpleString()` için `Python/pythonrun.c` içindeki kaynağa bakın.

## C’den rastgele Python komutlarını nasıl değerlendirebilirim?

Önceki sorudaki `PyRun_String()` fonksiyonunu `Py_eval_input` başlangıç sembolü ile çağırın; bu fonksiyon bir ifadeyi ayrıştırır, değerlendirir ve değerini döndürür.

## Bir Python nesnesinden C değerlerini nasıl çıkarabilirim?

That depends on the object’s type. If it’s a tuple, `PyTuple_Size()` returns its length and `PyTuple_GetItem()` returns the item at a specified index. Lists have similar functions, `PyList_Size()` and `PyList_GetItem()`.

For bytes, `PyBytes_Size()` returns its length and `PyBytes_AsStringAndSize()` provides a pointer to its value and its length. Note that Python bytes objects may contain null bytes so C’s `strlen()` should not be used.

Bir nesnenin türünü test etmek için, önce `NULL` olmadığından emin olun ve ardından `PyBytes_Check()`, `PyTuple_Check()`, `PyList_Check()` vb. kullanın.

Ayrıca Python nesneleri için ‘abstract’ arayüzü tarafından sağlanan üst düzey bir API de vardır – daha fazla ayrıntı için `Include/abstract.h` dosyasını okuyun. `PySequence_Length()`, `PySequence_GetItem()`, vb. gibi çağrıları kullanarak her türlü Python dizisi ile arayüz oluşturmanın yanı sıra sayılar (`PyNumber_Index()` ve diğerleri) ve PyMapping API’lerindeki eşlemeler gibi diğer birçok yararlı protokolü de sağlar.

## İsteğe bağlı uzunlukta bir tuple oluşturmak için Py_BuildValue() işlevini nasıl kullanabilirim?

Bunu yapamazsınız. Bunun yerine `PyTuple_Pack()` kullanın.

## C’de bir nesnenin metodunu nasıl çağırabilirim?

`PyObject_CallMethod()` fonksiyonu, bir nesnenin rastgele bir metodunu çağırmak için kullanılabilir. Parametreler nesne, çağrılacak yöntemin adı, `Py_BuildValue()` ile kullanılan gibi bir string ve değişken değerleridir:

    PyObject *
    PyObject_CallMethod(PyObject *object, const char *method_name,
                        const char *arg_format, ...);

Bu, ister yerleşik ister kullanıcı tanımlı olsun, yöntemleri olan herhangi bir nesne için geçerlidir. Sonunda dönüş değerini :`Py_DECREF()`‘lemekten siz sorumlusunuz.

Örneğin, bir dosya nesnesinin “seek” yöntemini 10, 0 argümanlarıyla çağırmak için (dosya nesnesi işaretçisinin “f” olduğunu varsayarak):

    res = PyObject_CallMethod(f, "seek", "(ii)", 10, 0);
    if (res == NULL) {
            ... an exception occurred ...
    }
    else {
            Py_DECREF(res);
    }

`PyObject_CallObject()` her zaman argüman listesi için bir tuple istediğinden, argümansız bir fonksiyon çağırmak için format olarak “()” ve tek argümanlı bir fonksiyon çağırmak için argümanı parantez içine alın, örneğin “(i)”.

## PyErr_Print() işlevinden (veya stdout/stderr’e yazdıran herhangi bir şeyden) gelen çıktıyı nasıl yakalayabilirim?

Python kodunda, `write()` metodunu destekleyen bir nesne tanımlayın. Bu nesneyi `sys.stdout` ve `sys.stderr` öğelerine atayın. Print_error’ı çağırın ya da sadece standart geri izleme mekanizmasının çalışmasına izin verin. Ardından, çıktı `write()` yönteminizin gönderdiği yere gidecektir.

Bunu yapmanın en kolay yolu `io.StringIO` sınıfını kullanmaktır:

    >>> import io, sys
    >>> sys.stdout = io.StringIO()
    >>> print('foo')
    >>> print('hello world!')
    >>> sys.stderr.write(sys.stdout.getvalue())
    foo
    hello world!

Aynı şeyi yapan özel bir nesne şöyle görünecektir:

    >>> import io, sys
    >>> class StdoutCatcher(io.TextIOBase):
    ...     def __init__(self):
    ...         self.data = []
    ...     def write(self, stuff):
    ...         self.data.append(stuff)
    ...
    >>> import sys
    >>> sys.stdout = StdoutCatcher()
    >>> print('foo')
    >>> print('hello world!')
    >>> sys.stderr.write(''.join(sys.stdout.data))
    foo
    hello world!

## Python’da yazılmış bir modüle C’den nasıl erişebilirim?

Modül nesnesine aşağıdaki gibi bir işaretçi alabilirsiniz:

    module = PyImport_ImportModule("<modulename>");

Modül henüz içe aktarılmamışsa (yani `sys.modules` içinde henüz mevcut değilse), bu modülü başlatır; aksi takdirde sadece `sys.modules["<modulename>"]` değerini döndürür. Modülü herhangi bir isim alanına girmediğine dikkat edin – sadece başlatıldığından ve `sys.modules` içinde saklandığından emin olur.

Daha sonra modülün özniteliklerine (yani modülde tanımlanan herhangi bir isme) aşağıdaki şekilde erişebilirsiniz:

    attr = PyObject_GetAttrString(module, "<attrname>");

Modüldeki değişkenlere atamak için `PyObject_SetAttrString()` çağrısı da çalışır.

## Python’dan C++ nesnelerine nasıl arayüz oluşturabilirim?

Gereksinimlerinize bağlı olarak, birçok yaklaşım vardır. Bunu manuel olarak yapmak için the “Extending and Embedding” belgesini okuyarak başlayın. Python çalışma zamanı sistemi için, C ve C++ arasında çok fazla fark olmadığının farkına varın – bu nedenle bir C yapı (işaretçi) türü etrafında yeni bir Python türü oluşturma stratejisi C++ nesneleri için de işe yarayacaktır.

C++ kütüphaneleri için bakınız C yazmak zor; başka alternatifler var mı?.

## Kurulum dosyasını kullanarak bir modül ekledim ve derleme başarısız oldu; neden?

Kurulum bir satır sonu ile bitmelidir, eğer satır sonu yoksa derleme işlemi başarısız olur. (Bunu düzeltmek için biraz biçimsiz shell script düzenlemesi gerekir ve bu hata o kadar küçük ki çabaya değmez gibi görünüyor)

## Bir uzantıda nasıl hata ayıklayabilirim?

Dinamik olarak yüklenen uzantılarla GDB kullanırken, uzantınız yüklenene kadar uzantınızda bir kesme noktası ayarlayamazsınız.

`.gdbinit` dosyanıza (veya etkileşimli olarak) şu komutu ekleyin:

    br _PyImport_LoadDynamicModule

Sonra, GDB’yi çalıştırdığınızda:

    $ gdb /local/bin/python
    gdb) run myscript.py
    gdb) continue # repeat until your extension is loaded
    gdb) finish   # so that your extension is loaded
    gdb) br myfunction.c:50
    gdb) continue

## Linux sistemimde bir Python modülü derlemek istiyorum, ancak bazı dosyalar eksik. Neden?

Most packaged versions of Python omit some files required for compiling Python extensions.

For Red Hat, install the python3-devel RPM to get the necessary files.

For Debian, run `apt-get install python3-dev`.

## “Eksik girdi” ile “geçersiz girdi’yi nasıl ayırt edebilirim?

Bazen Python etkileşimli yorumlayıcısının davranışını taklit etmek istersiniz; girdi eksik olduğunda size bir devam istemi verir (örneğin, bir “if” deyiminin başlangıcını yazdınız veya parantezlerinizi veya üçlü dize tırnaklarınızı kapatmadınız), ancak girdi geçersiz olduğunda size hemen bir sözdizimi hata mesajı verir.

Python’da, ayrıştırıcının davranışına yeterince yaklaşan `codeop` modülünü kullanabilirsiniz. Örneğin IDLE bunu kullanır.

Bunu C’de yapmanın en kolay yolu `PyRun_InteractiveLoop()` çağırmak (belki ayrı bir iş parçacığında) ve Python yorumlayıcısının girdiyi sizin için işlemesine izin vermektir. Ayrıca `PyOS_ReadlineFunctionPointer()` ‘ı özel girdi fonksiyonunuza işaret edecek şekilde ayarlayabilirsiniz. Daha fazla ipucu için `Modules/readline.c` ve `Parser/myreadline.c` dosyalarına bakın.

## Tanımlanmamış g++ sembolleri __builtin_new veya __pure_virtual’ı nasıl bulabilirim?

G++ uzantı modüllerini dinamik olarak yüklemek için Python’u yeniden derlemeli, g++ kullanarak yeniden bağlamalı (Python Modules Makefile’da LINKCC’yi değiştirin) ve uzantı modülünüzü g++ kullanarak bağlamalısınız (örneğin, `g++ -shared -o mymodule.so mymodule.o`).

## Bazı yöntemleri C’de, bazı yöntemleri Python’da (örneğin miras yoluyla) uygulanan bir nesne sınıfı oluşturabilir miyim?

Evet, `int`, `list`, `dict`, vb. gibi yerleşik sınıflardan miras alabilirsiniz.

Boost Python Kütüphanesi (BPL, http://www.boost.org/libs/python/doc/index.html) bunu C++’dan yapmanın bir yolunu sağlar (yani BPL’yi kullanarak C++’da yazılmış bir uzantı sınıfından miras alabilirsiniz).