Как назвать функцию, которая создает результаты с фиксированной точкой на своих входных данных?

#api #naming-conventions #decorator #naming #api-design

#API #соглашения об именовании #декоратор #присвоение имен #api-дизайн

Вопрос:

У меня есть функция, которая украшает строку. Если оформленная строка снова передается в функцию, она гарантированно не изменится. Каково стандартное соглашение об именовании для такой функции? Вероятно, я создам пространство имен, потому что мне нужно иметь несколько таких функций.

Я придумал:

 repetition_safe.decorate(me);
fixpoint_gen.decorate(me);
one_time_effect.decorate(me);
  

но мне на самом деле не нравится ни одно из них.

Как бы вы назвали пространство имен или функцию?

Ответ №1:

Как насчет:

 StringDecorator.MakeImmutable(input);
  

Я думаю, что «MakeImmutable» лучше, чем «Decorate», поскольку последнее неоднозначно, т. е. пользователь, читающий код, не будет знать, что делает «decorate», тогда как «makeImmutable» сообщит пользователю, что эта функция сделает входную строку неизменяемой / неизменяемым.