United States    
COMPAQ STORE | PRODUCTS |
SERVICES | SUPPORT | CONTACT US | SEARCH
Compaq C

Compaq C
Language Reference Manual


Previous Contents Index

6.4.7 The sizeof Operator

Consider the syntax of the following expressions:

sizeof expression


sizeof ( type-name )

type-name cannot be an incomplete type, function type, or a bit field. The sizeof operator produces a compile-time integer constant value. expression is inspected only to deduce its type; it is not fully evaluated. For example, sizeof(i++) is equivalent to sizeof(i) .

The result of the sizeof operation is the size, in bytes, of the operand. In the first case, the result of sizeof is the size determined by the type of the expression. In the second case, the result is the size of an object of the named type. The expression should be enclosed in parentheses if it contains operators, because the precedence of sizeof is higher than that of most operators.

The syntax of type-name is the same as that for the cast operator. For example:


int  x; 
x = sizeof(char *);  /* assigns the size of a character pointer to x */ 

The type of the sizeof operator's result, size_t , is an unsigned integer type. In Compaq C, size_t is unsigned int .

6.4.8 The __typeof__ Operator

The __typeof__ operator is another way to refer to the type of an expression. This feature is provided for compatiblity with the gcc compiler.

The syntax of this operator keyword looks like sizeof , but the construct acts semantically like a type-name defined with typedef .

__typeof__ ( expression )


__typeof__ ( type-name )

There are two ways of writing the argument to __typeof__ : with an expression or with a type.

The following is an example with an expression. This example assumes that x is an array of int s; the type described is int :


__typeof__(x[0](1)) 

The following is an example with a type-name as the argument. The type described is that of pointers to int :


__typeof__(int *) 

A __typeof__ construct can be used anywhere a typedef name can be used. For example, you can use it in a declaration, in a cast, or inside a sizeof or __typeof__ operator:


__typeof__(*x) y;     // Declares y with the type of what x points to. 
 
__typeof__(*x) y[4];  // Declares y as an array of such values. 
 
__typeof__(__typeof__(char *)[4]) y;  // Declares y as an array of 
                                      // pointers to characters: 
 

The last example (the nested __typeof__ operators) is equivalent to the following traditional C declaration:


char *y[4]; 

To see the meaning of the declaration using __typeof__ , and why it might be a useful way to write it that way, let's rewrite it with these macros:


#define pointer(T)  __typeof__(T *) 
#define array(T, N) __typeof__(T [N]) 

Now the declaration can be rewritten this way:


array (pointer (char), 4) y; 

Thus, array (pointer (char), 4) is the type of arrays of 4 pointers to char .

6.5 Binary Operators

The binary operators are categorized as follows:

The following sections describe these binary operators.

6.5.1 Multiplicative Operators

The multiplicative operators are *, /, and %. Operands must have arithmetic type. Operands are converted, if necessary, according to the usual arithmetic conversion rules (see Section 6.11.1).

The * operator performs multiplication.

The / operator performs division. When integers are divided, truncation is toward zero. If either operand is negative, the result is truncated toward zero (the largest integer of lesser magnitude than the algebraic quotient).

The % operator divides the first operand by the second and yields the remainder. Both operands must be integral. When both operands are unsigned or positive, the result is positive. If either operand is negative, the sign of the result is the same as the sign of the left operand.

The following statement is true if b is not zero:


(a/b)*b + a%b == a; 

The Compaq C compiler, with the check option enabled, issues warnings for these undefined behaviors:

6.5.2 Additive Operators

The additive operators + and -- perform addition and subtraction. Operands are converted, if necessary, according to the usual arithmetic conversion rules (see Section 6.11.1).

When two enum constants or variables are added or subtracted, the type of the result is int .

When an integer is added to or subtracted from a pointer expression, the integer is scaled by the size of the object being pointed to. The result has the pointer's type. For example:


int arr[10]; 
int *p = arr; 
p = p + 1;  /* Increments by sizeof(int) */ 

