GCC - The Complete Reference (537669), страница 36
Текст из файла (страница 36)
-о гыа Вставляет комментарий сахс перед обьяепением класса С+а. Этв опция игнорируется при указании опции -Чпг. -ргарапе Сахт В ОХБ системно-ориентированные (паггче) методы для языка(ача могут разрабатываться с использованием интерфейсов СттЧ ("С++ (х(аг(че 1пгегГасе") или ЛП ("суплцз )х1аг(че 1пгегГасе"). Утилита дсзлс считывае~ файлы-классы в байт-коде Гара н генерирует заголовочные файлы ((теаг(ег В!ез) интерфейса СМ или 5М и заготовкя файлов реализации системно-ориентированных методов (егиь-4айлы, англ.
"згць"— "обрубок" ). Заголовочные файлы стандарта СМ предназначены для их включения в программы на языке С++, интерфейс 3М используется программами на С. Опция -всцьв применяется для генерации "болванок" — заготовок исходных файлов, лгиЬ- файлов на языках С и С++, используемых для реализации системных методов с использованием )М или СМ. Таблица 8.4 представляет список поддерживаемых программой исззз опций командной строки. 164 Часть И. Использование Сборного Компилятора По этой опции вместо заголовочных файлов вырабатываются этос- файлы, заготовки для кода реализации.
Создаваемые файлы имеют то же имя, что и обрабатываемый дача-класс, но с сУффиксом . сс. При указании опции -5с1 они будут иметь суффикс . с. Указавает имя каталога дпя хранения временных файлов. Выводит во время обработки дополнительную описательную информацию. То же, что --техьсее. Выводит во время обработки дополнительную описательную информацию.
То же, что чю По этой опции программа дсзь только выводит номер своей версии и ма этом завершает работу. -вт яьв -ьа эз эсссху -техвоэе --техв1ся Входной информацией для дс5Ь является один файл или более в формате классов интерпретатора Л'М. К примеру, следующая команда считывает файл-класс уата с именем Врапд1ех. с1авв и создает файл-заголовок Врапд1ех. Ь, пригодный для определения системно-ориентированных методов класса уауа на языке С++: д дс5Ь врапд1ех Другая команда считывает файл Врвпд1ег. с1авв и вырабатывает начальный исходный файл Зрапд1ех. сс, содержащий интерфейс с классом уауа, Этот файл-заготовка далее может редактироваться и использоваться как исходный код на языке Сч-+.
$ дс5ь -асцьв враид1ех следующая команда генерирует интерфейсный файл-заголовок Врапд1ех .ь для дальнейшей реализации системных методов класса Врапд1ех. с1авв на языке С: 9 дс5Ь -5п1 Врапд1ек д дс5ь -5в1 -всаЬв врапд1ех Примеры использования утилиты дс5Ь для комбинирования в одной программе кода на языках С и С++ с кодом на языке уота содержатся в главе В1 1с1-дцар Утилита з об-ттцвтр выводит информацию о содержимом файла класса интерпретатора Л М. В зту информацию также включается полный список значении й используемых констант, список родительских классов, интерфейсов, полей и методов.
Таблица 8.5 представляет список опций этой утилиты. Дальнейшая команда вырабатывает заготовку исходного файла Врапд1ех. с, содержащий интерфейс с классом lата. Этот файл-заготовка далее может редактироваться н использоваться как исходный код на языке С. Таблица 8.5. Список опций утилиты )с5-дцптр — Ьпогс1вввракь=рпгв — 5 ахар -о В11в --твгЬове -чегв1оп Вот пример. Следуюгцая команда выведет дами внутренней информации класса виирм111ц.
С1авв в файл с именем втв. стшпрш Ф 5ст-аптвр Виирн111п.с1авв -о вш.апир ~ч-кап Утилита бп-всап считывает и анализирует содержимое одного или более исходвых файлов на языке дауа и выводит информацию об исходном коде. Таблица В.б содержит список поддерживаемых этой программой опций. Таблица 8.6. Опции утилиты )у-эсап -сопр1ех1ку — впсоаспя=пате -Ье1р — 11вк-с1авв †)свг-111впппе -с1аввраьв=реев — СЬКВВРАтв=рвел -Ьезр -тасгескогу Глава В. Компиляция программ на языке бака 1 б5 Замещает значение системной переменной сььвврътл.
Транслирует байт-код методов дама на язык С. Назначает путь рвгь к каталогу для поиска файлов классов Цвкв. Назначает путь к каталогу для поиска файлов классов Цвкв. Выводит этот список опций и завершает работу 5сс-аопр. Добавляет укаэанное имя каталога а1гесгпгу к переменной сьлвярьен. Вырабатывает вывод в том же формате, что и утилита 5ачвр. Инструмент 5пчар поставляется корпорацией Вцп М)сгоэуэ1егпэ в составе стандартного дистрибутива Цвуа.
Направляет выход вместо стандартного устройства вывода в файл с указанным именем. Выводит дополнительную описательную информацию. То же, что -чегЬовв. Выводит дополнительную описательную информацию. То же, что опция -ч. по этой опции программа 5сс-аппр выводит номер своей версии и завершает работу. Выводит показатель сложности ()паек о1 сус1огпа1)с согпр)ехну) для каждого класса. Он представляет собой число, которое высчитывается особым образом. При этом управляющий поток анализируется для построения графа, далее происходит подсчет узлов, связей и вызовов внешних компонентов. Указывает стандарт кодировки символов, который следует применять при считывании исходных файлов. По умолчанию применяется набор огг-в.
Выводит этот список опций и завершает работу 5ч-всап. Выводит имена классов, определения которых содержатся в файлах, перечисленных в команде. В сочетании с опцией --11вь-с1ввв дополнительно выводит для каждого класса имя содержащего его файла. 16б Часть й. Использование Сборного Компилятора Олова -и ЕЕ?е — рг1яг-лп1п --гегв1оп ~ч-сопчег1 Утилита Зг-сопхгегс служит для перекодировки строчных символов из одного стандарта в другой. По умолчанию программа получает информацию со стандартного устройства ввода, но может и обрабатывать файл, если он указан в командной строке первым или как параметр опции -1. Выход программы направляется на стандартное устройство вывода, либо в файл, если имя для него указано вторым в командной строке или в параметре опции -о.
Список опций утилиты зч-сопчехс предоставляет таблица 8,7, Таблица 8.7. Список опций утилиты )у-сопуегт --епсод1пд=пепл — Егол пеле Вводит этот список опций. Имя входного файла. Назначает нмя дпя выходного файла. Выводит номер версии утилиты 1г-сачегш — гегв1оп Следующий пример команды преобразовывает содержимое файла Р1ехнц?а. цп3. из Т)п?со??е в 8-битную кодировку и записывает его в файл Р1егнпв?. 5ахга в формате исходного кода на языке зара, применяя езсаре-последовательность "? п" для представления расширенных символов Ьп?со??е: 3 бг-сспгегс --егол ?гера ? -бо аачавгс Р1егнщв.пп1 Р1вгнша.зара Доступные форматы кодировки перечислены в таблице 8.8.
К сожалению, рассматриваемая утилита не имеет справочной опции для вывода списка поддерживаемых ею кодировок, а он может (и должен) со временем расти. Для того, чтобы точнее узнать о возможностях вашей версии утилиты бу-сопгегс, загляните в исходный кол. В исходном дереве ССС в каталоге дсс/11ЬЗ ахга/дпп/ дсб/сопхгегс находятся файлы с форматом имен хприс *.с и Оисрцс *.с. После --Ье?р -1 Е11е -о Е11е — гечегве --го пеле Направляет выход программы в указанный файл вместо стандартного устройства вывода. Выводит имена классов, имеющих методы, обьявпвнныв как рпь11с вьаь1е то16 ле1п(]. Выводит номер версии программы зг-всея н завершает вв работу.
Имя кодовой таблицы дпя входных данных, По умолчанию используется кодировка, установленная в системе в качестве основной. То жв, что и опция --Егол. Имя кодировки дпя входных данных. Пс умолчанию используется установленная в системе основная кодировка. То жв, что н опция --Егол. Обращает установки опций --егел н --го. Имя кодовой таблицы дпя выходных данных.
Пс умолчанию применяется авхввгщ то есть стандартный набор АЗСП с шестнадцатиричным представлением расширенных символов цвсобв с помощью езсарв-последовательности в форме Хпхххх. символа подчеркивания в именах таких файлов стоит имя формата кодировки, поддерживаемой для ввода и вывода соответственно. В процессе преобразования в качестве внутренней промежуточной кодировки используется ).)п)сос)е. Так что для конвертирования используются соответствующие направлению преобразования пары МадуЛЕй 1Прис * И Оцсрцг а. УЧтИтЕ, Чта НЕКОтОрЫЕ ИЗ СОЧЕтаНИй МОГУГ бЫтЬ дО- ступны не на всех платформах.
Таблица 8.8, Форматы для перекодировки файлов утилитой 'ч-сопчегт эттэ Ягер~аг Утилита дгерЗ ах выполняет поиск строк в файлах . 1аг на соответствие заданному регулярному выражению. Она выводит имена файлов архива зауа и те строки этих файлов, в которых обнаружены соответствия регулярному выражению. Поясх ведется во всех файлах определенной в команде Заг-библиотеки, включая и ее манифест. К примеру, такая команда выводит имена всех классов библиотеки зауье11о. б аг, которые имеют метод эва1п ( ): В дгерэаг ва1п еауЬе11о.эаг Следующая команда выведет из манифеста архива строку, содержащую имя класса, апределяемого как Маьп-С1авв: В дгерзаг маьл-С1аее еауЬе11с. 5аг Опции утилиты дгербаг приведены в таблице 8.9.