Що не так з cplusplus.com?

Це, мабуть, не ідеально підходящий форум для цього питання, але дозвольте мені спробувати, ризикуючи перенестись.

Існує кілька посилань на стандартну бібліотеку C ++, включаючи неоціненний стандарт ISO, MSDN , IBM , cppreference та cplusplus . Особисто мені під час написання C ++ потрібна довідка, яка має швидкий випадковий доступ, короткий час завантаження та приклади використання, і я вважаю cplusplus.com досить корисною. Однак я часто чую негативні думки щодо цього веб-сайту тут, тому я хочу уточнити:

Які помилки, помилки чи неправильні поради, які дає cplusplus.com? Які ризики використовувати його для прийняття рішень щодо кодування?

Додам до цього моменту: я хочу мати змогу відповідати на запитання тут на SO точними цитатами стандарту, і, таким чином, я хотів би розміщувати негайно використані посилання, і cplusplus.com був би моїм сайтом на вибір, якби не він ця проблема.

Редагувати: Документація на std::removeвиправлена ​​з моменту написання цієї відповіді. Те ж саме стосується і list::remove.

Дозвольте навести приклад, щоб показати вам, як cpluscplus.com може помилитися.

Розглянемо std::removeфункцію від <algorithm>.

Справа в тому, що std::removeвін не видаляє предмет з контейнера. Це тому, що std::removeпрацює лише з парою ітераторів і нічого не знає про контейнер, який фактично містить елементи. Насправді std::removeзнати базовий контейнер неможливо , оскільки немає можливості перейти від пари ітераторів, щоб дізнатися про контейнер, до якого належать ітератори. Тож std::removeнасправді не видаляйте елементи просто тому, що вони не можуть . Єдиний спосіб фактично видалити елемент з контейнера - це викликати функцію члена на цьому контейнері.

Тож якщо ви хочете видалити елементи, тоді використовуйте Стерти-видалити ідіому :

 v.erase(std::remove(v.begin(), v.end(), 10), v.end()); 

Але cplusplus.comдає неправильну інформацію про std::remove. Він говорить

Зауважте, що ця функція не змінює елементи минулого нового кінця, які зберігають свої старі значення та все ще доступні .

що невірно. Ітератор у діапазоні [new_end, old_end)все ще зберігається, але це НЕ означає, що вони зберігають старі значення та все ще доступні. Вони не визначені.

Аналогічно cplusplus.comдає і невірну інформацію про list::remove. Це говорить ,

Зауважте, що функція видалення глобального алгоритму існує з подібною поведінкою, але працює між двома ітераторами.

що абсолютно неправильно. Глобальне видалення std::remove- це не схоже на те list::remove, як ми побачили, що перший НЕ дійсно видаляє елементи з контейнера, оскільки не може , тоді як другий (функція-член) дійсно видаляє елементи, оскільки може .

Ця відповідь скопійована з моєї іншої відповіді в наступній темі, з незначними змінами:

• Видалення STL не працює, як очікувалося?

Примітка: Оскільки я нещодавно натрапив на це, коли відповідав у вищевказаній темі, я пам’ятаю це. Є багато помилок, з якими я стикався протягом останніх двох років, яких я не пам’ятаю. Я можу додати ще декілька пізніше, якщо я знову зустрінусь.

Я збираюся запропонувати свою думку трохи протилежну. На сайті cplusplus.com є багато хорошої інформації. Вибирайте це до смерті, і так, звичайно, у нього є проблеми, але який сайт не має? Звичайно, не цей сайт . Люди, які живуть у скляних будиночках, не повинні кидати каміння. Тут також багато дезінформації. Є прийняті відповіді, які є невірними неправильними, негативними відповідями (деякими негативними!), Які є правильними.

Одне з питань cplusplus.com полягає в тому, що це закритий сайт; те саме стосується більшості інших згаданих довідкових сайтів. Це суперечить зерну сайту, розробленого громадою, такого як Stack Overflow. Набуття здатності вносити довірені зміни не потребуватиме багато часу, і навіть найновіші новачки можуть легко вносити пропозиції щодо вдосконалення. Порівняйте це з cplusplus.com. Ви вічний новачок, якщо ви не в їх штаті. Навіть якщо ви є ключовим членом WG21, вам доведеться пройти механізм звітування електронної пошти, якщо ви побачите помилку десь на цьому сайті. Анатема!

На цьому веб-сайті було б рішення розробити власну довідку C ++. Це займе зовсім небагато роботи. Ми повинні бути обережними, щоб не бути занадто педантичними / занадто технічними; очевидно, що на cplusplus.com працює принаймні кілька технічних редакторів, які тримають педантів у страху. Ми б мали зберігати інформацію добре організованою; Поширені запитання тут недостатньо організовані. Нам також слід бути дуже обережними, щоб не викинути занадто багато прямо зі стандарту; це незаконно.

http://www.cplusplus.com/reference/clibrary/cstring/strncpy/

Не зазначається, що "Якщо копіювання відбувається між об'єктами, які перекриваються, поведінка не визначена". (4.11.2.4 у стандарті C89. У мене немає копії C90 в руці, до чого насправді посилається C ++ 03, але вони повинні відрізнятися лише в таких речах, як нумерація сторінок.)

Документація, надана cplusplus.com, часто є невірною або неповною.

Як тільки такий приклад є, atoiдокументація на cplusplus.com.

atoi
У розділі Return не згадується про 0 повернене значення, якщо перетворення під час використання функції не може бути здійснено.

У розділі " Повернення cplusplus.com " зазначено "... Якщо перетворене значення виходитиме за межі інтерпретабельних значень за допомогою int, це спричиняє не визначене поведінку."

Це правильно, згідно зі стандартом " Якщо числове значення рядка не можна представити в int, тоді поведінка не визначена ".

Однак розділ не є повним, оскільки він не зазначає 0 як повернене значення, що може ввести в оману. Фраза "... конверсія не виконується і нуль не повертається". зустрічається раніше в пункті опису, але важливо мати його у розділі " Повернення ".

Багато зразків вихідних кодів, наведених на cplusplus.com, є невірними.
Багато хто з новачків, які шукають ці посилання, призводять до помилок.

Навести приклад:

EDIT: Приклад, який я наводив раніше, був невірним.

Документація для type_infoспроб спочатку пояснити typeid, але не вдається:

typeid може застосовуватися безпосередньо до типів, і в цьому випадку він повертає свою інформацію; Або об'єктам, і в цьому випадку він повертає інформацію про тип об'єкта.

Коли typeid застосовується до відміненого вказівника на об'єкт поліморфного типу класу (клас, який декларує або успадковує віртуальну функцію), він враховує його динамічний тип (тобто тип найбільш похідного об'єкта).

Тепер другий абзац вже не погоджується з першим. В typeid(*ptr), typeidзастосовується до виразу. Це досить важливо, оскільки поняття staticі dynamicтипи мають сенс лише в контексті вираження, а не в об'єктах. Він також пропускає подібні випадки typeid(foo()).

Крім того, другий абзац не містить посилань. Вони також можуть мати статичні типи, відмінні від динамічного типу об'єкта, на який вони посилаються.

Документація std::pair<T1,T2>::operator==говорить, що обидва елементи перевіряються на рівність. Документація std::pair<T1,T2>::operator<говорить, що другі елементи розглядаються лише за умови, що перші елементи рівні.

Слово "рівний" з'являється в обох випадках. І все-таки лише в першому випадку це дійсно означає T::operator==. У другому випадку рівні засоби!(a.first<b.first || b.first<a.first)