Что означают синтаксически параметры React.Component.setState ()? [Дубликат]
Ответ, который вы хотите, очень сильно зависит от того, как и почему вы хотите разбить фрейм данных.
Например, если вы хотите оставить некоторые переменные, вы можете создавать новые кадры данных из определенных столбцы базы данных. Нижние индексы в скобках после кадра данных относятся к номерам строк и столбцов.
newdf <- mydf[,1:3]
Или вы можете выбрать определенные строки.
newdf <- mydf[1:3,]
И эти индексы также могут быть логическими тестами, такими как выбор строк, которые содержат определенное значение или факторы с желаемым значением.
Что вы хотите сделать с оставшимися кусками? Вам нужно выполнить одну и ту же операцию на каждом фрагменте базы данных? Затем вы захотите убедиться, что подмножества кадра данных попадут в удобный объект, например список, который поможет вам выполнить одну и ту же команду на каждом фрагменте кадра данных.
4 ответа
Итак, почему API-документация написана таким образом, чтобы путать многолетних новичков / хакеров / DIY, таких как я?
Это действительно не должно быть написано именно так. Я соглашусь, что, похоже, нелегко использовать документацию по API. Тем не менее, существует много переходов из старых синтаксических соглашений стиля man, к современным соглашениям об API / пространствах имен.
Как правило, тип человека, который работает с API, будет иметь некоторый опыт в разработке или, по крайней мере, «полномочным пользователем». Эти типы пользователей используются для таких соглашений синтаксиса, и для документа API имеет смысл больше, чем пытаться создать новые.
Есть ли какой-то таинственный документ где-то, что говорит людям, как читать документацию по API ?
На самом деле не существует стандарта, или RFC, supersekretsyntaxdoc, лежащего где угодно, однако существует файл с 30-летним файлом формата UNIX man-страницы , который широко используется [30].
Некоторые примеры этого (и ответа на ваш вопрос) были бы следующими:
Подчеркнутые слова считаются литералами и набираются так, как они появляются.
Квадратные скобки ([]) вокруг аргумента указывают, что аргумент не является обязательным.
Эллипсы ... используются, чтобы показать, что предыдущий аргумент-прототип может быть повторен.
Аргумент начиная с знака минус - часто воспринимается как некоторый аргумент флага, даже если он появляется в позиции, где может отображаться имя файла.
A Почти вся документация, связанная с программированием, использует этот тип соглашения о синтаксисе, из Python , man pages , javascript libs ( Highcharts ) и т. д.
Нарушение вашего примера из Adobe API
fillPath ([fillColor] [, mode] [, opacity] [, preserveTransparency] [, feather] [, wholePath] [, antiAlias])Мы видим, что
fillPath()(функция) принимает необязательные аргументыfillColor, mode, opacity, preserveTransparency, feathe, wholePathилиantiAlias. ВызываяfillPath(), вы можете передать нигде ни от одного, ни от всех параметров к нему. Запятые в необязательном[]означают, что если этот параметр используется в дополнение к другим, вам нужна запятая, чтобы разделить его. (Здравый смысл иногда, конечно, но иногда некоторые языки, такие как VB, явно нуждаются в этих запятых, чтобы правильно определить, какой параметр отсутствует!). Поскольку вы не ссылались на документацию (и я не могу найти ее на странице скриптов Adobe ), действительно не существует способа узнать, какой формат ожидает Adobe API. Однако должно быть объяснение в верхней части самой документации, объясняющей соглашения, используемые внутри.Таким образом, эту функцию можно было бы использовать многими способами:
fillPath() //Nothing passed fillPath(#000000,RGB) // Black, in RGB mode fillPath(#000000,RGB,50) // Black, in RGB mode, half opacity //Now it gets tricky, this might ALSO be acceptable: fillPath(#000000,50) // Black, no mode, half opacity //OR fillPath(#000000,,50) // Black, no mode, half opacityОпять же, обычно есть некоторые стандарты во всех документах, касающихся API / программирования. Однако в каждом документе могут быть тонкие различия. Как опытный пользователь или разработчик, вы, как ожидается, сможете читать и понимать документы / фреймворки / библиотеки, которые вы пытаетесь использовать.
-
1Ссылка страницы синопсиса man-страницы UNIX мертва - у кого есть ссылка на замену? Обновление @PenguinCoder: на основе [ unix.stackexchange.com/questions/17833/… (Unix Stack Exchange)), он свободно основан на [ ru.wikipedia.org/wiki/Extended_Backus % E2% 80% 93Naur_Form (EBNF) – steviejay 4 June 2016 в 17:58
API-документы API для динамически типизированных языков могут быть не очень значимыми, если не написаны тщательно, поэтому не чувствуйте себя слишком плохо, даже самый опытный разработчик может с трудом их понять.
В скобках и т. Д. Обычно есть раздел условных условных обозначений, который должен объяснять точное использование внешних литералов; хотя EBNF , Regex и Диаграммы железных дорог почти повсеместны, поэтому вы должны быть знакомы с ними, чтобы понять большинство обозначений.
Скобки означают, что свойство является необязательным. Имейте в виду, что если вы хотите установить свойство soem в ранге nTh, вам нужно либо объявить свойства для eading, либо объявить их как undefined:
fillPath() //good
fillPath ( someFillColor ) //good
fillPath ( someFillColor, mode ) //good
fillPath ( undefined, mode ) //good
fillPath ( mode ) //bad
fillPath ( undefined ) //really bad
-
1
fillPath (mode)может быть в порядке. Если необязательный аргумент возникает перед необязательным, это часто означает, что функция достаточно умна, чтобы определить, был ли задан необязательный аргумент (например, просмотрев его тип) – ThiefMaster♦ 8 June 2012 в 14:49 -
2MMmm хорошо, что возможно, но я предпочитаю полагаться на что-то сильное, чем то, что сценарий может сделать для меня: D – Loic Aigon 11 June 2012 в 18:00
У меня был такой же вопрос некоторое время назад, и кто-то указал мне на Extended Backus-Naur Form .
Это имеет смысл, потому что программирование может быть использовано для создания потенциально безграничных результатов. Документация не может отображать пример для каждого возможного случая. Хорошим примером совместного использования я вам помогу, но как только вы сможете прочитать базовый синтаксис, который вы можете создать свой собственный код.