Как называются методы, влияющие на их явные параметры? - PullRequest
0 голосов
/ 02 октября 2010

Я сейчас документирую некоторый код на C ++, и один из методов, которые я собираюсь написать, будет сортировать массив. Он не создаст новый массив, но отсортирует элементы данного массива на месте. Я хочу добавить замечание: «Если исходный порядок был важен для вас, не используйте этот метод!» Но я бы предпочел сказать что-то вроде "сортирует данный массив ... статически?! ... опасно! ... с мутациями !!!" что такие программисты, как вы, смогут понять.

Какое слово описывает этот метод?

Бонусный вопрос : кто-нибудь может порекомендовать инструмент для C ++, который создает HTML-документацию из специально отформатированных комментариев, например, javadoc? Моя операционная система - Ubuntu.

Редактировать : Я студент, и мое задание - сортировать.

Ответы [ 3 ]

8 голосов
/ 02 октября 2010

Сортирует указанный массив на месте .

Вам известны std::sort и std::stable_sort, верно?

3 голосов
/ 02 октября 2010

Разве не очевидно, что функция изменяет параметры, потому что они передаются как не-const ссылки? (Бесстыдная заглушка: см. этот ответ , что означает точный тип параметра.)

И вы ищете Doxygen .

0 голосов
/ 02 октября 2010

Вы уже сказали это: правильный термин "мутатор".

...