gccxml - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

gccxml - Tạo một biểu diễn XML của các khai báo C ++.

SYNOPSIS

gccxml [tùy chọn] -fxml =

MÔ TẢ

GCC-XML phân tích cú pháp tệp nguồn C ++ vì nó được trình biên dịch nhìn thấy khi nó được xây dựng. Một dễ dàng-
để phân tích cú pháp biểu diễn XML của các khai báo lớp, hàm và không gian tên được kết xuất
vào một tệp được chỉ định. Xử lý trước Full C biến tệp thành đơn vị dịch C ++
như được thấy bởi trình biên dịch. Điều này có nghĩa là GCC-XML nên sử dụng cùng một tiêu chuẩn
thư viện và các tệp tiêu đề khác như trình biên dịch. GCC-XML có thể được định cấu hình để mô phỏng bất kỳ
của một số trình biên dịch phổ biến.

LỰA CHỌN

Các tùy chọn sau có sẵn để chạy GCC-XML:

- bản quyền
In bản quyền GCC-XML và thoát.

--gỡ lỗi
In thông tin gỡ lỗi bổ sung. Tùy chọn này khiến GCC-XML in
tên thực thi và các đối số dòng lệnh được sử dụng để thực thi GCC C ++ đã được vá
trình phân tích cú pháp. Điều này rất hữu ích khi cố gắng mô phỏng một trình biên dịch không được hỗ trợ.

-fxml =
Chỉ định tệp đầu ra XML. Tùy chọn này được chuyển trực tiếp đến GCC đã vá
Bộ phân tích cú pháp C ++. Nó cho phép kết xuất XML và chỉ định tên tệp đầu ra.

-fxml-start = [, ...]
Chỉ định danh sách các khai báo bắt đầu. Tùy chọn này được chuyển trực tiếp đến
đã vá bộ phân tích cú pháp GCC C ++. Nó chỉ có ý nghĩa nếu -fxml = cũng được chỉ định. Cái này
chỉ định danh sách được phân tách bằng dấu phẩy gồm các khai báo bắt đầu được đặt tên. GCC-XML sẽ kết xuất
chỉ tập hợp con của các khai báo trong đơn vị dịch mới có thể truy cập được
thông qua một chuỗi các tham chiếu nguồn từ một trong những điểm bắt đầu được chỉ định
các tờ khai.

--gccxml-trình biên dịch
Đặt GCCXML_COMPILER thành "xxx".

--gccxml-cxxflags
Đặt GCCXML_CXXFLAGS thành "xxx".

--gccxml-thi hành
Đặt GCCXML_EXECUTABLE thành "xxx".

--gccxml-cpp
Đặt GCCXML_CPP thành "xxx".

--gccxml-config
Đặt GCCXML_CONFIG thành "xxx".

--gccxml-root
Đặt GCCXML_ROOT thành "xxx".

--gccxml-gcc-tùy chọn
Đọc các tùy chọn GCC từ tệp "xxx". Tùy chọn này chỉ định một tệp để đọc từ đó
các tùy chọn để chuyển tới trình phân tích cú pháp GCC C ++ đã được vá. Điều này rất hữu ích để chỉ định một
danh sách dài các thư mục bao gồm. Mỗi dòng trong tệp sẽ trở thành một tùy chọn. Trống
các dòng và dòng bắt đầu bằng '#' bị bỏ qua.

--Cứu giúp In trợ giúp đầy đủ và thoát. Trợ giúp đầy đủ hiển thị hầu hết các tài liệu được cung cấp bởi
trang người đàn ông UNIX. Nó được cung cấp để sử dụng trên các nền tảng không phải UNIX, nhưng cũng
thuận tiện nếu trang người đàn ông không được cài đặt.

--help-html
In trợ giúp đầy đủ ở định dạng HTML. Tùy chọn này được các tác giả GCC-XML sử dụng để giúp
sản xuất các trang web.

--Đàn ông In trang người dùng UNIX và thoát. Tùy chọn này được các tác giả GCC-XML sử dụng để tạo
trang người đàn ông UNIX.

--in
In cài đặt cấu hình và thoát. GCC-XML có nhiều tùy chọn cấu hình để
giúp nó mô phỏng một trình biên dịch khác. Sử dụng tùy chọn này sẽ khiến GCC-XML
tự cấu hình như thể nó sẽ phân tích cú pháp mã nguồn C ++, nhưng dừng lại và in
cấu hình được tìm thấy. Điều này rất hữu ích để kiểm tra cấu hình.

