Простой пример

Вот пример, показывающий, как вызвать NSLog:

NSString *outputData = @"A quick brown fox jumps over a lazy dog!";

NSLog( @"text: %@", outputData );

/* Comment:

    @"text: %@" - is the printf style formatting template for output (an NSString *)

    outputData - refers to to the text we wish to display (also an NSString *)

*/

И, вот то, как появится вывод:

text: A quick brown fox jumps over a lazy dog!

Усовершенствованные подробные данные

Определение для NSLog функция появляется следующим образом:

void NSLog(NSString *format, ...);

Обратите внимание на то, что первый параметр является строкой форматирования, и он может содержать специальные маркеры замены, подразумевающие, что дополнительные параметры ожидаются после этого. Если уход и внимание не взяты, чтобы гарантировать, чтобы содержание строки формата совпало с остающимися параметрами, Ваше приложение может отказать (или, по крайней мере, это выведет неприменимые данные к консоли).

Как printf функция, NSLog маркеры замены использования; однако, существует один дополнительный маркер замены, доступный в Objective C, %@, используемый, чтобы указать, что его соответствующий параметр должен быть объектом Objective C.

В дополнение к %@ маркер замены, весь постоянный клиент printf маркеры замены стиля доступны для Вашего использования. Для получения дополнительной информации о маркерах замены, используемых NSLog посмотрите раздел «String Format Specifiers» «Строкового Руководства по программированию».

Логика и ветвление

Добавление журналирования операторов в логике Вашего кода поможет Вам понять, какие части выполняются и который переходит в Вашей логике, используются. Часто полезно наперчить особенно сложные последовательности кода с операторами журнала, таким образом, можно просто понять поток выполнения во время выполнения.

Уникальный и простой найти текстовые образцы

В каждом операторе журнала полезно включать некоторых уникальных и простых найти текстовый образец поэтому при идентификации проблемы в том операторе журнала, можно легко перерыть исходные файлы и найти его расположение.

Значения переменных и значения свойств

Печать значений переменных и значений свойств в ключевых местах во время выполнения Вашего приложения позволит Вам проверять, что те значения в приемлемых границах. Ошибка печати обменивается сообщениями в Ваших журналах, явно говорящих Вам, когда значения вне диапазона, поможет Вам распознать эти случаи.

В дополнение к %@ маркер замены, весь постоянный клиент printf маркеры замены стиля могут использоваться в строке форматирования. Это позволит Вам отображать много различных видов значений. Для получения дополнительной информации о маркерах замены, которые могут использоваться с NSLog посмотрите раздел «String Format Specifiers» «Строкового Руководства по программированию».

double myNumber = 7.7;

NSLog(@"number: %@", @(myNumber));

Распечатает:

number: 7.7

Этот метод работает со всеми числовыми типами, о которых компилятор знает (целое число со знаком или целое без знака или числа с плавающей точкой любого размера - 8, 16, 32 или 64 бита), и будут любые необходимые приведения типа для Вас, не генерируя предупреждений компилятора.

Кого вызывают?

В анализе работы Вашего приложения может быть критически важно для Вас знать последовательность, в которой вызовы выполняются к функциям или методам в Вашем приложении. В этих случаях это - действительно хорошая идея добавить NSLog оператор около начала Вашего метода и функциональных определений, который просто распечатывает имя функции:

- (void)pressButton:(id)sender

{

    NSLog( @"calling: %s", __PRETTY_FUNCTION__ );

    ....

Здесь, предопределенная переменная времени компиляции __PRETTY_FUNCTION__ (строка стиля C), используется для печати имени вызванной функции. Этот метод особенно полезен, когда Вы анализируете код с помощью большого количества делегатов, и требуется понять последовательность, в которой вызовы выполняются к методам делегата.

Вышеупомянутое распечатает следующее в консоли:

calling: -[MyObjectClassName pressButton:]

Зарегистрируйте след своего штабеля!

При исследовании крешлогов след штабеля неоценим для выяснения цепи событий, приведшей к любому определенному обстоятельству. При использовании NSLog для отладки можно получить копию текущего следа штабеля в любое время путем вызова NSThread -callStackSymbols метод класса. След возвращается как NSArray из строк и можно использовать NSLog вместе с %@ маркер замены для вывода следа к консоли:

NSLog(@"%@", [NSThread callStackSymbols]);

И, вот пример того, на что похож вывод вышеупомянутого оператора:

2014-04-30 18:44:30.075 AVCustomEdit[52779:60b] (

 0  AVCustomEdit      0x0000efa6 -[APLSimpleEditor buildCompositionObjectsForPlayback:] + 278

 1  AVCustomEdit      0x0000686e -[APLViewController viewDidAppear:] + 590

 2  UIKit             0x007a4099 -[UIViewController _setViewAppearState:isAnimating:] + 526

 3  UIKit             0x007a4617 -[UIViewController __viewDidAppear:] + 146

 4  UIKit             0x007a49aa -[UIViewController _executeAfterAppearanceBlock] + 63

 5  UIKit             0x0069f0d0 ___afterCACommitHandler_block_invoke_2 + 33

 6  UIKit             0x0069f055 _applyBlockToCFArrayCopiedToStack + 403

 7  UIKit             0x0069ee9a _afterCACommitHandler + 568

 8  CoreFoundation    0x029db2bf __CFRunLoopDoObservers + 399

 9  CoreFoundation    0x029b9254 __CFRunLoopRun + 1076

 10 CoreFoundation    0x029b89d3 CFRunLoopRunSpecific + 467

 11 CoreFoundation    0x029b87eb CFRunLoopRunInMode + 123

 12 GraphicsServices  0x0318b5ee GSEventRunModal + 192

 13 GraphicsServices  0x0318b42b GSEventRun + 104

 14 UIKit             0x00681f9b UIApplicationMain + 1225

 15 AVCustomEdit      0x000026bd main + 141

 16 libdyld.dylib     0x0269e701 start + 1

)

Макрос препроцессора DEBUG в XCode

Препроцессор макрос «DEBUG» определяется во всех шаблонах проекта XCode для сборок отладки. Макросы препроцессора интерпретируются во время компиляции, и макрос препроцессора DEBUG может использоваться, чтобы позволить коду отладки быть выполненным в сборках отладки Вашего проекта. Если Вы не уверены, что Вашему проекту определили его, можно проверить, что это это путем выбора проекта в XCode и щелчка по вкладке настроек сборки. Поиск Предварительной обработки и удостоверяется, что DEBUG=1 определяется для Ваших сборок отладки (как показано рев). Если это уже не определяется в Вашем проекте, можно добавить его. Макросы препроцессора чувствительны к регистру.