Каков идиоматический способ проверки и документирования предусловий и постусловий функций в R? Я бы счел Eiffel
встроенными конструкциями require
и ensure
или D
блоками in
и out
современными здесь, но в большинстве языков нет таких встроенных Таким образом, были разработаны передовые методы их аппроксимации.
Под проверкой предусловий я подразумеваю генерацию какого-то исключения во время выполнения, если передаются данные, которые не соответствуют предположениям функций. В настоящее время у меня есть оператор stopifnot
для каждого предусловия, которое я могу придумать в начале функции. То же самое относится и к постусловиям, но в отношении возвращаемого значения, а не параметров.
Кроме того, существует ли стандартный способ документирования этих предусловий и постусловий? Например, довольно стандартно указывать их в комментариях JavaDoc в Java.
Каковы лучшие практики в R в этом отношении?