- quy trình
Xử lý trước đầu vào và lối ra. GCC-XML mô phỏng bộ xử lý của một bộ xử lý khác
trình biên dịch. Sử dụng tùy chọn này sẽ khiến GCC-XML tự định cấu hình như thể
sẽ phân tích cú pháp mã nguồn C ++, nhưng dừng lại sau khi xử lý trước. Điều này hữu ích cho
gỡ lỗi các vấn đề liên quan đến mô phỏng của trình biên dịch khác.

-E Bí danh cho --preprocess.

--phiên bản
Hiển thị biểu ngữ tên chương trình / phiên bản và thoát.

Các cờ khác, chẳng hạn như -I và -D, được chuyển tới tệp thực thi trình phân tích cú pháp GCC C ++ đã được vá.

SETTINGS

GCC-XML được thiết kế để mô phỏng trình phân tích cú pháp của trình biên dịch trong khi đọc mã nguồn C ++. Một vài
cài đặt cấu hình là cần thiết để xác định cách mô phỏng một trình biên dịch cụ thể của
sự lựa chọn của người dùng. Các cài đặt sau có thể được sử dụng để định cấu hình GCC-XML:

GCCXML_COMPILER
Trình biên dịch C ++ được mô phỏng. GCC-XML sẽ cố gắng tự động xác định
cách mô phỏng trình biên dịch được chỉ định bởi cài đặt này. Trình biên dịch được chỉ định
bằng tên thực thi của nó (chẳng hạn như "g ++"). Đối với Visual Studio, trình biên dịch là
được chỉ định bởi "msvc6", "msvc7", "msvc71" hoặc "msvc8" (nếu "cl" là GCC-XML
cố gắng đoán sử dụng VS nào).

GCCXML_CXXFLAGS
Các cờ cho trình biên dịch C ++ được mô phỏng. Hành vi của hầu hết các trình biên dịch có thể
được điều chỉnh bằng cách chỉ định các cờ trên dòng lệnh. Khi GCC-XML cố gắng
tự động xác định cách mô phỏng trình biên dịch, các cờ này được đưa vào
Sự xem xét.

GCCXML_CONFIG
Tệp cấu hình cho các cài đặt chung. Khi cài đặt không mặc định thường
được sử dụng, nó là thuận tiện để ghi một tệp duy nhất chứa chúng. Khi một tập tin như vậy
được chỉ định, nó sẽ được đọc để định cấu hình bất kỳ cài đặt nào chưa được biết đến. Mỗi
dòng của tệp bao gồm một bài tập có dạng KEY = "VALUE" (ví dụ:
GCCXML_COMPILER = "g ++").

GCCXML_EXECUTABLE
Chỉ định tệp thực thi trình phân tích cú pháp GCC C ++ đã được vá. Chương trình GCC-XML như được thấy bởi
người dùng thực sự là một giao diện người dùng xác định các cờ cần thiết để định cấu hình
đã vá bộ phân tích cú pháp GCC C ++ để mô phỏng một trình biên dịch khác. Cài đặt này chỉ định
thực thi để chạy sau khi các cờ đã được xác định. Người dùng hiếm khi
cần thay đổi giá trị này từ giá trị mặc định của nó.

GCCXML_CPP
Chỉ định bộ tiền xử lý GCC C có thể thực thi. Chương trình GCC-XML được người dùng nhìn thấy
thực sự là một giao diện người dùng xác định các cờ cần thiết để định cấu hình
Bộ phân tích cú pháp GCC C ++ để mô phỏng một trình biên dịch khác. Cài đặt này chỉ định
bộ tiền xử lý để chạy với các cờ đã được xác định để gỡ lỗi
mục đích. Người dùng hiếm khi cần thay đổi giá trị này từ giá trị mặc định của nó.

GCCXML_ROOT
Thư mục thư viện hỗ trợ GCC-XML. Vì GCC-XML chỉ là một trình phân tích cú pháp C ++, nó
không thể sao chép chính xác chức năng của mọi trình biên dịch mà nó cố gắng mô phỏng.
Một số trình biên dịch cung cấp tiêu đề tiêu chuẩn với mã mà GCC-XML không thể trực tiếp
xử lý. Để khắc phục hạn chế này, một thư viện hỗ trợ được cung cấp cho mỗi
trình biên dịch. Điều này bao gồm một tập hợp các tệp tiêu đề được sử dụng thay cho
tiêu đề hệ thống của trình biên dịch. Các tệp này chứa các chỉnh sửa nhỏ và sau đó bao gồm
tiêu đề thực tương ứng. Gốc của cây thư mục chứa các hỗ trợ này
tiêu đề thư viện được chỉ định bởi cài đặt này. Người dùng hiếm khi cần thay đổi
giá trị này từ giá trị mặc định của nó.

