Naming convention in Phobos

foobar foo at bar.com
Sun Mar 6 07:54:07 PST 2011


Andrei Alexandrescu Wrote:

> On 3/6/11 9:27 AM, foobar wrote:
> > Nick Sabalausky Wrote:
> >
> >> "Jim"<bitcirkel at yahoo.com>  wrote in message
> >> news:ikvped$1o35$1 at digitalmars.com...
> >>> Okay, so there's a discussion about identifier names in the proposed
> >>> std.path replacement -- should they be abbreviated or not?
> >>> Should we perhaps seek to have a consistent naming convention for all
> >>> identifier names in Phobos?
> >>>
> >>>
> >>> Some of the potential benefits:
> >>>
> >>> • Legibility, understandability and clarity (reduce ambiguity).
> >>> • Ease in finding a suitable function/class by name.
> >>> • Knowing if it's a cheap or costly function call.
> >>> • Aesthetics and professional appearance.
> >>>
> >>>
> >>> Some properties that I can think of for discussion:
> >>>
> >>> • Abbreviation (and if so, what to abbreviate and how much)?
> >>> • Preference of commonly used terms in other languages, contexts?
> >>> • Use of get and set prefixes or not (getName() or simply name())?
> >>> • Explicit use of a prefix (example: calc or calculate) for costly
> >>> operations?
> >>> • Naming of function and template arguments?
> >>> • Uppercase, lowercase, camelcase, underscore in multi-word names? All
> >>> caps for constants, or different appearance for different types (types,
> >>> functions, arguments, constants...). What about acronyms: TCP, Tcp?
> >>>
> >>> Are there other concerns?
> >>
> >> I think that every individual variable, function and type in Phobos should
> >> use the naming convention of whatever random language the author happened to
> >> be thinking of when they wrote it. That way Phobos won't seem messy. Plus,
> >> the lack of any sensible rules would make it super-easy to remember all the
> >> different spellings, punctuations and capitalizations.
> >>
> >>
> >>
> >
> > I would also add to the above excellent point that in order to prevent unworthy people of programming in the holly
> 
> You have a typo there.
> 
> Andrei

Well than I must be unworthy of the D community. I must flee before you come chasing me with pitchforks...


More information about the Digitalmars-d mailing list