Python#

La documentation de référence de l’API Python VEX IQ (2e génération) explique le rôle de chaque commande, méthode et fonction, les entrées qu’elle utilise, ce 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 IQ (2e génération). Les projets Blocks et C++ utilisent quant à eux d’autres sections de l’API.

Remarque : Le système IQ (2e génération) exécute Python via une machine virtuelle à mémoire limitée. Bien qu’une taille maximale soit imposée au code source, l’exécution d’un programme dépend également de sa complexité (nombre de fonctions, de variables et de logique). Par conséquent, les programmes volumineux ou complexes peuvent ne pas compiler ou s’exécuter, même s’ils respectent la limite de taille. Les programmes C/C++ sont généralement moins affectés par ces limitations sur IQ (2e génération).

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 `REVERSE` dans `drivetrain.drive(REVERSE, 20, PERCENT)`.

Exemple de saisie de méthode#

conduire#

La commande drive fait avancer ou reculer le robot indéfiniment. Le robot continuera à se déplacer jusqu’à ce qu’une autre action, comme tourner ou s’arrêter, lui soit donnée.

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 120 rpm when using `RPM`, or from 0 to 720 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`	Optionnel. L’unité de vitesse : `PERCENT` (par défaut), `RPM` (rotations par minute), ou `VelocityUnits.DPS` (degrés par seconde).

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

# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()