Forgive me for a potentially silly question here, but in other programming languages (scripting ones like PHP or Perl) it is often easy to dump everything contained within a variable.
For instance, in PHP there are the var_dump() or print_r() functions. Perl has the Data Dumper CPAN class, etc etc.
Is there something like this for Objective-C? It would be very convenient in a few cases to be able to dump everything like that, instead of using gdb to inspect each variable.
-
Use NSLog() to dump contents of objects. For example:
NSData* myData = //... assume this exists NSLog(@"Contents of myData: %@", myData);NSLog has a printf-style format string (expects an NSString object) followed by a variable list of parameters, just like printf. The replacement character %@ represents an object the description method on an object. This is useful for dumping most Objective-C objects in Cocoa.
If you want to dump the contents of an object using gdb (I see you tagged this with gdb), use the special "po" directive instead of print. For example:
gdb) po myDatawill cause gdb to dump the myData object. po is a shortcut for print-object.
Barry Wark : The string formatted representation (used by NSLog and [NSString stringWithFormat:] et al.) may not be a full "dump" of the object. It is the result of the object's description method. Since objects can override this description, you may varying results from its use.Jason Coco : I know, which is why I said "This is useful for dumping /most/ Objective-C objects in Cocoa" but it is basically what the OP is asking for. -
In Cocoa, there is no "dump" like PHP's print_r or python's repr since there is no textual format that "represents" an object as in those languages. If you use
NSLog(@"%@", myObj);or
NSString *stringRep = [NSString stringWithFormat:@"%@",myObj];or
NSString *stringRep = [myObj description];you will get (logged to console in the first case), the result of
[myObj description], a method defined inNSObjectfor the purpose of printing a description (not a dump) of an object.If you invoke
po myObjin gdb, you get[myObj debugDescription](often the same asdescription, but not always).Classes like
NSArrayandNSDictionaryandNSDataoverridedescriptionto print a pretty useful recursive description of their contents, but the default[NSObject description]prints only the pointer value corresponding to the instance.If you control the code for the types in question, you can override their
descriptionordebugDescriptionmethods to return anything you want. If not, you could override thedescriptionordebugDescriptionmethod using a category, or use a category to define amyDebugDescriptionor some such that you could then invoke from gdb usingpo [myObj myDebugDescription]. -
you can also use the gdb print object command to quickly view an object in the debugger:
po dictionaryThis will be basically the same as calling NSLog(...) from within your code.
Also useful when printing out NSData that contains ASCII data is:
p (char *) [data bytes] -
Be careful with NSLog logging -> you most likely don't want it in production code.
You may want to use an alternate logging function that calls NSLog when your product is running in debug mode.
Phil Nash : This is a good point. I lot of new Objective C programmers don't realise this. If you think of NSLog as being ObjC's printf or std::cout you shouldn't go far wrong (and writing a DLog wrapper macros is trivial).
0 comments:
Post a Comment