GCCXML_FLAGS
Cờ được sử dụng để mô phỏng trình biên dịch khác. Khi GCC-XML chạy GCC C ++ đã được vá
phân tích cú pháp, các cờ này được chuyển đến chương trình để cho chương trình biết cách mô phỏng một
trình biên dịch cụ thể. Cài đặt này thường được phát hiện tự động từ cài đặt khác
cài đặt, nhưng nó có thể được chỉ định trực tiếp bởi người dùng nâng cao. Hầu hết người dùng nên
không cố gắng thay đổi giá trị này từ cấu hình tự động.

GCCXML_USER_FLAGS
Cờ người dùng bổ sung để mô phỏng trình biên dịch. Khi GCC-XML chạy GCC đã được vá
Trình phân tích cú pháp C ++, những cờ này được chuyển cùng với những cờ được chỉ định bởi GCCXML_FLAGS.
Điều này cho phép người dùng nâng cao tinh chỉnh mô phỏng trình biên dịch trong khi vẫn sử dụng
cấu hình tự động của GCCXML_FLAGS. Người dùng hiếm khi cần thay đổi điều này
giá trị từ mặc định của nó.

Có một số phương tiện mà các cài đặt này được định cấu hình. Chúng được liệt kê ở đây trong
thứ tự ưu tiên (cao nhất trước):

Dòng lệnh Các lựa chọn
Cài đặt có thể được chỉ định bởi các tùy chọn tương ứng của chúng. Khi một cài đặt
tùy chọn dòng lệnh tương ứng được cung cấp, nó được sử dụng có lợi hơn bất kỳ
phương tiện cấu hình. Nếu GCCXML_CONFIG được đặt trên dòng lệnh, cài đặt sẽ
đọc từ tệp với mức độ ưu tiên chỉ thấp hơn một chút so với dòng lệnh khác
tùy chọn.

Môi trường Biến
Cài đặt được định cấu hình theo tên trong môi trường. Mỗi cài đặt chưa được biết đến
được đọc từ một biến môi trường với tên của nó. Nếu GCCXML_CONFIG được đặt bởi
môi trường, cài đặt được đọc từ tệp với mức độ ưu tiên thấp hơn một chút
hơn các biến môi trường khác.

Cấu hình Các tập tin
Tìm kiếm GCCXML_CONFIG được thực hiện. Nếu GCCXML_CONFIG chưa được đặt,
cố gắng tự động tìm tệp cấu hình. Đầu tiên, nếu tệp
$ HOME / .gccxml / config tồn tại, nó sẽ được sử dụng. Thứ hai, nếu GCC-XML đang được thực thi
từ thư mục xây dựng của nó, một tệp cấu hình từ thư mục đó sẽ được sử dụng. Cuối cùng,
nếu tệp cấu hình được tìm thấy trong thư mục thư viện hỗ trợ của cài đặt, nó sẽ
được dùng. Sau khi tìm thấy, mọi cài đặt không xác định sẽ được đọc từ tệp cấu hình.

Đoán
Đoán được thực hiện dựa trên các cài đặt khác. Khi GCCXML_COMPILER đã được đặt, nó sẽ
được sử dụng để tự động tìm cài đặt cho GCCXML_FLAGS. Nếu nó không được đặt,
Biến môi trường "CXX" được chọn là phương án cuối cùng để tìm cài đặt trình biên dịch
và xác định GCCXML_FLAGS.

Hầu hết người dùng không phải điều chỉnh các giá trị mặc định cho các cài đặt này. Có một mặc định
Tệp GCCXML_CONFIG được cung cấp trong thư mục thư viện hỗ trợ sau khi cài đặt. Nó
cấu hình GCC-XML để mô phỏng trình biên dịch được sử dụng để xây dựng nó.

MÁY LỌC

GCC-XML có thể mô phỏng bất kỳ trình biên dịch nào sau đây:

GCC Các phiên bản 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

Hình ảnh C + +
Phiên bản 8, 7.1, 7.0 và 6 (sp5)

người lớn, intel, SGI
trước đây được hỗ trợ nhưng không còn được thử nghiệm

Các định nghĩa tiền xử lý C bổ sung sau được cung cấp:

