Разница между PyInt_FromLong и Py_BuildValue

Question

API Python/C имеет ряд связанных функций, которые выполняют аналогичные операции, где обычно используется для общего использования, а другое - как-то более эффективно или удобно для конкретной ситуации.

Например, PyDict_SetItem и PyDict_SetItemString те же, но последний специализирован для строки C в качестве ключа. Для PyList_SetItem и PyList_SET_ITEM второй не имеет проверки ошибок и не уменьшает существующий элемент (explained here).

Но в чем причина наличия специальных конверсий, таких как PyInt_FromLong, когда всегда есть Py_BuildValue? Оба возвращают новую ссылку на объект Python и, похоже, делают то же самое. Этот же вопрос относится к таким функциям, как PyInt_FromSsize_t, PyTuple_Pack и т. Д. (Все по сравнению с Py_BuildValue с соответствующей строкой формата).

Когда вы должны использовать один над другим?

Answer 1

Для меня это компромисс между производительностью и простотой. Для кода, который я написал, я предпочитаю использовать Py_BuildValue, когда мне не важно время выполнения (т. Е. Возврат набора значений, которые не будут меняться, или время работы настолько велико, что дополнительные накладные расходы не имеют значения .) Для критически важных функций, особенно тех, которые могут быть на самом внутреннем уровне цикла, я буду использовать API API самого низкого уровня, который я могу использовать.

Стоит ли это или нет, это другой вопрос. Я никогда не откажусь от времени, потраченного на достижение максимальной производительности, но я знаю, что другие приложения, которые используют мой код, значительно быстрее.