Beefy Boxes and Bandwidth Generously Provided by pair Networks
Clear questions and runnable code
get the best and fastest answer
 
PerlMonks  

Re: Bad Module Code

by QwertyD (Pilgrim)
on Jul 13, 2003 at 20:04 UTC ( [id://273814]=note: print w/replies, xml ) Need Help??


in reply to Bad Module Code

Whether your sub actually returns anything to the caller is one thing, but whether its return value means anything is another.

In the module's documentation, it's fine to either leave out a mention of what the sub returns, or explicitly say that what the sub returns is unspecified. This tells anybody using your sub that they should not rely on anything it returns. This way, in a later version of the module, if you decide that you want to return true, or a status code, or some kind of error message, you can, and you won't break any existing code.

For a little more on this, see the "Specifying semantics" section of Ned Batchelder's essay on interfaces. He uses the term "undefined" instead of "unspecified", but that's just because the languages he usually programs in probably don't have undef.


How do I love -d? Let me count the ways...

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://273814]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others sharing their wisdom with the Monastery: (7)
As of 2024-04-23 13:00 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found