Image via Wikipedia

Questo articolo, brevissimo e velocissimo, è per introdurvi il tag pragma mark di Xcode. Il pragma mark rappresenta semplicemente una modalità con cui organizzare la lista dei metodi riconosciuti in Xcode. In un progetto standard, dovreste imbattervi in una lista simile alla seguente:

Se il progetto è piccolo e con pochi metodi, capire ed utilizzare questa lista non dovrebbe  rappresentare alcuna difficoltà. Il problema nasce quando il loro numero cresce fino ad assumere anche l’ordine delle centinaia, rendendo difficile ogni attività di modifica del codice soprattutto all’interno di un gruppo di lavoro. Il pragma mark aiuta proprio nella riorganizzazione dei metodi aggiungendo delle semplici label nella lista di navigazione. Il primo utilizzo possibile è il seguente:

[sourcecode language="objc"]#pragma mark -[/sourcecode]

Con questa linea di codice, aggiungiamo semplicemente una linea spaziatrice orizzontale nella lista (Attenzione! - Dopo il trattino “-” non deve esser inserito alcuno spazio, altrimenti Xcode interpreterà il tutto come una label testuale e non come una linea di separazione).
Il secondo utilizzo è invece il seguente:

[sourcecode language="objc"]#pragma mark label name[/sourcecode]

In questo modo avremo aggiunto una label in grassetto all’interno della lista dei metodi.

Relativamente all’esempio precedente, possiamo inserire il seguente codice:

[sourcecode language="objc"]#pragma mark Initialization Methods
#pragma mark -[/sourcecode]

La lista diventerà la seguente:

Le formattazioni possono ovviamente esser diverse; in particolare, trovo personalmente più comodo inserire prima la linea di separazione e poi la label.

Il pragma mark è un tag molto semplice quanto utile nel lavoro sui progetti medio-grossi. La best practice è però quella di utilizzarlo sempre e comunque, anche per i progetti più piccoli, trovare un proprio stile e una propria metodologia di utilizzo ed applicarla ad ogni progetto. In questo modo, quando veramente diverrà utile, sarete già pronti per utilizzarlo e sarete molto meno soggetti a dimenticanze ed errori.