HOWTO: Use the Token Pasting Operator in Microsoft C

• Microsoft C for MS-DOS, versions 5.1, 6.0, 6.0a, 6.0ax
• Microsoft C/C++ for MS-DOS
• Microsoft Visual C++ for Windows, 16-bit edition, versions 1.0, 1.5
• Microsoft Visual C++, 32-bit Editions, versions 1.0, 2.0, 4.0, 5.0, 6.0

SUMMARY

In Microsoft C, the token pasting operator (##) is used to replace tokens within a preprocessor string. The (##) can be used to mark off the first portion of the string as a token, the last part of the string as a token, or the middle of a string as a portion. See the examples shown below.

The token pasting operator cannot be the first or the last token in a preprocessor string. The first example below (GLUE) demonstrates the use of the token pasting operator to concatenate two tokens. There is a replaceable token in front of the operator and one following the operator. The token pasting operator effectively divides the string into the two pieces.

A more complex situation arises when using the token pasting operator to replace a token embedded within a string (for example, THIS_IS_A_size_TOKEN, where size could be replaced with either LARGE or SMALL); the token to be replaced must be surrounded by token pasting operators (##). This is necessary only when the token to be replaced is completely embedded in another string (see example 2). Normally, the space character is used as one of the token markers, while the (##) marks the other end. Only in this specific case (an embedded token) is more than one token pasting operator needed.

MORE INFORMATION

Sample Code

/* Compile options needed: none
*/ 

/*
    PASTE.C: Demonstrates the use of the token pasting operator.
*/ 
/*
    Example 1 definition.
    This definition will replace the token "a" from the beginning
    of the string and "b" from the tail of the string.
*/ 

#define GLUE(a,b) a##b

/*
 - These are the defines for Example 2.
   Calling print with either LARGE or SMALL will then change
   the PRINT macro to call the proper PRINT_..._SIZE macro.
*/ 
#define PRINT_LARGE_SIZE(val) printf("The large size is %d\n",val)
#define PRINT_SMALL_SIZE(val) printf("The small size is %d\n",val)
#define PRINT(size,val) PRINT_##size##_SIZE(val)

void main ( void )

{
    char *varsrc = "Hello!" ;
    char *vardest = "      " ;

/*
    Example #1: Tokens at beginning and end of string.
*/ 

    strcpy(GLUE(var,dest),GLUE(var,src)) ;
    printf("%s\n", GLUE(var,dest)) ;

/*
    Example #2: Token embedded in string.
*/ 

    PRINT(LARGE, 2) ; /* Calls the printf() for large sizes. */ 
    PRINT(SMALL, 1) ; /* Calls the printf() for small sizes. */ 
} 

void main ( void )

{
    char *varsrc = "Hello!" ;
    char *vardest = "      " ;

    strcpy(vardest,varsrc) ;
    printf("%s\n", vardest) ;

    printf("The large size is %d\n",2) ;
    printf("The small size is %d\n",1) ;
} 

Additional query words:

Keywords : kbcode kbLangC kbVC100 kbVC150 kbVC200 kbVC210 kbVC400 kbVC500 kbVC600
Version : MS-DOS:; WINDOWS:1.0,1.5; winnt:1.0,2.0,4.0,5.0,6.0
Platform : MS-DOS WINDOWS winnt
Issue type : kbhowto