Perl編程格式指南
本文和大家重點討論一下Perl編程格式方面的內容，Perl是一種編程語言，掌握了Perl編程格式你就會在使用Perl語言進行編程的過程中保持程序結構的嚴謹和美觀，相信本文介紹能讓你學到很多知識。
Perl編程格式指南
名稱
P5EEx::Blue::perlstyle-P5EE樣式指導P5EE是Perl5EnterpriseEnvironment(企業型Perl5樣式指導）的縮寫。
Perl編程格式介紹
在P5EE發行版中,包含的所有代碼和文件都遵循了本文所述的樣式。請注意：這些樣式并不是要抑制你的創造力，而是想要使那些閱讀到你代碼的家伙們的生活變得更容易一些。他也可以用來解決分歧，避免個人間糾紛。下面的這些約定適用于perl模塊，web程序（CGI/mod_perl）以及命令行程序。當然，這些規則也在一定程度上適用于用P5EE寫的perl代碼。
注意，這些都是指導性的方針，不是必須遵守的規則。如果在這里你真的需要違反其中一條的話，無論如何，***先問問P5EE核心團隊。另外，本文檔中的大部分，并不是強調正確的方法就是我們的方法。我們需要有一些約定來讓每個人的生活更容易一些。如果你有什么問題，可以在P5EE開發郵件列表中詢問，p5ee@perl.org.http://lists.perl.org/showlist.cgi?name=p5eeP5EE項目所需文件在下面這些網站上可以找到。http://p5ee.perl.org/http://www.officevision.com/pub/p5ee本文檔將隨時間不斷更新，每份***的文檔結尾，都會有歷次版本的變動記錄。
Perl編程格式之Perl編碼規則
Perl版本
我們是在perl5.005_03上編寫所有代碼的。也許有一天我們應該利用以下perl5.6的特性。不管怎樣，所有代碼應該在perl5.005_03以及后續版本上都能運行。P5EE所有的核心代碼都在perl5.005_03和perl5.6.0上測試過，雖然現在P5EE用在perl5.6上比較多。
Perl編程格式之文檔
所有的模塊文檔都應參照模塊模板文件中的POD例子來撰寫，解釋模塊的方法，目的，用途和每個帶有名字，描述，輸入，輸出，受影響因素等信息的公用API。文檔中，如果需要返回一個數組或哈希表的引用，要記錄數組的大小（包括恰當地描述每個元素都是什么）和哈希表中每個鍵的名字。如果是復合數據結構的話，盡量描繪出合適的結構。另外，在文檔中還要記錄出返回數據是什么類型的數值。是整型，還是一段HTML代碼，還是一個布爾值？所有命令行程序的選項都要使用命令行程序樣本文件中的代碼來記錄。每個有效的方法，switch結構等等都要被記錄，連同方法的描述，目的，程序如何使用。不要嘗試對不同目的的程序使用相同的選項。對于所有的WEB程序，應當在程序注釋段中說明功能，目的和使用。任何外部文檔，命令行程序和模塊的文檔都要寫成POD樣式。這樣的話，我們就可以把它們通過多種pod2xxx的轉換器轉換成各種格式的其他文檔。
POD不是一種正規的標簽語言，它只是一種可以讓文檔非常容易轉換成其他格式的方法。如果你有什么問題的話，可以自己看一下Perl自帶的perlpod幫助頁或者詢問我們及其其他懂POD的人。Perl中國推廣組的FPC里面，也有一篇[[fayland]]所寫的關于[[如何撰寫POD]]的文章。
Perl編程格式之版本
分別使用模塊，web程序，命令行程序樣本文件中版本的代碼。模塊中的$VERSION將會反映出CVS的版本。Makefile.PL文件應該包含版本描述，并且還應該不依賴于CVS倉庫中任何一個單獨文件的版本。同樣，擁有$VERSION的XS模塊也會反映出發行版的版本，否則每當你對文件做了一點改動，你都需要重新編譯那些已經共享的庫。這對于從事開發工作中的人來講，的確是一種痛苦。我們的發行版本號使用tuples模式，***個數字是主修訂號，第二個數字是版本號，第三個數字是子版本號。Odd-numbered版本號是開發版本。例如：
【編輯推薦】