-D__GCCXML __ = MMmmpp
MM, mm và pp là các phiên bản chính, phụ và vá lỗi của GCC-XML. Cái này
ký hiệu tiền xử lý xác định GCC-XML thành mã nguồn khi nó được xử lý trước.
Nó có thể được sử dụng để kích hoạt thông tin GCC-XML cụ thể.

-D__GCCXML_GNUC __ = M
Được xác định cho phiên bản chính của trình phân tích cú pháp GCC nội bộ.

-D__GCCXML_GNUC_MINOR __ = m
Được xác định cho phiên bản nhỏ của trình phân tích cú pháp GCC nội bộ.

-D__GCCXML_GNUC_PATCHLEVEL __ = p
Được xác định cho mức vá lỗi của trình phân tích cú pháp GCC nội bộ.

Người dùng nâng cao có thể mô phỏng các trình biên dịch khác bằng cách định cấu hình thủ công GCCXML_FLAGS
thiết lập. Liên hệ với danh sách gửi thư để được giúp đỡ.

THÔNG TIN METAIN

GCC-XML đã thêm một thuộc tính mới vào bộ thuộc tính C / C ++ hợp pháp. Thuộc tính là
được sử dụng để đính kèm thông tin meta vào mã nguồn C / C ++, sau đó sẽ xuất hiện trong XML
đầu ra. Cú pháp khai báo một thuộc tính như sau:

__attribute ((gccxml ( , , ...)))
Ở đây là một chuỗi được trích dẫn. Phải có ít nhất một đối số cho
thuộc tính 'gccxml', nhưng không có giới hạn trên cho tổng số đối số.
Mỗi đối số được xác minh là một chuỗi - nếu một đối số không phải là chuỗi được tìm thấy,
thuộc tính bị bỏ qua.

Đầu ra XML cho phần tử mã được gắn thẻ với thuộc tính sau đó sẽ chứa
sau đây:

thuộc tính = " hữu ích. Cảm ơn ! gccxml ( , , ...) hữu ích. Cảm ơn !
Thuộc tính XML 'thuộc tính' chứa tất cả các thuộc tính được áp dụng cho phần tử mã.
Mỗi đối số của thuộc tính được in mà không kèm theo dấu ngoặc kép, vì vậy nếu một
đối số chứa ký tự ',', đối số sẽ có vẻ là nhiều
lập luận.

Thuộc tính 'gccxml' có thể được áp dụng cho bất kỳ khai báo nào bao gồm cấu trúc, lớp,
trường, tham số, phương thức, hàm, biến và typedef. Ngoại lệ duy nhất là
rằng việc xử lý phần tử ngôn ngữ '__attribute' của GCC hiện đang bị hỏng đối với
phép liệt kê và hàm tạo với phần thân nội tuyến. Thuộc tính 'gccxml' có thể được sử dụng
bất kỳ số lần nào trên một khai báo nhất định.

Ví dụ về cách thuộc tính này có thể được sử dụng để đính kèm thông tin meta vào C ++
khai báo, hãy xem xét macro sau:

#định nghĩa _ngoài_ __attribute ((gccxml ("out")))
Ở đây '_out_' đã được xác định là thuộc tính gccxml nơi đối số đầu tiên
là chuỗi "ra". Bạn nên sử dụng đối số đầu tiên làm đối số duy nhất
tên chuỗi cho loại thông tin meta bắt đầu được áp dụng.

Bây giờ một khai báo phương thức có thể được viết như sau:

làm mất hiệu lực getInteger (_out_ NS& tôi);
Điều này sẽ khiến đầu ra XML chứa thông tin meta cho '_out_'
thuộc tính "gccxml (out)".

Sử dụng thuộc tính 'gccxml' cho phép đưa thông tin meta vào trực tiếp trong C ++
mã nguồn, mà không cần trình phân tích cú pháp tùy chỉnh để trích xuất thông tin meta. Các
Thuộc tính 'gccxml' chỉ được cung cấp để thuận tiện - không có gì đảm bảo rằng tương lai
các phiên bản của GCC sẽ chấp nhận phần tử ngôn ngữ '__attribute' một cách không có lỗi.

BẢN QUYỀN

GCC-XML - đầu ra XML cho GCC

Bản quyền 2002-2012 Kitware, Inc., Insight Consortium

Phân phối lại và sử dụng ở dạng nguồn và dạng nhị phân, có hoặc không có sửa đổi, là
được phép với điều kiện đáp ứng các điều kiện sau:

* Việc phân phối lại mã nguồn phải giữ lại thông báo bản quyền ở trên, danh sách này
điều kiện và tuyên bố từ chối trách nhiệm sau đây.

