xuất khẩu vs export_ok trong perl

Question

Tôi không thể hiểu trường hợp khác biệt/sử dụng của EXPORT_OK so với EXPORT là gì.
Hầu hết các nguồn lực đề cập đến điều gì đó trong dòng:

@Export cho phép xuất khẩu các chức năng và các biến của mô-đun để namespace của người dùng bằng cách sử dụng phương pháp nhập khẩu tiêu chuẩn. Bằng cách này, chúng tôi không cần phải tạo các đối tượng cho các mô-đun để truy cập các thành viên của nó.
@EXPORT_OK thực hiện xuất biểu tượng theo yêu cầu cho danh sách có chọn lọc các ký hiệu (chương trình con và biến) của mô-đun.

Nhưng tôi thực sự không thấy sự khác biệt/ý nghĩa ở đây.
Có thể ai đó vui lòng cung cấp một ví dụ cơ bản nhỏ về sự khác biệt/cách sử dụng của 2 biểu tượng này không?

Answer 1

Từ fine Exporter manual:

• use YourModule;
  này nhập khẩu tất cả các biểu tượng từ YourModule của @EXPORT vào không gian tên của sử dụng tuyên bố.
• use YourModule();
  Điều này làm cho perl tải mô-đun của bạn nhưng không nhập bất kỳ ký hiệu nào.
• use YourModule qw(...);
  Điều này chỉ nhập các ký hiệu được liệt kê bởi người gọi vào không gian tên của chúng. Tất cả các biểu tượng được liệt kê phải nằm trong số @EXPORT hoặc @EXPORT_OK của bạn, nếu không có lỗi xảy ra. Các tính năng xuất khẩu nâng cao của Nhà xuất khẩu được truy cập như thế này, nhưng với các mục danh sách khác biệt về mặt cú pháp với các tên biểu tượng.

Vì vậy, nếu bạn sử dụng @EXPORT và ai đó thông thường use YourModule;, sau đó bạn vừa ô nhiễm không gian tên của họ với tất cả mọi thứ trong @EXPORT. Tuy nhiên, nếu bạn sử dụng @EXPORT_OK, họ phải yêu cầu cụ thể cho những thứ được nhập để người dùng mô-đun của bạn có quyền kiểm soát những gì xảy ra với không gian tên của họ.

Sự khác biệt thực sự là một vấn đề của người kiểm soát những gì được vào không gian tên các use r của: nếu bạn sử dụng @EXPORT sau đó các module là use d không, nếu bạn sử dụng @EXPORT_OK sau đó mã làm việc nhập khẩu điều khiển không gian tên riêng của họ.

Tất nhiên, bạn luôn có thể nói use Whatever(); để giữ mô-đun bất lịch sự làm ô nhiễm không gian tên của bạn nhưng điều đó rất xấu và bạn không cần phải kludge xung quanh mã thô lỗ muốn viết nguệch ngoạc trên không gian tên của bạn.

Answer 2

Giả sử tôi có gói MyPackage sử dụng @EXPORT.

#this is MyPackage.pm 
package MyPackage; 
@EXPORT = qw(do_awesome_thing); 

sub do_awesome_thing { ... } 

sub be_awesome { ... } 

Bây giờ, khi tôi sử dụng MyPackage trong mã của tôi,

#this is myscript.pl 
use MyPackage; 

do_awesome_thing(); #works 

be_awesome(); #doesn't work 
MyPackage::be_awesome(); #works 

do_awesome_thing được tự động xuất khẩu sang mã của tôi từ MyPackage, mà không có tôi phải nói "đưa cái này cho tôi". be_awesome không được xuất khẩu (và nó sẽ không được xuất khẩu với @EXPORT_OK hoặc là, tôi chỉ hiển thị phần đó để giúp bạn rõ ràng về những gì "xuất khẩu" cung cấp cho chúng tôi).

Mặt khác, nếu tôi có một gói MyOtherPackage sử dụng @EXPORT_OK,

#this is MyOtherPackage.pm 
package MyOtherPackage; 
@EXPORT_OK = qw(do_awesome_thing); 

sub do_awesome_thing { ... } 

sub be_awesome { ... } 

và sau đó thử

#this is mynewscript.pl 
use MyOtherPackage; 

do_awesome_thing(); #doesn't work 
MyOtherPackage::do_awesome_thing(); #works, as always 

dòng gọi do_awesome_thing trực tiếp sẽ không hoạt động. Điều này là do việc đặt nội dung nào đó vào số @EXPORT_OK cho biết "chỉ cung cấp cho người dùng của tôi nếu họ yêu cầu". Vì chúng tôi vừa nói use MyOtherPackage mà không yêu cầu một cách rõ ràng cho do_awesome_thing để được nhập ở đây, nó không được nhập và chỉ có thể truy cập bằng cách chỉ định tên gói.

Cách bạn yêu cầu nhập do_awesome_thing để nói use MyOtherPackage qw(do_awesome_thing) ở dòng thứ hai là mynewscript.pl ở trên. Điều này cho biết nhập mô-đun đó và thực hiện trực tiếp do_awesome_thing. Sau đó, dòng thứ tư trong số mynewscript.pl ở trên sẽ bắt đầu hoạt động.

Lưu ý rằng người dùng có thể chỉ định use MyPackage qw(do_awesome_thing) với gói đầu tiên và trong trường hợp đó, bất kỳ điều gì khác trong danh sách @EXPORT sẽ không được xuất, chỉ do_awesome_thing sẽ là. Vì vậy, ngoại trừ trường hợp mặc định là use PackageName;, @EXPORT và @EXPORT_OK hoạt động tương tự. Trong trường hợp mặc định, mọi thứ trong @EXPORT được tự động nhập vào tập lệnh của người dùng, trong khi @EXPORT_OK lịch sự hơn và không xuất bất kỳ thứ gì.