An array pointer can be decremented by subtracting an integral value from a pointer or address; the same conversions apply as for addition. Pointer arithmetic also applies one element beyond the end of the array. For example, the following code works because the pointer arithmetic is limited to the elements of the array and to only one element beyond:


int i = 0; 
int x[5] = {0,1,2,3,4}; 
int y[5]; 
int *ptr = x; 
while (&y[i] != (ptr + 5)) { /*  ptr + 5 marks one beyond the end of the array */ 
  y[i] = x[i]; 
  i++; 
} 

When two pointers to elements of the same array are subtracted, the result (calculated by dividing the difference between the two addresses by the length of one element) is of type ptrdiff_t , which in Compaq C is int , and represents the number of elements between the two addressed elements. If the two elements are not in the same array, the result of this operation is undefined.

6.5.3 Shift Operators

The shift operators << and >> shift their left operand to the left or to the right, respectively, by the number of bits specified by the right operand. Both operands must be integral. The compiler performs integral promotions on each of the operands (see Section 6.11.1.1). The type of the result is the type of the promoted left operand. Consider the following expression:


E1 << E2

The result is the value of expression E1 shifted to the left by E2 bits. Bits shifted off the end are lost. Vacated bits are filled with zeros. The effect of shifting left is to multiply the left operand by 2 for each bit shifted. In the following example, the value of i is 100:


int n = 25; 
int m = 2; 
int i; 
 
i = n << m; 

Consider the following expression:


E1 >> E2

The result is the value of expression E1 shifted to the right by E2 bits. Bits shifted off the end are lost. If E1 is unsigned or if E1 has a signed type but nonnegative value, vacated bits are filled with zeros. If E1 has a signed type and negative value, vacated bits are filled with ones.

The result of the shift operation is undefined if the right operand is negative or if its value is greater than the number of bits in an int .

For a nonnegative left operand, the effect of shifting right is to divide the left operand by 2 for each bit shifted. In the following example, the value of i is 12:


int n = 100; 
int m = 3; 
int i; 
 
i = n >> m; 

6.5.4 Relational Operators

The relational operators compare two operands and produce a result of type int . The result is 0 if the relation is false, and 1 if it is true. The operators are: less than (<), greater than (>), less than or equal (<=), and greater than or equal (>=). Both operands must have an arithmetic type or must be pointers to compatible types. The compiler performs the necessary arithmetic conversions before the comparison (see Section 6.11.1).

When two pointers are compared, the result depends on the relative locations of the two addressed objects. Pointers to objects at lower addresses are less than pointers to objects at higher addresses. If two addresses indicate elements in the same array, the address of an element with a lower subscript is less than the address of an element with a higher subscript.

The relational operators associate from left to right. Therefore, the following statement relates a to b , and if a is less than b , the result is 1 (true). If a is greater than or equal to b , the result is 0 (false). Then, 0 or 1 is compared with c for the expression result. This statement does not determine "if b is between a and c ".


if ( a < b < c ) 
    statement; 

To check if b is between a and c , use the following code:


if ( a < b && b < c ) 
    statement; 

6.5.5 Equality Operators

The equality operators, equal ( == ) and not-equal (!=), produce a result of type int , so that the result of the following statement is 1 if both operands have the same value, and 0 if they do not:


a == b 

Operands must have one of the following type combinations:

Operands are converted, if necessary, according to the usual arithmetic conversion rules (see Section 6.11.1).

Two pointers or addresses are equal if they identify the same storage location.

Note

Although different symbols are used for assignment (=) and equality ( == ), C allows either operator in all contexts, so be careful not to confuse them. Consider the following example:


if ( x = 1 ) 
    statement_1; 
else 
    statement_2; 


In this example, statement_1 always executes, because the result of the assignment x = 1 is equivalent to the value of x , which equals 1 (or true).

6.5.6 Bitwise Operators

The bitwise operators require integral operands. The usual arithmetic conversions are performed (see Section 6.11.1). The result of the expression is the bitwise AND (&), inclusive OR ( | ), or exclusive OR (^), of the two operands. The order of evaluation of their operands is not guaranteed.

