 |
C++Talk.NET C++ language newsgroups
|
| View previous topic :: View next topic |
| Author |
Message |
Hamiral Guest
|
Posted: Tue Mar 14, 2006 10:06 pm Post subject: Documentation STL |
|
|
Bonjour,
Je cherche sur le web mais je ne trouve jamais rien de satisfaisant, alors
je poste ici : connaîtriez-vous une bonne référence pour la STL ? Par
"bonne référence", j'entends une référence facile à utiliser, un peu comme
la fameuse javadoc ... Il doit bien y avoir une documentation en doxygen de
la STL ?
Bien sûr il y a http://www.sgi.com/tech/stl/ qui estbien faite mais jusqu'à
un certain point : j'ai mal à la tête rien qu'en essayant de lire les
documentations des méthodes de std::string, par exemple. Tout est trop
condensé, très mal présenté, bref vous l'aurez compris, ce que je recherche
est une doc claire et facile à utiliser.
Donc, si l'un d'entre vous à ça sous le coude, je suis preneur ...
Et merci d'avance !
--
Hamiral |
|
| Back to top |
|
 |
Fabien LE LEZ Guest
|
Posted: Tue Mar 14, 2006 11:06 pm Post subject: Re: Documentation STL |
|
|
On Tue, 14 Mar 2006 23:00:28 +0100, Hamiral <hamiral (AT) hamham (DOT) fr>:
| Quote: | j'ai mal à la tête rien qu'en essayant de lire les
documentations des méthodes de std::string
|
C'est pas étonnant, vue la tronche de std::string...
Mais je ne comprends pas bien pourquoi tu veux étudier d'un coup
l'intégralité des fonctions membres de std::string. Une référence,
c'est comme un annuaire : on a un besoin précis (contacter Dupont, ou
chercher le dernier 'x' dans une chaîne), on trouve le renseignement
(0123456789 ou find_last_of), et on referme le bouquin.
Si tu es dans une phase d'apprentissage, i.e. tu découvres
std::string, c'est un cours qu'il te faut, pas une référence. |
|
| Back to top |
|
 |
Arnaud Meurgues Guest
|
Posted: Tue Mar 14, 2006 11:06 pm Post subject: Re: Documentation STL |
|
|
Fabien LE LEZ wrote:
| Quote: | Mais je ne comprends pas bien pourquoi tu veux étudier d'un coup
l'intégralité des fonctions membres de std::string.
|
Il demande une doc claire et agréable. Franchement, moi, la réponse
m'intéresse (peut-être sur msdn ?).
--
Arnaud |
|
| Back to top |
|
 |
