2009-05-19 10 views
6

Plus souvent que j'aurais espéré trouver des définitions de méthode/propriété dans la documentation d'Apple qui sont vagues au mieux et dépourvues de sens, pour moi, au pire. Par exemple, prendre la description de la méthode suivante à partir NSNumberFormatter Class Reference:Où puis-je obtenir une meilleure documentation Apple?


setPartialStringValidationEnabled:

Définit si la validation de la chaîne partielle est activée pour le récepteur.

- (void)setPartialStringValidationEnabled:(BOOL)b 

Paramètres

b OUI si la validation de la chaîne partielle est activée, sinon NO.


Donc, supposons simplement que le système éducatif de mauvaise qualité, je suis passé par et tous les projets précédents, j'ai travaillé ne couvrent pas la « validation de chaîne partielle » dans le cacao et je voudrais creuser dans ce un peu plus pour voir ce que cette propriété est tout. Où regarde-t-on (en dehors de Google)? Je déteste pour harceler les forums pour quelque chose que je devrait être capable de rechercher facilement moi-même.

J'ai rencontré des situations comme celle-ci assez de fois maintenant que je pense que je peux mal approcher les documents d'Apple. Aucune suggestion? Conseils & Astuces? Ressources de tiers?

+1

Vous pouvez toujours demander sur IRC;) – Malfist

Répondre

4

Les méthodes Setter sont parfois expliquées plus en détail dans la méthode getter, le texte d'introduction dans la documentation de classe ou l'un des guides d'accompagnement de la documentation que vous voyez en bas à gauche. Parfois, vous pouvez également trouver des indices dans les en-têtes de Cocoa, en cliquant avec le bouton droit sur le nom lorsque vous écrivez du code et en sélectionnant «Aller à la définition».

Sinon, il n'y a vraiment pas d'autre ressource que google, qui demande à ce sujet sur des sites comme celui-ci ou en utilisant une liste de diffusion. Vous pouvez toujours écrire du code pour tester ce qui se passe quand vous changez sa valeur. Et bien sûr, si c'est quelque chose de vraiment déroutant, c'est bien de prendre le temps de déposer un rapport de bogue radar, donc nous espérons qu'il sera amélioré à l'avenir.

+4

Et n'oubliez pas de déposer un bug avec Apple sous la documentation si vous le sentez insuffisant –

5

Validation de chaîne partielle is explained in NSFormatter class.

+0

Maintenant, pourquoi Apple n'a pas pu fournir un lien vers cette information depuis leur "description" de setPartialStringValidationEnabled :? – Meltemi

+2

Je ne sais pas. Peut-être c'est omission, rédacteur en chef du manuel pense que c'est évident ou Apple veut garder le manuel de référence le plus court possible. Chaque page contient "Ce document vous a-t-il été utile?" boîte, et c'est probablement le meilleur endroit pour se plaindre. – Kornel

+3

En outre, la validation de chaîne partielle est mentionnée dans le Guide de programmation de formatage des données. J'ai trouvé que les guides de haut niveau valent au moins un écrémage avant de passer par la documentation de classe – Abizern

Questions connexes