**Sarmalayıcı kütüphaneler** (veya kütüphane sarmalayıcıları; İngilizce: **wrapper library** veya **library wrappers**), bir kütüphanenin mevcut arayüzünü uyumlu bir arayüze çeviren ince bir kod katmanından (bir "dolgu" İngilizce: shim) oluşur. Bu, çeşitli nedenlerle yapılır:

* Kötü tasarlanmış veya karmaşık bir arayüzü iyileştirmek için
* Aksi takdirde birlikte çalışamayacak kodların birlikte çalışmasına izin vermek (örneğin uyumsuz veri biçimleri)
* Dil ve/veya çalıştırma ortamı (runtime) arası birlikte çalışabilirliği etkinleştirmek için

Sarmalayıcı kütüphaneler adaptör, faça ve daha az ölçüde vekil tasarım desenleri kullanılarak uygulanabilir.

Yapı ve uygulama
----------------

Bir sarmalayıcı kütüphanenin uygulanma şekli, yazıldığı ortama ve ele almayı amaçladığı senaryolara bağlı olarak oldukça özeldir. Bu durum özellikle çapraz dil/çalışma zamanı birlikte çalışabilirliği söz konusu olduğunda geçerlidir.

### Örnek

Aşağıda yaygın bir sarmalayıcı kütüphane uygulamasının genel bir örneği verilmektedir. Bu örnekte, bir C++ arayüzü, bir C dili arayüzü etrafında bir "sarmalayıcı" görevi görür.

#### C arayüzü

```
int pthread\_mutex\_init(pthread\_mutex\_t \* mutex , pthread\_mutexattr\_t \* attr);
int pthread\_mutex\_destroy (pthread\_mutex\_t \* mutex);
int pthread\_mutex\_lock (pthread\_mutex\_t \* mutex );
int pthread\_mutex\_unlock (pthread\_mutex\_t \* mutex );

```

#### C++ sarmalayıcı

```
class Mutex
{
 pthread\_mutex\_t mutex;

public:
 Mutex() 
 {
 pthread\_mutex\_init(&mutex, 0);
 }

 ~Mutex()
 {
 pthread\_mutex\_destroy(&mutex);
 }

private:
 friend class Lock;

 void lock()
 {
 pthread\_mutex\_lock(&mutex);
 }

 void unlock()
 {
 pthread\_mutex\_unlock(&mutex);
 }
};

class Lock
{
private:
 Mutex &mutex;

public:
 Lock(Mutex &mutex): mutex{mutex}
 {
 mutex.lock();
 }

 ~Lock()
 {
 mutex.unlock();
 }
};

```

Orijinal C arayüzü, özellikle kütüphane kullanıcılarının zaten kilitli olan bir muteksin kilidini açmayı unutması durumunda hataya açık olarak kabul edilebilir. Yeni arayüz, Mutex'lerin sonunda kilidinin açılmasını ve pthread\_mutex\_t nesnelerinin otomatik olarak serbest bırakılmasını sağlamak için yeni Mutex ve Lock sınıflarında RAII (Resource Acquisition is Initialization) özelliğini etkin bir şekilde kullanır.

Yukarıdaki kod, boost::thread kütüphanesinin bir parçası olan boost::scoped\_lock ve boost::mutex uygulamalarını yakından taklit eder.

### Sürücü sarmalayıcıları

Daha fazla bilgi: Sürücü sarmalayıcı

Çapraz dil/çalışma zamanı birlikte çalışabilirliği
--------------------------------------------------

Bazı sarmalayıcı kütüphaneler, bir istemci uygulaması ile uyumsuz bir teknoloji kullanılarak yazılmış bir kütüphane arasında köprü görevi görmek için vardır. Örneğin, bir Java uygulamasının bir sistem çağrısı çalıştırması gerekebilir. Ancak sistem çağrıları genellikle C kütüphanesi işlevleri olarak gösterilir. Bu sorunu çözmek için Java, bu sistem çağrılarını bir Java uygulamasından çağrılabilir hale getiren sarmalayıcı kütüphaneler kullanır.

Bunu başarmak için, Java gibi diller bunu mümkün kılan yabancı işlev arayüzü adı verilen bir mekanizma sağlar. Bu mekanizmaların bazı örnekleri şunlardır:

* Java Native Interface (JNI)
* Java Native Access (JNA)
* A foreign function library for Python
* Managed Extensions
* Simplified Wrapper and Interface Generator (SWIG)

Mevcut sarmalayıcı kütüphaneler
-------------------------------

Mevcut sarmalayıcı kütüphanelere bazı örnekler:

* Pthreads for WIN32
* OpenGL Bindings for Python
* MySQL++
* JavaCV

Ayrıca bakınız
--------------

* Sarmalayıcı fonksiyon
* Sarmalayıcı desen
* Yapıştırıcı kodu