Beefy Boxes and Bandwidth Generously Provided by pair Networks
"be consistent"

(tye)Re2: Frivolous function names

by tye (Sage)
on Dec 09, 2001 at 02:46 UTC ( #130472=note: print w/replies, xml ) Need Help??

in reply to Re (tilly) 2: Frivolous function names
in thread Frivolous function names

Unfortunately WaitingFor is not a noun and so violates our coding standard for class names (which would probably lead to confusion even if we told the coding standards to take a flying leap in this case). We came up with other similar names that seemed clear but weren't nouns as well.

For some reason, phrases were bouncing around in my head today:

"We always summon our man!"

Captain: "What are we going to do about this criminal?"
Officer 1: "I'm going to summon him!"
Officer 2: "I'm going to get him!"

"I summoned the daemon."
"Did you get him?"
"No, it didn't work"

Although "summon" denotes exercising authority, it also denotes letting the person that you seek decide whether or not to respond to that authority. It isn't an action, it is a request. Summon might even denote an asynchronous request to me where you issue the summons and then come back later to see whether anything responded.

And I'm used to "get methods" being accessor methods for object attributes which are things you usually don't expect to fail.

On the other hand, a "find" method implicitly means "try to find" for some reason. I guess because "to find" implies a non-trivial amount of work is involved and so it is unreasonable to rule out failure.

Yeah, naming is one of the least rewarding parts of programming, while it can be surprisingly tricky, time-consuming, and important.

        - tye (but my friends call me "Tye")

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://130472]
[Sinistral]: stonecolddevin / stevieb - would 'he' in this context (looked at last 50 lines and didn't see discussion) be a certain solar timepiece user?
[stonecolddevin]: Sinistral yes indeed
[Discipulus]: he does not learn, nor teach, nor learn
[planetscape]: hello all
[stonecolddevin]: o/ planetscape
[Sinistral]: I think that just the sight of his username now causes a downvote storm. I agree, and the gratuitous use of formatting does make reading hard. I've given him +1 on things where there seemed to be actual good advice, but I think the big
[Sinistral]: nail in coffin was the rant against a Schwarzian Transform
[stonecolddevin]: at best, from what i've seen, his knowledge is accurate up to maybe 2002. the sheer volume of words is mostly worthy of a downvote in most cases though i think
[erix]: ITYM Schwartzian Transform :P
[erix]: hey planetscape :)

How do I use this? | Other CB clients
Other Users?
Others studying the Monastery: (10)
As of 2017-06-22 20:52 GMT
Find Nodes?
    Voting Booth?
    How many monitors do you use while coding?

    Results (530 votes). Check out past polls.