Bu, Ubuntu Online, Fedora Online, Windows çevrimiçi emülatörü veya MAC OS çevrimiçi emülatörü gibi birden fazla ücretsiz çevrimiçi iş istasyonumuzdan birini kullanarak OnWorks ücretsiz barındırma sağlayıcısında çalıştırılabilen komut perlstyle'dir.
Program:
ADI
perlstyle - Perl stil kılavuzu
TANIM
Elbette her programcının biçimlendirme konusunda kendi tercihleri olacaktır.
ancak programlarınızın okunmasını kolaylaştıracak bazı genel yönergeler vardır,
anlamak ve korumak.
En önemli şey, programlarınızı altında çalıştırmaktır. -w bayrak her zaman Yapabilirsin
"uyarı yok" pragması veya kodun belirli bölümleri için açıkça kapatın
Gerekirse $^W değişkeni. Ayrıca her zaman "kullanım katı" altında çalışmanız veya
neden olmasın. "Sigtrap kullan" ve hatta "tanılama kullan" pragmaları da kanıtlayabilir
işe yarar.
Kod düzeninin estetiğiyle ilgili olarak, Larry'nin önemle umursadığı tek şey şudur:
çok satırlı bir BLOCK'un kapanış küme parantezinin şu anahtar kelimeyle aynı hizada olması gerektiğini
yapımına başladı. Bunun ötesinde, o kadar güçlü olmayan başka tercihleri de var:
· 4 sütunlu girinti.
· Mümkünse anahtar kelime ile aynı satırda kıvırcık açma, aksi takdirde sıraya girin.
· Çok satırlı bir BLOK'un açılış kıvrımından önceki boşluk.
· Tek satır BLOK, bukleler dahil bir satıra yerleştirilebilir.
· Noktalı virgülden önce boşluk yok.
· "Kısa" tek satırlık BLOK'ta noktalı virgül kullanılmamıştır.
· Çoğu operatörün etrafında boşluk.
· "Karmaşık" bir alt simgenin etrafında boşluk bırakın (parantez içinde).
· Farklı şeyler yapan parçalar arasında boş satırlar.
· Sarılmamış başkaları.
· Fonksiyon adı ile açılış parantezleri arasında boşluk yoktur.
· Her virgülden sonra boşluk bırakın.
· Bir operatörden sonra kesilen uzun satırlar ("ve" ve "veya" hariç).
· Geçerli satırda son parantez eşleşmesinden sonra boşluk.
· İlgili öğeleri dikey olarak hizalayın.
· Netlik bozulmadığı sürece gereksiz noktalama işaretlerini atlayın.
Larry'nin bunların her biri için kendi sebepleri vardır, ancak o, diğer herkesin haklı olduğunu iddia etmez.
zihin onun yaptığı gibi çalışır.
İşte üzerinde düşünülmesi gereken daha önemli stil konuları:
· Sadece sen olduğun için CAN bir şeyi belirli bir şekilde yapmak senin olduğun anlamına gelmez MELİ bunu
bu şekilde. Perl, size herhangi bir şeyi yapmanın birkaç yolunu sunmak için tasarlanmıştır, bu yüzden düşünün
en okunaklı olanı seçmek. Örneğin
open(FOO,$foo) || die "$foo: $ açılamıyor!";
daha iyi
die "$foo açılamıyor: $!" open(FOO,$foo);
çünkü ikinci yol, ifadenin ana noktasını bir değiştiricide gizler. Üzerinde
Diğer el
$ayrıntılı ise "Analiz başlatılıyor\n" yazdır;
daha iyi
$verbose && print "Analiz başlatılıyor\n";
çünkü asıl mesele kullanıcının yazıp yazmadığı değil -v veya olmasın.
Benzer şekilde, bir operatörün varsayılan argümanları varsaymanıza izin vermesinin,
varsayılanları kullanmanız gerektiğini. Tembel sistemler için varsayılanlar var
tek seferlik programlar yazan programcılar. Programınızın okunabilir olmasını istiyorsanız,
argüman sağlamayı düşünün.
Aynı çizgide, çünkü sen CAN birçok yerde parantezleri atla
yapmanız gerektiği anlamına gelir:
geri yazdırma ters sıralama num değerleri %dizi;
return print(reverse(sort num (değerler(%dizi))));
Şüphe duyduğunuzda, parantez içine alın. En azından bazı zavallıların sıçramasına izin verecek
% tuşunda vi.
Herhangi bir şüpheniz yoksa bile, ihtiyacı olan kişinin akıl sağlığını düşünün.
senden sonra kodu koru ve kim muhtemelen parantezleri yanlış yere koyacak.
· Perl kullanıldığında, üstte veya altta bir döngüden çıkmak için aptalca bükülmeler yapmayın.
"son" operatörü sağlar, böylece ortada çıkabilirsiniz. Sadece "açık" bir
daha görünür kılmak için çok az:
HAT:
için (;;) {
ifadeleri;
$foo ise son SATIR;
sonraki SATIR ise /^#/;
ifadeleri;
}
· Döngü etiketlerini kullanmaktan korkmayın; bunlar, okunabilirliği artırmanın yanı sıra
çok düzeyli döngü kesintilerine izin verir. Önceki örneğe bakın.
· Boş bir bağlamda "grep()" (veya "map()") veya "backticks" kullanmaktan kaçının, yani
sadece dönüş değerlerini atın. Bu işlevlerin hepsinin dönüş değerleri vardır, bu nedenle
onlara. Aksi takdirde, bunun yerine bir "foreach()" döngüsü veya "system()" işlevini kullanın.
· Taşınabilirlik için her makinede uygulanamayan özellikler kullanılırken,
başarısız olup olmadığını görmek için yapıyı bir değerlendirmede test edin. Hangi sürümü veya
patchlevel belirli bir özellik uygulandı, $] ($PERL_VERSION içinde
"İngilizce") orada olup olmayacağını görmek için. "Yapılandırma" modülü ayrıca
tarafından belirlenen değerleri sorgular. yapılandırma Perl kurulduğunda program.
· Anımsatıcı tanımlayıcıları seçin. Anımsatıcının ne anlama geldiğini hatırlayamıyorsanız,
sorun.
· $gotit gibi kısa tanımlayıcılar muhtemelen uygun olsa da, kelimeleri ayırmak için alt çizgi kullanın
daha uzun tanımlayıcılarda. $var_names_like_this okumak genellikle okumaktan daha kolaydır.
$VarNamesLikeThis, özellikle ana dili İngilizce olmayanlar için. Bu aynı zamanda basit
"VAR_NAMES_LIKE_THIS" ile tutarlı bir şekilde çalışan kural.
Paket adları bazen bu kuralın bir istisnasıdır. Perl gayri resmi olarak saklı tutar
"integer" ve "strict" gibi "pragma" modülleri için küçük modül adları. Başka
modüller büyük harfle başlamalı ve karışık harf kullanmalıdır, ancak muhtemelen
ilkel dosya sistemlerinin modül temsillerindeki sınırlamalar nedeniyle alt çizgiler
birkaç seyrek bayta sığması gereken dosyalar olarak adlandırılır.
· Bir konunun kapsamını veya niteliğini belirtmek için büyük harf kullanımını yararlı bulabilirsiniz.
değişken. Örneğin:
Yalnızca $ALL_CAPS_HERE sabitleri (perl değişkenleriyle çakışmalara dikkat edin!)
$Some_Caps_Here paket çapında global/statik
$no_caps_here işlev kapsamı my() veya local() değişkenleri
İşlev ve yöntem adları, tüm küçük harflerle en iyi sonucu veriyor gibi görünüyor. Örneğin,
"$obj->as_string()".
Bir değişkenin veya işlevin olmaması gerektiğini belirtmek için baştaki alt çizgi kullanabilirsiniz.
onu tanımlayan paketin dışında kullanılır.
· Gerçekten kıllı bir normal ifadeniz varsa, "/x" değiştiricisini kullanın ve bazı
satır gürültüsüne biraz daha az benzemesi için boşluk bırakın. olarak eğik çizgi kullanmayın
normal ifadenizde eğik çizgi veya ters eğik çizgi olduğunda sınırlayıcı.
· Liste operatörlerini parantez içine almak zorunda kalmamak için yeni "ve" ve "veya" operatörlerini kullanın.
ve "&&" ve "||" gibi noktalama operatörlerinin görülme sıklığını azaltmak için. Telefon etmek
aşırı önlemek için alt programlarınızı işlevlermiş gibi veya liste operatörleri gibi
ve işaretleri ve parantezler.
· Tekrarlanan "print()" ifadeleri yerine buradaki belgeleri kullanın.
· Karşılık gelen şeyleri dikey olarak hizalayın, özellikle bir tanesine sığmayacak kadar uzunsa
neyse çizgi.
$IDX = $ST_MTIME;
$IDX = $ST_ATIME ise $opt_u;
$IDX = $ST_CTIME ise $opt_c;
$IDX = $ST_SIZE eğer $opt_s;
mkdir $tmpdir, 0700 veya die "mkdir $tmpdir olamaz: $!";
chdir($tmpdir) veya die "$tmpdir: $ chdir olamaz!";
mkdir 'tmp', 0777 veya die "mkdir $tmpdir/tmp olamaz: $!";
· Her zaman sistem aramalarının dönüş kodlarını kontrol edin. İyi hata mesajları şuraya gitmeli:
"STDERR", soruna hangi programın neden olduğunu, başarısız sistemin neyi çağırdığını ve
argümanlar vardı ve (ÇOK ÖNEMLİ) standart sistem hata mesajını içermelidir
ne için yanlış gitti. İşte basit ama yeterli bir örnek:
opendir(D, $dir) veya die "$dir: $ açılamıyor!";
· Anlamlı olduğunda harf çevirisini sıralayın:
tr [abc]
[xyz];
· Yeniden kullanılabilirliği düşünün. Yapmak isteyebilecekken neden tek seferde beyin gücünü boşa harcayasınız ki?
yine öyle bir şey mi? Kodunuzu genelleştirmeyi düşünün. Bir modül yazmayı düşünün
veya nesne sınıfı. "use strict" ve "use" ile kodunuzu temiz bir şekilde çalıştırmayı düşünün.
uyarılar" (veya -w) etkisinde. Kodunuzu vermeyi düşünün. değiştirmeyi düşünün
tüm dünya görüşü. Düşün... oh, boşver.
· Kodunuzu belgelemeye çalışın ve Bölme biçimlendirmesini tutarlı bir şekilde kullanın. Burada
yaygın olarak beklenen sözleşmeler:
· işlev, değişken ve modül adları (ve daha genel olarak herhangi bir şey) için "C<>" kullanın
kütük tanıtıcıları veya belirli değerler gibi kodun bir parçası olarak kabul edilebilir). Not
işlev adlarının parantez içinde daha okunabilir olduğu kabul edilir.
ad, bu "fonksiyon()".
· gibi komut adları için "B<>" kullanın kedi or grep.
· dosya adları için "F<>" veya "C<>" kullanın. Dosya için tek Pod kodu "F<>" olmalıdır
adları vardır, ancak çoğu Pod biçimlendirici onu italik olarak oluşturduğundan, Unix ve Windows yolları
eğik çizgileri ve ters eğik çizgileri daha az okunabilir ve
"C<>".
· Tutarlı ol.
· Nazik ol.
onworks.net hizmetlerini kullanarak perlstyle'ı çevrimiçi kullanın
