Proposal for std.path replacement
spir
denis.spir at gmail.com
Fri Mar 4 06:27:32 PST 2011
On 03/04/2011 12:01 PM, Jonathan M Davis wrote:
>> I have a preference for the longer names, but not a very strong one. I'm
>> > not going to oppose the changes if others agree with you.
> I definitely like descriptive names, and my function names are often long, but I
> do tend to find that long names can get annoying - especially if you have to use
> them often. So, I think that you should generally choose shorter names as long
> as they are appropriately descriptive. A name like stripExt is clear enough -
> especially in context - to work quite well, so the longer name stripExtension is
> unnecessary, whereas ext may not be clear enough and the full name extension
I tend to agree with you.
Especially on the point that (very) common names can be shorter. On one hand,
they are more easily inderstood & memorised precisely because they are common;
on the other, you get the maximum benefit in terms of user-friendliness for the
same reason (that they are common). Abbreviating more rare names makes the code
harder to understand for (very) few benefit.
Now, is stripExt/stripExtension that common? I would say no. The day you need
it, you may have to write it several times because you're dealing with a piece
of code that copes with file names. Right, then, you may like it be shorter.
But this "pain" will soon stop; and maybe, probably?, you won't have again to
write that name for weeks or months. What do you think?
Another factor is the inherent clarity of the abbreviation. 'ext' can certainly
be interpreted in various ways. As you say, context helps much; but it's a
decisive argument for languages in which context prefixes, such as module
names, are commonly used: eg "path.stripExt(fileName)". But this is not common
practice in D, thus func names need be more precise, I guess.
Denis
--
_________________
vita es estrany
spir.wikidot.com
More information about the Digitalmars-d
mailing list