Sylvain Guest
|
Posted: Wed Mar 15, 2006 12:06 am Post subject: Re: Documentation STL |
|
|
Arnaud Meurgues wrote on 14/03/2006 23:47:
| Quote: | Fabien LE LEZ wrote:
Mais je ne comprends pas bien pourquoi tu veux étudier d'un coup
l'intégralité des fonctions membres de std::string.
Il demande une doc claire et agréable. Franchement, moi, la réponse
m'intéresse (peut-être sur msdn ?).
|
M$ supporte très mal la STL, sa doc dans le MSDN en est à l'image.
entre le cours (qui serait le seul moyen de découvrir) et la référence
(qui servirait à valider ce que l'on a appris et oublié), le "pocket
reference" [1] de OReilly est assez agréable; un peu dans l'esprit
javadoc où l'on peut découvrir et piocher sans déjà connaitre ce que
l'on cherche.
Sylvain.
[1]: http://www.oreilly.com/catalog/stlpr/ |
|
| Back to top |
|
 |
loufoque Guest
|
|
| Back to top |
|
 |
Gabriel Dos Reis Guest
|
Posted: Wed Mar 15, 2006 2:06 am Post subject: Re: Documentation STL |
|
|
loufoque <loufoque (AT) remove (DOT) gmail.com> writes:
[...]
| > Bien sûr il y a http://www.sgi.com/tech/stl/
|
| Il s'agit de la référence de la STL de SGI. C'est pas trop mal mais
| incomplet, et en plus c'est la documentation de l'implémentation de
| SGI avec ses extensions non standard.
|
| La première source de documentation est celle de ton implémentation.
| Donc par exemple soit MSDN [1] si tu utilises MSVC++, soit la doc de
| GCC [2] si tu utilises GCC (ils ont des manpages et des docs doxygen,
| apparemment tu apprécies ce genre de trucs).
L'implémentation de GCC est basée sur celle de SGI (produite par Matt
Austern lorsqu'il travaillait avec Alex Stepanov chez SGI).
[...]
| Enfin tu peux aussi te procurer la norme [1], la version actuelle
| étant à 30 dollars.
ou
http://www.awprofessional.com/bookstore/product.asp?isbn=0201309564&redir=1
qui est plus pédagogique que la norme.
-- Gaby |
|
| Back to top |
|
 |
Fabien LE LEZ Guest
|
Posted: Wed Mar 15, 2006 2:06 am Post subject: Re: Documentation STL |
|
|
On Wed, 15 Mar 2006 01:33:45 +0100, loufoque
<loufoque (AT) remove (DOT) gmail.com>:
| Quote: | et en plus c'est la documentation de l'implémentation de SGI
avec ses extensions non standard.
|
| Quote: | La première source de documentation est celle de ton implémentation.
|
C'est pas mieux, à moins qu'on veuille faire du code spécifique à un
compilo (ou à une SL).
| Quote: | Enfin tu peux aussi te procurer la norme
|
Qu'il trouvera certainement plus lisible que la doc de SGI ;-p |
|
| Back to top |
|
 |
Yoxoman Guest
|
Posted: Wed Mar 15, 2006 9:06 am Post subject: Re: Documentation STL |
|
|
Jean-Marc Bourguet <jm (AT) bourguet (DOT) org> a écrit :
| Quote: | Il y a des docs qui ne sont pas adaptees a l'aprentissage. C'est
souvent le cas pour ce qui se veut une reference complete et examine
donc des details rarement utilises avec autant d'attention que les cas
courants et sans les separer de ceux-ci.
|
Et pour apprendre ces "détails rarement utilisés", on fait comment, sans
ce type de doc ?
--
"Yo!"
Martin Heidegger (trad. Terrence Malick) |
|
| Back to top |
|
 |
kanze Guest
|
Posted: Wed Mar 15, 2006 9:06 am Post subject: Re: Documentation STL |
|
|
loufoque wrote:
[...]
| Quote: | Enfin tu peux aussi te procurer la norme [1], la version
actuelle étant à 30 dollars. On peut obtenir une version de
1997 [2] ou un brouillon de la prochaine version [3]
gratuitement.
|
Je signale à tout hazard, qu'il y a eu d'importantes
modifications dans std::string entre la CD2 (la version de 1997)
et la version finale de la norme. Si j'avais à procurer une
version de la norme aujourd'hui, je crois que c'est la version
papier publié par Wiley : "The C++ Standard", ISBN 0 470 84674-7.
--
James Kanze GABI Software
Conseils en informatique orientée objet/
Beratung in objektorientierter Datenverarbeitung
9 place Sémard, 78210 St.-Cyr-l'École, France, +33 (0)1 30 23 00 34 |
|
| Back to top |
|
 |
Yoxoman Guest
|
Posted: Wed Mar 15, 2006 9:06 am Post subject: Re: Documentation STL |
|
|
Fabien LE LEZ <gramster (AT) gramster (DOT) com> a écrit :
| Quote: | Si tu es dans une phase d'apprentissage, i.e. tu découvres
std::string, c'est un cours qu'il te faut, pas une référence.
|
Ah bon ? Il y a des docs qu'il ne faut pas consulter, si on veut
apprendre ? :-)
--
"Yo!"
Martin Heidegger (trad. Terrence Malick) |
|
| Back to top |
|
 |
