Почему в документации Arduino API нет четких типов?

Например, я просматриваю страницу digitalWrite и все Я получаю это для подписи:

digitalWrite(pin, value)

Ни типа возвращаемого значения, ни типа параметра, ничего.

Вместо этого в отдельном разделе говорится

Returns
Nothing

А потом говорится

Parameters
pin: the Arduino pin number.
value: HIGH or LOW.

Что такое "ценность"? Int? uint8_t? буль? Почему API написан таким странным двусмысленным образом?

Я ожидал что-то вроде

void digitalWrite(uint8_t pin, uint8_t value)

Как я привык к другим "правильным" Документация по API.

, 👍1

Обсуждение

Потому что это написано для новичков новичками, @Majenko

Я нашел void digitalWrite (pin_size_t pinNumber, статус PinStatus);. поэтому., @Juraj

Большинство страниц в Language/Functions _do_ документируют типы данных (я насчитал 74 из 137). Это больше, чем раньше, так как документирование типов требует постоянной работы. Вы можете принять участие, отправив запросы на включение по адресу [arduino/reference-en](https://github.com/arduino/reference-en)., @Edgar Bonet

См. [Укажите типы данных в определениях функций] (https://github.com/arduino/reference-en/issues/15). Я поднимал этот вопрос в 2015 году — этот вопрос все еще открыт 7 лет спустя., @Nick Gammon

Попробуйте перейти на эту страницу Github и поддержать мою просьбу об улучшении документации. Удачи!, @Nick Gammon

re: «_Что такое «значение»? Int? uint8_t? bool?_»: все они работают в этом контексте, поэтому я не вижу проблемы., @dandavis


Смотрите также: