etiquetas c

El comando original ctagsya no cuenta con soporte, pero su funcionalidad sigue estando disponible a través de programas similares y posiblemente compatibles. En particular, el formato de datos de etiquetas original aún se utiliza con frecuencia.

El formato original, utilizado frecuentemente con vi y sus clones, así como por los programas descendientes modernos Exuberant y Universal Ctags. ^{[ 6 ]} Un archivo de etiquetas, normalmente llamado "tags", consta de líneas con el siguiente formato:

{ tagname }\ t { tagfile }\ t { tagaddress }

Los campos son:

• {tagname } – Identificador que no contiene espacios en blanco
• \ t – Exactamente un carácter de tabulación ( \ x09 ), aunque muchas versiones de vi pueden manejar cualquier cantidad de espacio en blanco.
• {tagfile } – El nombre del archivo donde se define {tagname }, relativo al directorio actual.
• {tagaddress } – Un comando del modo ex que lleva al editor a la ubicación de la etiqueta. Para protegerse contra la ejecución de comandos arbitrarios (por ejemplo, comandos que modifican archivos), las implementaciones POSIX de vi solo permiten un comando de búsqueda o un número de línea en este lugar.

Las líneas están ordenadas por {tagname }, lo que permite una búsqueda rápida.

El formato utilizado por Exuberant Ctags y Universal Ctags de Vim . Estos programas pueden generar un archivo ctags original o un formato extendido que intenta mantener la compatibilidad con versiones anteriores.

Un archivo consta de líneas con el siguiente formato:

{ tagname }\ t { tagfile }\ t { tagaddress }[;"\ t { tagfield ...}]

Los campos hasta {tagaddress } inclusive son los mismos que para el formato ctags original. Los campos adicionales opcionales (indicados entre corchetes) incluyen:

• ;" – punto y coma + comillas dobles: Finaliza la {tagaddress } de una manera que parece el inicio de un comentario para vi o ex
• {tagfield } – campos de extensión: pares "clave:valor" separados por tabulaciones para obtener más información.

Este formato es compatible con vi que no es POSIX, ya que los datos adicionales se interpretan como un comentario. Sin embargo, las implementaciones POSIX de vi deben modificarse para admitirlo. ^{[ 6 ]}

GNU Emacs viene con dos ctagsvariantes, etagsy ctags, que se construyen a partir del mismo código fuente. etagsgenera un archivo de tabla de etiquetas para Emacs, y ctagscrea un archivo de etiquetas para vi . Algunas opciones (por ejemplo --language) son aceptadas tanto por ctagscomo por etags. Las opciones que solo tienen sentido al generar un archivo de etiquetas al estilo vi no son aceptadas (y por lo tanto se informan como errores) por etags. De manera similar ctags, no acepta opciones que son pertinentes solo para generar un archivo de tabla de etiquetas para Emacs. ^{[ 7 ]}

En Emacs, el archivo de etiquetas se suele llamar "TAGS". Este archivo consta de varias secciones , una por cada archivo fuente de entrada. Las secciones son de texto plano con algunos caracteres ASCII no imprimibles que se utilizan para fines especiales. Estos caracteres se representan como códigos hexadecimales subrayados a continuación.

Una sección comienza con un encabezado de dos líneas (los dos primeros bytes forman un número mágico ):

\ x0c { src_file },{ tamaño_de_los_datos_de_definición_de_etiqueta_en_bytes }

Nota: \ x## representa el byte en hexadecimal ## . Cada línea termina con un salto de línea (LF, \ n = \ x0A ).

El encabezado va seguido de las definiciones de etiquetas, una definición por línea, con el formato:

{ tag_definition_text }\ x7f { tagname }\ x01 { line_number },{ byte_offset }

{tagname} \x01 puede omitirse si el nombre de la etiqueta puede deducirse del texto en la definición de la etiqueta.

Exuberant Ctags, escrito y mantenido por Darren Hiebert hasta 2009, ^{[ 8 ]} se distribuyó inicialmente con Vim , pero se convirtió en un proyecto independiente tras el lanzamiento de Vim 6. Incluye soporte para Emacs y etagscompatibilidad. ^{[ 9 ] [ 10 ]}

Exuberant Ctags incluye soporte para más de 40 lenguajes de programación, con la posibilidad de añadir soporte para aún más mediante expresiones regulares .

Universal Ctags es una bifurcación de Exuberant Ctags, con el objetivo de continuar su desarrollo. Algunos analizadores sintácticos se han reescrito para ofrecer un mejor soporte a los lenguajes. ^{[ 11 ]}

Crea un archivo de etiquetas compatible con ctags para archivos fuente de Haskell . ^{[ 12 ]} Incluye soporte para crear archivos etags de Emacs. ^{[ 13 ]}

Una solución compatible con ctags especializada para JavaScript que utiliza el sistema de empaquetado CommonJS . ^{[ 14 ]} Supera a Exuberant Ctags para código JavaScript, encontrando más etiquetas que este último. ^{[ 15 ]}