2010-09-30 21 views

Trả lời

114
POD is the official way to do multi line comments in Perl, 

Từ faq.perl.org [perlfaq7]

Cách nhanh chóng-và-bẩn để nhận xét ra nhiều hơn một dòng của Perl là để bao quanh những dòng có chỉ thị Pod. Bạn phải đặt các chỉ thị này vào đầu dòng và một nơi nào đó mà Perl mong đợi một tuyên bố mới (vì vậy không nằm ở giữa các câu như # nhận xét). Bạn kết thúc những nhận xét với =cut, kết thúc phần Pod:

=pod 

my $object = NotGonnaHappen->new(); 

ignored_sub(); 

$wont_be_assigned = 37; 

=cut 

Phương pháp nhanh chóng-và-bẩn chỉ hoạt động tốt khi bạn không có kế hoạch rời khỏi mã nhận xét trong nguồn. Nếu trình phân tích cú pháp Pod xuất hiện, nhận xét nhiều dòng của bạn sẽ hiển thị trong bản dịch Pod. A cách tốt hơn cũng ẩn nó khỏi trình phân tích cú pháp Pod.

Chỉ thị có thể đánh dấu một mục cho một mục đích cụ thể. Nếu trình phân tích cú pháp Pod không muốn xử lý nó, nó chỉ bỏ qua nó. Nhãn nhận xét với comment. Kết thúc nhận xét bằng cách sử dụng =end cùng với nhãn . Bạn vẫn cần =cut quay trở lại để mã Perl từ bình luận Pod:

=begin comment 

my $object = NotGonnaHappen->new(); 

ignored_sub(); 

$wont_be_assigned = 37; 

=end comment 

=cut 
+3

Không cần thiết phải bắt đầu nhận xét với = POD, bạn có thể sử dụng bất kỳ điều gì để bắt đầu nhận xét nhiều dòng (giả sử = xyz v.v.) Nhưng cuối cùng phải luôn có với = cut not even = CUT – Bharat

21

Tôi đã tìm thấy. Perl có nhiều dòng bình luận:

#!/usr/bin/perl 

use strict; 

use warnings; 

=for comment 

Example of multiline comment. 

Example of multiline comment. 

=cut 

print "Multi Line Comment Example \n"; 
+2

giữa '= cho comment' và ' = cut', từ đoạn thứ hai, nó sẽ được hiển thị trong * perldoc *. Vì vậy, chỉ đoạn đầu tiên sẽ được nhận xét đầy đủ từ cả hai mã và * perldoc *. Nếu điều này nên tránh, hãy sử dụng '= bắt đầu nhận xét' ... nhiều dòng/chú thích đoạn ...' = bình luận cuối (* new-line *) = cut'. –

Các vấn đề liên quan