o_195h4n6al16jb186b1b2qs7fgssa.pdf

There are a number of reasons why providing built-in functions is preferable to
requiring programmers to use inline assembly. They include the following:
1. Providing built-in functions for specific purposes simplifies coding.
2. Certain opitmizations are disabled when inline assembly is used. This is not
the
case for built-in functions.
3. For machine instructions that use dedicated registers, coding inline assembly
while avoiding register allocation errors can require considerable care. The
built-in functions make this process simpler as you do not need to be concerned
with the particular register requirements for each individual machine
instruction.
This chapter is organized as follows:
• Built-In Function List
• Built-In Function Error Messages
dsPIC
®
Language Tools Libraries
DS51456B-page 376
5.2 BUILT-IN FUNCTION LIST
2004 Microchip Technology Inc.
This section describes the programmer interface to the MPLAB C30 C compiler
built-in
functions. Since the functions are “built in”, there are no header files associated
with
them. Similarly, there are no command-line switches associated with the built-in
functions – they are always available. The built-in function names are chosen
such that
they belong to the compiler's namespace (they all have the prefix __builtin_), so
they will not conflict with function or variable names in the programmer's
namespace.
__builtin_divsd
Description: The function computes the quotient num/ den. A math error
exception
occurs if denis zero. Function arguments are signed, as is the function
result. The command-line option -Wconversionscan be used to
detect unexpected sign conversions.
Prototype: int __builtin_divsd(const long num, const int den);
Argument: num numerator
den denominator
Return Value: Returns the signed integer value of the quotient num/ den.
Assembler
Operator / Machine
Instruction:
Các thông báo lỗi sau đây được tạo ra khi các chức năng tích hợp được sử dụng
không chính xác.
Tham số để __builtin_function () không phải là địa chỉ của một đối tượng trong
mã, PSV, hoặc phần EEDATA
Đối số cho các chức năng tích hợp sau đây phải là một địa chỉ đối tượng rõ
ràng:
• __builtin_tblpage
• __builtin_tbloffset
• __builtin_psvpage
• __builtin_psvoffset
Ví dụ, nếu objis đối tượng trong một phần thực thi hoặc chỉ đọc, cú pháp sau
có giá trị:
unsigned trang = __builtin_function (& obj);
__builtin_psvoffset
Mô tả: Chức năng trả về trang PSV bù đắp của các đối tượng có địa chỉ là
được coi là một tham số. Đối số pmust là địa chỉ của một
đối tượng trong một dữ liệu EE, PSV hay không gian bộ nhớ thực thi; nếu
không một
thông báo lỗi được sản xuất và biên soạn không. Xem không gian
thuộc tính trong MPLAB®
Hướng dẫn C30 C Compiler của người dùng.
Nguyên mẫu: int __builtin_psvoffset (const void * p);
Đối số: p địa chỉ đối tượng
Quay trở lại giá trị: Trả về số trang PSV offsetof đối tượng có địa chỉ là
được coi là một tham số.
Assembler
Điều hành / Máy
Hướng dẫn:
psvoffset
__builtin_return_address
Mô tả: Chức năng này trả về địa chỉ trả về của hàm hiện tại, hoặc của
một trong những người gọi của nó. Đối với levelargument một giá trị từ 0 sản
lượng
địa chỉ trả về của hàm hiện nay, giá trị sản lượng 1 sự trở lại
địa chỉ của người gọi của chức năng hiện tại, và vv. Khi mức độ
vượt quá chiều sâu ngăn xếp hiện tại, 0 sẽ được trả lại. Chức năng này
chỉ nên được sử dụng với một đối số khác không cho mục đích gỡ lỗi.
Nguyên mẫu: int __builtin_return_address (const mức int);
Đối số: mức Số khung để quét lên gọi chồng.
Quay trở lại giá trị: Trả về địa chỉ trả về của hàm hiện tại, hoặc của một trong
của nó