The operands are evaluated bit by bit. The result of the & operator is 0 if one bit value is 0 and the other is 1, or if both bit values are 0. The result is 1 if both bit values are 1.

The result of the | operator is 0 if both bit values are 0. The result for each bit is 1 if either bit value is 1, or both bit values are 1.

The result of the ^ operator is 0 if both bit values are 0, or if both bit values are 1. The result for each bit is 1 if either bit value is 1 and the other is 0.

6.5.7 Logical Operators

The logical operators are AND (&&) and OR ( || ). These operators guarantee left-to-right evaluation. The result of the expression (of type int ) is either 0 (false) or 1 (true). The operands need not have the same type, but both types must be scalar. If the compiler can make an evaluation by examining only the left operand, the right operand is not evaluated. Consider the following expression:


E1 && E2

The result of this expression is 1 if both operands are nonzero, or 0 if one operand is 0. If expression E1 is 0, expression E2 is not evaluated because the result is the same regardless of E2's value.

Similarly, the following expression is 1 if either operand is nonzero, and 0 otherwise. If expression E1 is nonzero, expression E2 is not evaluated, because the result is the same regardless of E2's value.


E1 || E2

6.6 Conditional Operator

The conditional operator (?:) takes three operands. It tests the result of the first operand and then evaluates one of the other two operands based on the result of the first. Consider the following example:


E1  ?  E2  :  E3

If expression E1 is nonzero (true), then E2 is evaluated, and that is the value of the conditional expression. If E1 is 0 (false), E3 is evaluated, and that is the value of the conditional expression. Conditional expressions associate from right to left. In the following example, the conditional operator is used to get the minimum of x and y :


a = (x < y) ? x : y;     /* a = min(x, y)  */ 

There is a sequence point after the first expression (E1). The following example's result is predictable, and is not subject to unplanned side effects:


i++ > j ? y[i] : x[i]; 

The conditional operator does not produce an lvalue. Therefore, a statement such as a ? x : y = 10 is not valid.

The following restrictions apply:

6.7 Assignment Operators

There are several assignment operators. Assignments result in the value of the target variable after the assignment. They can be used as subexpressions in larger expressions. Assignment operators do not produce lvalues.

Assignment expressions have two operands: a modifiable lvalue on the left and an expression on the right. A simple assignment consists of the equal sign (=) between two operands:


E1 = E2; 

The value of expression E2 is assigned to E1. The type is the type of E1, and the result is the value of E1 after completion of the operation.

A compound assignment consists of two operands, one on either side of the equal sign (=), in combination with another binary operator. For example:


E1 += E2; 

This is equivalent to the following simple assignment (except that in the compound assignment E1 is evaluated once, while in the simple assignment E1 is evaluated twice):


E1 = E1 + E2; 

In the following example, the following assignments are equivalent:


a *= b + 1; 
 
a = a * (b + 1);         

In another example, the following expression adds 100 to the contents of number[1] :


number[1] += 100; 

The result of this expression is the result after the addition and has the same type as number[1] .

If both assignment operands are arithmetic, the right operand is converted to the type of the left before the assignment (see Section 6.11.1).

The assignment operator (=) can be used to assign values to structures and unions. In the VAX C compatibility mode of Compaq C, one structure can be assigned to another as long as the structures are defined to be the same size, in bytes. In ANSI mode, the structure values must also have the same type. With all compound assignment operators, all right operands and all left operands must be either pointers or evaluate to arithmetic values. If the operator is --= or +=, the left operand can be a pointer, and the right operand (which must be integral) is converted in the same manner as the right operand in the binary plus (+) and minus (--) operations.

Do not reverse the characters that comprise a compound assignment operator, as in the following example:


E1 =+ E2; 

This is an obsolete form that is no longer supported, but it will pass through the compiler undetected. (It is interpreted as an assignment operator followed by the unary plus operator).


Previous Next Contents Index
  

1.800.AT.COMPAQ

privacy and legal statement