Python#

La documentation de référence de l’API Python VEX V5 explique le rôle de chaque commande, méthode et fonction, les entrées qu’elle utilise, les valeurs qu’elle renvoie et comment elle peut être utilisée dans un projet.

Utilisez cette référence lorsque vous souhaitez comprendre une commande avant de l’ajouter à un projet, vérifier les valeurs qu’elle accepte ou renvoie, ou comparer des commandes apparentées dans une même catégorie.

Les commandes Python sont utilisées dans les projets Python de VEXcode V5. Les projets Blocks et C++ utilisent quant à eux d’autres sections de l’API.

Comment lire une entrée de méthode#

La plupart des entrées Python comprennent les parties suivantes :

Nom de la commande - Le nom officiel de la commande, de la méthode ou de la fonction.
Description - Explique le rôle de la commande et son utilité dans certains cas.
Utilisation - Affiche la syntaxe utilisée pour écrire la commande en code.
Paramètres - Liste les entrées acceptées par la commande et explique le rôle de chacune.
Valeur de retour - Explique ce que la commande renvoie, si elle renvoie une valeur.
Exemple de code - Illustre une façon d’utiliser la commande dans un projet.

Éléments communs de l’API Python#

Élément	Ce que cela signifie
Méthode	Une commande appelée sur un objet tel que `drivetrain.drive(…)`.
Fonction	Une commande appelée directement, telle que `wait(…)` ou `print(…)`.
Paramètre	Une valeur passée à une méthode ou une fonction pour contrôler son comportement.
Paramètre optionnel	Un paramètre qui peut être omis afin que le comportement par défaut soit utilisé.
Valeur de retour	Une valeur renvoyée par une commande, telle qu’un nombre, du texte ou une valeur booléenne.

Vocabulaire Python de base#

Terme	Ce que cela signifie
Variable	Un nom qui stocke une valeur, comme `speed = 50`.
Chaîne	Texte entre guillemets, comme `“Hello”`.
Entier	Un nombre positif ou négatif, tel que `90`.
Flotter	Un nombre décimal, tel que `25.5`.
Booléen	Une valeur qui est soit `True` ou `False`.
Argument	Une valeur passée à un appel de méthode ou de fonction, telle que `360.0` dans `drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)`.

Exemple de saisie de méthode#

conduire#

La position drive permet au robot d’avancer ou de reculer indéfiniment. Il continuera son mouvement jusqu’à ce qu’une autre action, comme tourner ou s’arrêter, lui soit donnée. La vitesse (en tours par minute ou en degrés par seconde) est limitée par le rapport de transmission.

Usage:
drivetrain.drive(direction, velocity, units)

Paramètres	Description
`direction`	La direction dans laquelle le robot se déplace : `FORWARD` ou `REVERSE`.
`velocity`	Optional. The velocity to drive with from 0% to 100% when using `PERCENT`, from 0 to 600 rpm when using `RPM`, or from 0 to 3600 degrees per second when using `VelocityUnits.DPS`. This can be an `integer` or decimal (`float`). If no velocity is provided, the robot drives at the current drive velocity.
`units`	Facultatif. L’unité de vitesse : `RPM` (rotations par minute, par défaut), `PERCENT`ou `VelocityUnits.DPS` (degrés par seconde).

# Drive forward, then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)