Arduino & IoT Academy · Ders

Yorumlar ve Temiz Taslaklar

Kodun okunabilir kalması için notlar yazın ve yapıyı düzenleyin.

3. ders / 413 adım

Yorumlar ve Temiz Taslaklar, CoddyKit'te ücretsiz bir Arduino & IoT Academy dersidir. Bu, 4 dersinin 3. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Arduino & IoT Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Arduino & IoT Academy kursu toplamda 4 dersten oluşur.

İnsanlar İçin Notlar

Kod, yazıldığından çok daha sık okunur. Yorumlar, gelecekteki sizin taslağı anlamanız için bıraktığınız notlardır. 📝

Tek Satırlık Yorum

İki eğik çizgi yazdığınızda o satırın geri kalanı bir yorum olur. Kart, kodunuzu çalıştırırken bunu tamamen yok sayar.

// this line is just a note
digitalWrite(13, HIGH);

Satır Sonlarında Yorumlar

Aynı satırda gerçek kodun arkasına bir yorum ekleyebilirsiniz. Bu, hiçbir şeyi bozmadan o adımı açıklar. Hızlı bağlam bilgisi vermek için kullanışlıdır.

delay(1000); // pause for one second

Blok Yorumu

Daha uzun notlar için metni eğik çizgi-yıldız ile yıldız-eğik çizgi arasına alın. Bu blok birkaç satıra yayılabilir ve açıklamalar için harikadır.

/* This sketch blinks
   the onboard LED. */

Yorumlar Çalıştırılmaz

Bir yorumun içindeki hiçbir şey kart tarafından görülmez. Yorumlar yalnızca okuyucular içindir; bu nedenle cihazınızın davranışını asla etkilemez.

Neyi Değil, Nedenini Açıklayın

İyi yorumlar bir satırın ne yaptığını değil, neden var olduğunu söyler. Kod zaten işlemi gösterdiği için nedeni not edin.

delay(20); // debounce noisy button

Girintileme Okumayı Kolaylaştırır

Küme ayraçlarının içindeki satırlar birkaç boşluk içeri alınmalıdır. Bu girintileme, nelerin birlikte olduğunu gösterir ve mantığı kolayca taramanızı sağlar.

void setup() {
  pinMode(13, OUTPUT);
}

Şeyleri Açıkça Adlandırın

Açık bir ad, yorumdan daha değerlidir. Bir pine yalnızca bir sayı yerine ledPin adını vermek, neyi denetlediğini okuyucuya tam olarak anlatır.

int ledPin = 13;

Test Etmek İçin Yoruma Alın

Önüne eğik çizgiler ekleyerek bir satırı geçici olarak devre dışı bırakın. Yoruma almak, geri isteyebileceğiniz kodu silmeden test yapmanızı sağlar.

// digitalWrite(13, LOW);

Gereksiz Kalabalıktan Kaçının

Her satırı anlatmayın. x'e bir eklemek gibi bir yorum, değer değil kalabalık ekler. Notları gerçekten açıklanması gereken kısımlara saklayın.

Temiz Taslaklar Kalıcıdır

Düzenli boşluklar, açık adlar ve yararlı yorumlar, bir taslağı aylar sonra düzeltmeyi kolaylaştırır. Okunabilir kod, güvenilir koddur.

Hızlı Kontrol

Bir yorumun ne yaptığını kontrol edelim.

İnteraktif derste cevapla

Özet: Temiz Taslaklar

Yorumları // ve eğik çizgi-yıldız ile kullanmayı, küme ayraçlarının içinde girinti vermeyi ve şeyleri açıkça adlandırmayı öğrendiniz. Okunabilir taslakların bakımı kolaydır. 🎉

Başlamak ücretsiz

Yapay zeka eğitmeniyle C++ öğren — ücretsiz

Tarayıcında gerçek kod yaz ve çalıştır, 7/24 yapay zeka eğitmeninden anında yardım al; web'de ya da uygulamada kaldığın yerden devam et.

Kurslar: 30
Dersler: 120

Ücretsiz öğrenmeye başla Tüm kursu görüntüle

Sıkça Sorulan Sorular

“Yorumlar ve Temiz Taslaklar” dersi ücretsiz mi?

Evet — “Yorumlar ve Temiz Taslaklar” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Arduino & IoT Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Arduino & IoT Academy kursu toplamda 4 dersten oluşur.

“Yorumlar ve Temiz Taslaklar” dersinde ne öğreneceğim?

Kodun okunabilir kalması için notlar yazın ve yapıyı düzenleyin. Arduino & IoT Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

Arduino & IoT Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te Arduino & IoT Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 3. dersidir.

“Yorumlar ve Temiz Taslaklar” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu Arduino & IoT Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her Arduino & IoT Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← Arduino & IoT Academy Sayfasına Dön