Python#

W dokumencie VEX CTE Python API Reference wyjaśniono, co robi każde polecenie, metoda i funkcja, jakich danych wejściowych używa, co zwraca i jak można je wykorzystać w projekcie.

Skorzystaj z tego odniesienia, jeśli chcesz zrozumieć polecenie przed dodaniem go do projektu, sprawdzić, jakie wartości akceptuje lub zwraca, lub porównać powiązane polecenia w danej kategorii.

Polecenia Pythona są używane w projektach VEXcode Python. Projekty bloków korzystają z sekcji API bloków.

Jak czytać wpis metody#

Większość wpisów dotyczących Pythona zawiera następujące części:

  • Nazwa polecenia – oficjalna nazwa polecenia, metody lub funkcji.

  • Opis – wyjaśnia, co robi polecenie i kiedy jest przydatne.

  • Użycie – Pokazuje składnię użytą do zapisania polecenia w kodzie.

  • Parametry – wypisuje akceptowane przez polecenie dane wejściowe i wyjaśnia, co każdy z nich robi.

  • Wartość zwracana – wyjaśnia, co polecenie zwraca, jeśli zwraca wartość.

  • Przykładowy kod – Pokazuje jeden sposób wykorzystania polecenia w projekcie.

Wspólne elementy API Pythona#

Element

Co to znaczy

Metoda

Polecenie wywoływane na obiekcie takim jak arm.move_inc(…).

Funkcjonować

Polecenie wywoływane bezpośrednio, takie jak wait(…) lub print(…).

Parametr

Wartość przekazywana do metody lub funkcji w celu kontrolowania jej działania.

Parametr opcjonalny

Parametr, który można pominąć, aby użyć domyślnego zachowania.

Wartość zwracana

Wartość zwracana przez polecenie, np. liczba, tekst lub wartość logiczna.

Podstawowe słownictwo Pythona#

Termin

Co to znaczy

Zmienny

Nazwa przechowująca wartość, np x_target = 120.

Smyczkowy

Tekst w cudzysłowie, np. “Hello”.

Liczba całkowita

Liczba dodatnia lub ujemna, np. 90.

Platforma

Liczba z częścią dziesiętną, np. 25.5.

Boolean

Wartość, która wynosi True lub False.

Argument

Wartość przekazana do wywołania metody lub funkcji, np. 100 in arm.move_inc(0, 100, 0).

Przykładowy wpis metody#

move_inc#

move_inc przesuwa ramię 6-osiowe o określoną odległość wzdłuż osi x, y i z.

Ta metoda zwróci wartość logiczną wskazującą, czy ramię 6-osiowe osiągnęło żądaną pozycję:

  • True - Ramię 6-osiowe osiągnęło żądaną pozycję.

  • False - Ramię 6-osiowe nie może osiągnąć żądanej pozycji.

Usage:
arm.move_inc(x, y, z, wait)

Parametr

Opis

X

Odległość, jaką należy pokonać wzdłuż osi x, podana w milimetrach.

y

Odległość, jaką należy pokonać wzdłuż osi Y, podana w milimetrach.

z

Odległość, jaką należy pokonać wzdłuż osi Z, podana w milimetrach.

wait

Opcjonalnie.

  • wait=True (domyślnie) — projekt czeka, aż move_inc zostanie zakończone, zanim wykona następny wiersz kodu.
  • wait=False — projekt rozpoczyna działanie i przechodzi do następnego wiersza kodu od razu, nie czekając na zakończenie move_inc

 
# Move the Arm +100 millimeters on the y-axis
arm.move_inc(0, 100, 0)
On this page