Pycom FiPy, Руководство пользователя, Страница: 479 / 496

An astrik
*
in a method description (in the docs), denotes that the following arguments
require a keyword, i.e.
pin='P16'
in the example below.
adc.channel(* , pin, attn=ADC.ATTN_0DB)
from machine import ADC
adc = ADC() # create an ADC object
apin = adc.channel(pin= 'P16' ) # create an analog pin on P16
pin
is a required argument and the method
channel
will not execute unless it is passed
as with a keyword.
Another example shows how the
PWM
class,
pwm.channel()
requires a keyword argument
for
pin
but does not for
id
.
from machine import PWM
pwm = PWM( 0 , frequency= 5000 )
pwm_c = pwm.channel( 0 , pin= 'P12' ) # no keyword argument requires for id (0) but is req
uired for pin (pin='P12')
Value
The documentation may refer to a method that takes an argument listed by name but does
allow for a keyword to be passed. For example, the
pycom
class contains a method
rgbled
. This lists that the method accepts a value for
color
, however this may not be
specified by
keyword
, only
value
. This is intentional as the
value
being passed is the
only argument valid for this method
pycom.rgbled(color)
If the argument is passed into the method with a keyword, it will return an error stating
TypeError: function does not take keyword arguments.
import pycom
pycom.rgbled(color= 0xFF0000 ) # Incorrect
pycom.rgbled( 0xFF0000 ) # Correct
Another example of a method that only accepts value input. In this case, the
RTC.init()
method require a value (
tuple
) input for the
datetime
. It will not accept a keyword.
rtc.init(datetime)
9.2 Syntax
479