Глава 5. Соглашения об именах и комментариях 109

while (*p && *р == ' ';

{

Р++;

}

// Если мы достигли конца строки (т. е. все пробелы), // возвращаем пустую строку. if (*р == '\0') return;

// Копируем в результат все с первой буквы имени //до последней перед закрывающей скобкой. 'while (*р && *р !=')') {

*result++ = *р++;

)

// Если мы достигли конца строки, не найдя // закрывающей скобки, то возвращаем пустую строку. if (*р == '\0') {

*result = '\0' ;

return;

}

// Вставляем пробел между именем и фамилией. *result++ = ' ';

// Копируем все символы от первой буквы фамилии //до разделяющей запятой.

while (*string && *string != ',') {

*result++ = *string++;

}

}

// Закрываем результирующую строку. *result = '\0' ;

}

Хотя комментарии внесли некоторую ясность в наш пример, далее в разделе "Именование переменных и функций" вы увидите, что следование соглашениям об именах также улучшает читабельность кода. Тогда вы поймете, что мы несколько переборщили с комментариями к нашему примеру.

Соглашения о комментариях

С правилами комментирования и именования связана одна трудность: излишнее к ним пристрастие. Если вы работаете в крупной программистской фирме, то вполне можете столкнуться с ситуацией, когда объем правил,