Add the number_of_times_each_philosopher_must_eat

This option required minor code changes, because I tried to prepare
for this in advance but I had an incorrect understanding of the option.

Add missing indexing on initialization

Add parantheses around return value

Fix leak caused by not accepting thread's return

The threads have alocatted memory where return value resides.
A thread has to be joined (or detached) to release this memory.

Implement mandatory part of philosophers

Sorry for big commit, I wrote it in one session and didn't encounter
an apropriate point for partial commit.
This needs to be tested and refactored to pass the 42 Norm.