Russian Qt Forum

Qt => Общие вопросы => Тема начата: alexman от Октябрь 31, 2011, 21:33



Название: Аббревиатуры в названиях.
Отправлено: alexman от Октябрь 31, 2011, 21:33
Возможно, вопрос нубский, но все же.
Пусть в классе есть поле type m_alphaBetaGamma;
Сетер-гетер:
Код:
void setAlphaBetaGamma(const type &value);
type alphaBetaGamma() const;

Заюзаем аббревиатуру abg. Как тогда лучше назвать поле, сетер, гетер?


Название: Re: Аббревиатуры в названиях.
Отправлено: andrew.k от Октябрь 31, 2011, 22:30
В абрбревиатуре регистр игнорируется.
void setAbc()
type abc() const;


Название: Re: Аббревиатуры в названиях.
Отправлено: Alex Custov от Октябрь 31, 2011, 22:36
Самодокументирующийся код - великая вещь, не нужно превращать его в тыр-пыр-дыр ;)


Название: Re: Аббревиатуры в названиях.
Отправлено: alexman от Октябрь 31, 2011, 22:51
Самодокументирующийся код - великая вещь, не нужно превращать его в тыр-пыр-дыр ;)
С этим полностью согласен, но есть устоявшиеся сокращения... Почему бы их не юзать ;)


Название: Re: Аббревиатуры в названиях.
Отправлено: kambala от Октябрь 31, 2011, 23:27
что-то я впервые слышу об устоявшемся соркащении abg как альфа-бета-гамма


Название: Re: Аббревиатуры в названиях.
Отправлено: andrew.k от Октябрь 31, 2011, 23:32
да что вы прицепились. вопрос был в том, как писать устоявшиеся сокращения.
void setHtmlContent()
type htmlContent() const;


Название: Re: Аббревиатуры в названиях.
Отправлено: alexman от Ноябрь 01, 2011, 08:31
что-то я впервые слышу об устоявшемся соркащении abg как альфа-бета-гамма
Это пример! Есть такие ситуации, что сокращения более понятны-наглядны, чем полное написание.


Название: Re: Аббревиатуры в названиях.
Отправлено: alexman от Ноябрь 01, 2011, 08:33
да что вы прицепились. вопрос был в том, как писать устоявшиеся сокращения.
void setHtmlContent()
type htmlContent() const;
Спасибо! Точно, в Qt же так и делают:
Код:
QString QTextEdit::toHtml () const
void QTextEdit::setHtml ( const QString & text )


Название: Re: Аббревиатуры в названиях.
Отправлено: alexman от Ноябрь 01, 2011, 09:30
А в enum как html будет выглядеть?


Название: Re: Аббревиатуры в названиях.
Отправлено: noirhor от Ноябрь 01, 2011, 14:58
А в enum как html будет выглядеть?
Вот же, например:
Код
C++ (Qt)
enum DateFormat { ..., ISODate, ...}


Название: Re: Аббревиатуры в названиях.
Отправлено: andrew.k от Ноябрь 01, 2011, 18:06
Видимо сделали исключение. IsoDate можно не сразу понять. что речь идет об ISO.
а html как не напиши, понятно.


Название: Re: Аббревиатуры в названиях.
Отправлено: noirhor от Ноябрь 01, 2011, 18:17
Видимо сделали исключение. IsoDate можно не сразу понять. что речь идет об ISO.
а html как не напиши, понятно.
Вот еще, например:
Код
C++ (Qt)
enum TimeSpec { LocalTime, UTC, OffsetFromUTC }
Код
C++ (Qt)
enum UIEffect { UI_AnimateMenu, UI_FadeMenu, UI_AnimateCombo, UI_AnimateTooltip, UI_FadeTooltip, UI_AnimateToolBox }