Jean-Marc Bourguet Guest
|
Posted: Wed Mar 15, 2006 9:06 am Post subject: Re: Documentation STL |
|
|
Yoxoman <yhpnfyrqber (AT) tznvy (DOT) pbz> writes:
| Quote: | Fabien LE LEZ <gramster (AT) gramster (DOT) com> a écrit :
Si tu es dans une phase d'apprentissage, i.e. tu découvres
std::string, c'est un cours qu'il te faut, pas une référence.
Ah bon ? Il y a des docs qu'il ne faut pas consulter, si on veut
apprendre ?
|
Il y a des docs qui ne sont pas adaptees a l'aprentissage. C'est
souvent le cas pour ce qui se veut une reference complete et examine
donc des details rarement utilises avec autant d'attention que les cas
courants et sans les separer de ceux-ci.
A+
--
Jean-Marc
FAQ de fclc++: http://www.cmla.ens-cachan.fr/~dosreis/C++/FAQ
C++ FAQ Lite en VF: http://www.ifrance.com/jlecomte/c++/c++-faq-lite/index.html
Site de usenet-fr: http://www.usenet-fr.news.eu.org |
|
| Back to top |
|
 |
Guest
|
Posted: Wed Mar 15, 2006 1:06 pm Post subject: Re: Documentation STL |
|
|
Sylvain wrote:
| Quote: | Arnaud Meurgues wrote on 14/03/2006 23:47:
Fabien LE LEZ wrote:
Mais je ne comprends pas bien pourquoi tu veux étudier d'un coup
l'intégralité des fonctions membres de std::string.
Il demande une doc claire et agréable. Franchement, moi, la réponse
m'intéresse (peut-être sur msdn ?).
M$ supporte très mal la STL,
Plait-il ????? |
Arnaud |
|
| Back to top |
|
 |
Fabien LE LEZ Guest
|
Posted: Wed Mar 15, 2006 2:06 pm Post subject: Re: Documentation STL |
|
|
On Wed, 15 Mar 2006 09:44:55 +0100, Yoxoman <yhpnfyrqber (AT) tznvy (DOT) pbz>:
| Quote: | Et pour apprendre ces "détails rarement utilisés", on fait comment, sans
ce type de doc ?
|
On lit effectivement ce genre de doc, quand on a compris les bases du
fonctionnement de std::string, et qu'on a besoin d'un détail. Il
s'agit alors d'une recherche + lecture de quelques lignes, et pas de
la lecture de l'intégralité d'une documentation assez aride. |
|
| Back to top |
|
 |
Arnaud Meurgues Guest
|
Posted: Wed Mar 15, 2006 2:06 pm Post subject: Re: Documentation STL |
|
|
Fabien LE LEZ wrote:
| Quote: | On lit effectivement ce genre de doc, quand on a compris les bases du
fonctionnement de std::string, et qu'on a besoin d'un détail. Il
s'agit alors d'une recherche + lecture de quelques lignes, et pas de
la lecture de l'intégralité d'une documentation assez aride.
|
Mais si la documentation est bien faite et bien présentée, on trouve
plus vite l'information, d'où l'intérêt de trouver une telle documentation.
--
Arnaud |
|
| Back to top |
|
 |
Yoxoman Guest
|
Posted: Wed Mar 15, 2006 5:06 pm Post subject: Re: Documentation STL |
|
|
Fabien LE LEZ <gramster (AT) gramster (DOT) com> a écrit :
| Quote: | On lit effectivement ce genre de doc, quand on a compris les bases du
fonctionnement de std::string, et qu'on a besoin d'un détail.
|
?
C'est écrit où, ça ? Dans la bible ?
| Quote: | Il
s'agit alors d'une recherche + lecture de quelques lignes, et pas de
la lecture de l'intégralité d'une documentation assez aride.
|
Personnellement, j'ai appris beaucoup de choses en parcourant le site de
SGI, sans suivre le schéma que tu décris.
--
"Yo!"
Martin Heidegger (trad. Terrence Malick) |
|
| Back to top |
|
 |
|
|
You cannot post new topics in this forum You cannot reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum
|
|