Tworzenie wątku
W programie korzystającym z biblioteki pthreads, tuż po uruchomieniu działa dokładnie jeden wątek, wykonujący funkcję main.
Aby utworzyć nowe wątki programista podaje funkcję (dokładniej: adres funkcji), która ma zostać w nim wykonana - pthread_create tworzy i od razu uruchamia wątek, oraz zwraca jego identyfikator. Oczywiście jedna funkcja może być wykorzystywana do utworzenia wielu wątków. Funkcja użytkownika przyjmuje i zwraca wartość typu void*, interpretacja tych danych jest zależna od programu, pthreads nie narzuca więc tutaj żadnych ograniczeń. Wątki mogą być tworzone z poziomu dowolnego innego wątku.
Wątek identyfikuje wartość pthread_t, która jest argumentem dla większości funkcji bibliotecznych.
Liczba wątków, jakie można utworzyć jest ograniczona przez stałą PTHREAD_THREADS_MAX (z pliku limits.h) oraz rzecz jasna przez zasoby systemowe.
Typy pthread_t identyfikator wątku pthread_attr_t atrybuty wątku
Funkcje
id - identyfikator wątku; attr - wskaźnik na atrybuty wątku, określające szczegóły dotyczące wątku; można podać NULL, wówczas zostaną użyte domyślne wartości; fun - funkcja wykonywana w wątku; przyjmuje argument typu void* i zwraca wartość tego samego typu; arg - przekazywany do funkcji.
Przykład Poniższy program typu hello world tworzy (w wątku głównym) kilka innych wątków, wykonujących funkcję watek i czeka na ich zakończenie. Używane są domyślne atrybuty wątku.
Identyfikator wątku
Wewnętrzna struktura typu pthread_t (podobnie jak innych używanych w pthreads) jest określona przez implementację. Jedyną operacją, jaką można wykonać na identyfikatorach jest ich porównanie ze względu na równość funkcją pthread_equal.
Funkcja pthread_self zwraca identyfikator wywołującego wątku, co czasem jest przydatne.
Funkcje
stwierdzenie, czy identyfikatory wątków są równe
zwraca identyfikator wywołującego wątku
Kończenie wątku
Wątek jest kończony w chwili, gdy funkcja użytkownika przekazana w pthread_create zwraca sterowanie do wywołującego ją kodu, a więc w miejscu wystąpienia instrukcji return.
Ponadto istnieje funkcja pthread_exit, która powoduje zakończenie wątku - może zostać użyta w funkcjach wywoływanych z funkcji wątku.
Przykład
W przykładowym programie zakończenie wątku powoduje wywołanie pthread_exit na 6. poziomie zagnieżdżenia funkcji koniec_watku.
Wyjście: $ ./przyklad licznik = 0, limit = 5 licznik = 1, limit = 5 licznik = 2, limit = 5 licznik = 3, limit = 5 licznik = 4, limit = 5 licznik = 5, limit = 5
Oczekiwanie na zakończenie wątku
Oczekiwanie na zakończenie wątku jest dodatkowym sposobem synchronizacji między wątkami i dotyczy wyłącznie wątków typu joinable (zobacz Rodzaje wątków poniżej). Wątek wywołujący pthread_join zostaje wstrzymany do chwili, gdy wskazany wątek zakończy działanie - wówczas wątek oczekujący jest kontynuowany, a pthread_join przekazuje wartość wynikową zwróconą przez wątek. Jeśli wątek został przerwany wartością zwracaną jest stała PTHREAD_CANCELED.
Oczekiwanie na zakończenie wątku można uzyskać zmiennymi warunkowymi (dodatkowo bez ograniczań na rodzaj wątku), wymaga to jednak dodatkowej pracy ze strony programisty.
Funkcje
id - identyfikator wątku, którego zakończenie jest oczekiwane; retval - wskaźnik na wartość wynikową wątku; może być NULL, wówczas wynik jest ignorowany
Zakończenie procesu, a kończenie wątków
Kiedy kończy się proces, wszystkie wątki utworzone w jego obrębie są również (gwałtownie) kończone. Dlatego koniecznie trzeba użyć albo wbudowanego mechanizmu synchronizacji, albo jakiegoś własnego rozwiązania.
Rodzaje wątków
W pthreads wątki są dwojakiego rodzaju: joinable (domyślny rodzaj) detached
Rodzaj jest ustalany w atrybutach wątku. Można jednak po utworzeniu wątku zmienić typ z joinable na detached funkcją pthread_detach; odwrotne działanie nie jest możliwe.
Wątek typu joinable to taki, z którego można odczytać wartość wynikową zwróconą przez funkcję. Gdy wątek tego typu kończy się, jego zasoby nie są zwalniane do chwili wywołania funkcji pthread_join (patrz Oczekiwanie na zakończenie wątku).
Warto więc zwrócić uwagę, że utworzenie wątku typu joinable i nie wywołanie wspomnianej funkcji skutkować będzie wyciekiem pamięci (następstwem którego tworzenie nowych wątków może stać się niemożliwe).
Wątek typu detached z chwilą zakończenia działania od razu zwalnia wszystkie zasoby; funkcja pthread_join nie akceptuje identyfikatorów do wątków tego typu.
Funkcje
zmiana rodzaju wątku
Przekazywanie argumentów i zwracanie wyników
Przekazywanie argumentów
Funkcja wykonywana w wątku przejmuje argument typu void* podawany w funkcji pthread_create - wskaźnik ten może więc wskazywać dowolną strukturę, może być także pusty.
Można również rzutować bezpośrednio typy, których rozmiar nie przekracza rozmiaru wskaźnik, tzn. gdy sizeof(typ) <= sizeof(void*); mogą to być typy int, short, char, być może też inne - zależnie od platformy sprzętowej i kompilatora.
Zwracanie wyniku
Funkcja użytkownika zwraca wskaźnik na void*. Jeśli potrzeba zwrócić jakieś dane, należy je zaalokować na stercie funkcją malloc lub podobną.
Można również rzutować na void*, tak samo jak w przypadku przekazywania argumentów.
Przykład
Wyjście: $ ./przyklad Witaj Wikibooks w dniu 2010-03-14 Wątek 2 wywołany z argumentem liczbowym 27 wątek 2 zwrócił napis: 'xxxxxxxxxxxxxxxxxxxxxxxxxxx'