* Bản phân phối lại ở dạng nhị phân phải sao chép thông báo bản quyền ở trên, danh sách này
điều kiện và tuyên bố từ chối trách nhiệm sau trong tài liệu và / hoặc
vật liệu được cung cấp cùng với việc phân phối.

* Tên của Kitware, Inc., Insight Software Consortium, cũng không phải tên
những người đóng góp của họ có thể được sử dụng để xác nhận hoặc quảng bá các sản phẩm bắt nguồn từ
phần mềm mà không có sự cho phép trước bằng văn bản cụ thể.

PHẦN MỀM NÀY ĐƯỢC CUNG CẤP BỞI CHỦ BẢN QUYỀN VÀ NHÀ ĐÓNG GÓP "NGUYÊN TRẠNG" VÀ BẤT KỲ
BẢO ĐẢM RÕ RÀNG HOẶC NGỤ Ý, BAO GỒM, NHƯNG KHÔNG GIỚI HẠN ĐỐI VỚI, CÁC BẢO ĐẢM NGỤ Ý CỦA
KHẢ NĂNG LIỆU TRÌNH VÀ SỰ PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ BỊ TỪ CHỐI. KHÔNG CÓ SỰ KIỆN NÀO SẼ GẶP
CHỦ NHÂN BẢN QUYỀN HOẶC CÁC NHÀ ĐÓNG GÓP CHỊU TRÁCH NHIỆM PHÁP LÝ ĐỐI VỚI BẤT KỲ TRỰC TIẾP, CHỈ ĐỊNH, SỰ CỐ, ĐẶC BIỆT,
THIỆT HẠI HOẶC HẬU QUẢ (BAO GỒM, NHƯNG KHÔNG GIỚI HẠN ĐỐI VỚI, QUY TRÌNH CỦA
NỘP HÀNG HOẶC DỊCH VỤ; MẤT SỬ DỤNG, DỮ LIỆU HOẶC LỢI NHUẬN; HOẶC LIÊN KẾT DOANH NGHIỆP)
TUY NHIÊN NGUYÊN NHÂN VÀ BẤT CỨ LÝ THUYẾT VỀ TRÁCH NHIỆM PHÁP LÝ NÀO TRONG HỢP ĐỒNG, TRÁCH NHIỆM PHÁP LÝ NGHIÊM TÚC HOẶC
BÁO CÁO (BAO GỒM SỰ TIÊU CỰC HOẶC CÁCH KHÁC) PHÁT HIỆN BẤT KỲ CÁCH NÀO NGOÀI VIỆC SỬ DỤNG ĐIỀU NÀY
PHẦN MỀM, NGAY CẢ KHI ĐƯỢC TƯ VẤN VỀ KHẢ NĂNG THIỆT HẠI NHƯ VẬY.

-------------------------------------------------- ----------

gccxml_cc1plus - Trình phân tích cú pháp GCC được vá cho các kết xuất XML của các đơn vị dịch

Bản quyền 2002-2012 Kitware, Inc., Insight Consortium

Chương trình này là phần mềm miễn phí; bạn có thể phân phối lại nó và / hoặc sửa đổi nó theo các điều khoản của
Giấy phép Công cộng GNU do Tổ chức Phần mềm Tự do xuất bản; một trong hai
phiên bản 2 của Giấy phép hoặc (tùy chọn của bạn) bất kỳ phiên bản mới hơn.

Chương trình này được phân phối với hy vọng rằng nó sẽ hữu ích, nhưng KHÔNG CÓ BẤT KỲ BẢO HÀNH NÀO;
thậm chí không có sự bảo đảm ngụ ý về KHẢ NĂNG LÊN LỚN hoặc SỰ PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ.
Xem Giấy phép Công cộng GNU để biết thêm chi tiết.

Bạn sẽ nhận được một bản sao của Giấy phép Công cộng GNU cùng với chương trình này;
nếu không, hãy viết thư cho
Tổ chức phần mềm miễn phí, Inc.
51 Đường Franklin, Tầng XNUMX
Boston, MA 02110-1301 Hoa Kỳ

GỬI THƯ DANH SÁCH

Để được trợ giúp và thảo luận về cách sử dụng gccxml, một danh sách gửi thư được cung cấp tại
[email được bảo vệ]. Trước tiên hãy đọc toàn bộ tài liệu tại http://www.gccxml.org
trước khi đăng câu hỏi vào danh sách.

Sử dụng gccxml trực tuyến bằng các dịch vụ onworks.net