I hate poorly documented APIs. I have spent all my working day trying to get something to work with an API call like:
int frobnicate(int nInputs, bar* inputs, int *nFound);
Which takes an array, length
nInputs, of inputs and tries to find particular things. The documentation states that the integer pointed to by
nFound will, on exit, give the number of things found. What is
doesn’t say is that you have to initialise this to the maximum number of things it will look for on entry and hence if, like me, you are good and initialise all your vairables to zero at the start then the function will always succeed but not find any points. Gagh!