Poprawia czytelność kodu dla innych programistów, a także dla siebie, umożliwiając dostarczanie informacji o tym, jak złożone rzeczy są obsługiwane w programie w celu głębszego zrozumienia i konserwacji. W tym artykule zbadamy różne rodzaje komentarzy."
Inny rodzaj komentarza w rzutce w Ubuntu 20.04?
W DART możesz komentować na różne sposoby w następujący sposób:
Komentarze jednokierunkowe.
Składnia: // Komentarz pojedynczy.Komentarze wieloletnie.
Składnia: /* Komentarz jednoliniowy.*/Komentarze dokumentacji jednokierunkowej.
Składnia: /// Komentarz pojedynczy.Komentarze dokumentacji wieloletnie.
Składnia: /** Komentarz jednorazowy.*\Jak używać komentarza w rzutce w Ubuntu 20.04?
Pomiędzy instrukcjami DART możesz dodawać komentarze wszędzie tam, gdzie w programie. Kompilator/Interpreter po prostu odrzuca komentarze w naszym kodzie, co nie skutkuje zmianą ostatecznego wyjścia programu. Krótko mówiąc, komentarze służą jako krótkie, zrozumiałe wyjaśnienie konkretnego kodu. Zauważ, że komentarzy nie należy używać do wyjaśnienia źle napisanego kodu. Zawsze staraj się stworzyć jasny, czytelny kod przed dodaniem komentarzy. Mamy różne typy komentarzy w skrypcie DART w następujący sposób:
Przykład nr 1: Korzystanie z komentarza pojedynczego linii w strzałce w Ubuntu 20.04
Komentarz jednoliniowy jest wyrażany za pomocą podwójnego naprzód (//) i znacząco przyczynia się do nowej postaci. Komentarz jednoliniowy w Dart służy do komentowania linii, dopóki nie zostanie zepsuty.
Mamy nasz pierwszy komentarz jednokierunkowy użyty w głównej sekcji DART w kodzie. Komentarz jednoliniowy ma formułę „obszaru”, której użyliśmy w zmiennej „obszarze.„Aby oczyścić czytelników, użyliśmy tutaj formuły obszaru. Następnie ponownie używamy jednego komentarza, aby pokazać, co dzieje się dalej w funkcji drukowania.
Możesz zauważyć, że tekst komentarza jednolowego jest tutaj ignorowany przez kompilator DART; Wyświetlany jest tylko „obszar”, który przeszliśmy do funkcji drukowania.
Przykład nr 2: Korzystanie z komentarza wieloletniego w rzutce w Ubuntu 20.04
Komentarze wieloletnie mogą być zastosowane, gdy trzeba dodać komentarze do wielu wierszy. Komentarze wielopasmowe DART są używane do komentowania całych sekcji kodu. Zaczyna się i kończy wieloletni komentarz odpowiednio „/*” i „*/”. Pomiędzy sekcją komentarza multiline „ / * i * /” kompilator ignoruje wszystko. Z drugiej strony, w wielu linii nie można owinąć w inny komentarz wieloletni.
Teraz mamy reprezentację komentarza multiline w głównej metodzie powyższego programu DART. Użyliśmy komentarza multiline do podania szczegółów, które zamierzamy utworzyć listę liczb całkowitych z składnią listy w DART. Następnie skonstruowaliśmy zmienną „listę”, która zawiera liczbę list z reprezentacją listy DART. Ponownie użyliśmy komentarzy multiline do wyszczególnienia funkcji drukowania. Lista zostanie wydrukowana na ekranie za pomocą funkcji wydruku.
Po interpretacji mamy tylko listę jako wyjście. Tekst komentarza multiline nie jest wyświetlany na ekranie. Jest domyślnie eliminowany przez kompilator.
Przykład nr 3: Korzystanie z komentowania pojedynczego wiersza DOC w rzutce w Ubuntu 20.04
Komentarze dokumentacji są rodzajem komentarza, który jest zwykle używany do tworzenia dokumentacji lub zasobu do zadania lub oprogramowania. Komentarz do dokumentacji to jedno linia lub wielokrotny komentarz z znakami /// lub /*.
Możesz użyć komentowania pojedynczego liniowego DOC na temat kolejnych wierszy, który jest taki sam jak komentarz wieloletni. Interpreter DART wyklucza te linie, z wyjątkiem tych umieszczonych w kręconych nawiasach. Triple Slash lub Triple Forward Slash może być używany w komentarzu do dokumentu jednoliniowego.
Po utworzeniu głównej metody użyliśmy trzech cięć do przodu do dokumentacji komentarza jednokierunkowego. Do deklaracji zmiennej używany jest komentarz jednokierunkowy DOC. Jest to właściwość komentarza jednokiniowego DOC używane przed zmiennymi, funkcją lub definicją klasy kodu. Zmienna „String1” jest zadeklarowana, inicjując wartość ciągu. Następnie mamy sześć wierszy dokumentacji komentarza jednokierunkowego przed funkcją drukowania. W kodzie możemy użyć tylu komentarzy jednoladowych. Ale musimy użyć komentarzy jednoliniowych dla prawidłowych informacji w kodzie, aby przejrzystość kodu nie była naruszona.
Na ekranie wyświetla się tylko instrukcja wewnątrz funkcji drukowania. Komentarze jednoladowe DOC są wyświetlane na powładzie.
Przykład nr 4: Korzystanie z komentarza linii multiline w DART w rzutce w Ubuntu 20.04
Te znaki „**/**…*/**” są używane do tworzenia wielu linii dokumentów. Uwaga do dokumentu wieloletniego pokazano poniżej. Poniższy przykład wyjaśnia przy użyciu dokumentacji komentarzy wielopoziomowych w kodzie DART.
Wewnątrz głównej metody komentarze DOC Multiline są używane z postacią „/” backslash i postacią podwójnej asterisku „**.„Użyliśmy postaci do przodu tylko raz. Oznacza to, że wprowadziliśmy sekcję komentarza i użyliśmy gwiazdki do tworzenia dalszych komentarzy MultiLine DOC. Następnie komentarze Doc Multiline zakończyły się postacią gwiazdkową i postacią naprzód „//.”Następnie mamy instrukcję w funkcji drukowania wyświetlonej tylko na ekranie.
Komentarze Multiline Doc nie są używane do celów wykonania. Są ignorowane przez kompilator, jak pokazano na ekranie skorupy.
Wniosek
Chociaż uważamy się za programistów, większość tekstu w kodzie źródłowym jest przeznaczona do czytania na ludziach. Kilka sekund pisania prostego, precyzyjnego komentarza może zaoszczędzić jedną z wielu godzin. Każdy język programowania obsługuje komentarze w konkretnym kodzie dla wygody czytelnika. Chociaż Dart Language ma wiele sposobów tworzenia komentarzy w kodzie. Mamy ogólną reprezentację komentarzy Dart z czterema przykładami.