dpct sample.cu --rule-file=rule_file1.YAML --rule-file=rule_file2.YAML

--- # [YAML syntax] Begin the document - Rule: rule_forceinline # Rule to migrate "__forceinline__" to "inline" Kind: Macro # Rule type Priority: Takeover # Rule priority 
  In: __forceinline__ # Target macro name in the input source code 
  Out: inline # Name of migrated macro in the output source code 
  Includes: ["header1.h", "\"header2.h\""] # List of header file names which the new macro 
                                                # depends on 
- Rule: rule_foo # Rule to migrate "foo(a,b)" to "int *new_ptr=bar(*b)」 
  Kind: API 
  Priority: Takeover 
  In: foo # Target function name in the input source code 
  Out: $type_name_of($2) *new_ptr = bar($deref($1)) # Format of the migrated result in the 
                                                                           # output source code 
  Includes: ["<header3>"] 
  APIRestrictCondition: ArgCount: 1 # Only the overloading with 1 argument will be migrated 
- Rule: rule_cmath # Rule to migrate "include<cmath>" to "#include<mymath>」 
  Kind: Header 
  Priority: Takeover 
  In: cmath 
  Out: mymath 
  Prefix: "#ifdef USE_MYMATH\n" # Add prefix before "#include<mymath>」 
  Postfix: "#endif\n" # Add postfix after "#include<mymath>」 
  Includes: [""] 
- Rule: rule_classA # Rule to migrate "classA" to "classB」 
  Kind: Class 
  Priority: Takeover 
  In: classA 
  Out: classB 
  Includes: [] 
  Fields: # Specify the migration rule of fields of classA 
    - In: fieldA # Migrate classA.fieldA to getter and setter 
      OutGetter: get_a # Migrate value reference of classA.fieldA to 
                                 # classB.get_a() 
      OutSetter: set_a # Migrate value assignment of classA.fieldA to 
                                 # classB.set_a() 
    - In: fieldC 
      Out: fieldD # Migrate classA.fieldC to classB.fieldD 
  Methods: - In: methodA 
      Out: a.methodB($2) # Migrate classA.methodA(x,y) to a.methodB(y) 
- Rule: rule_Fruit # Rule to migrate "Fruit:apple" to "Fruit:pineapple」 
  Kind: Enum 
  Priority: Takeover 
  EnumName: Fruit 
  In: apple 
  Out: pineapple 
  Includes: ["fruit.h"] 
- Rule: type_rule # Migrate "OldType" to "NewType」 
  Kind: Type 
  Priority: Takeover 
  In: OldType 
  Out: NewType 
  Includes: [] 
- Rule: disable_rule # Disable the migration of an API 
  Kind: DisableAPIMigration 
  Priority: Takeover 
  In: foo # Disable the migration of foo 
  Out: "」 
  Includes: [] 
- Rule: post_migration_rewriter_rule # Post-migration pattern rewrite rule which uses nested 
                    # string pattern search and replace to find and update 
                    # strings in the migrated code 
  Kind: PatternRewriter 
  Priority: Takeover 
  In: my_max(${args}); # Match pattern "my_max(...);" and save the arbitrary 
                        # arbitrary string between "my_max(" and ");" as ${args}.# "args" can be a user-defined name which will be 
                        # referenced by "Out" and "Subrules" Out: my_min(${args}); 
                        # Replace the pattern string to "my_min(${args});」 
  Includes: [] 
  Subrules: 
    args: # Specify the subrule to apply to ${args}, where "args」 
                         # is the user-defined name which is defined in "In".In: a # Match pattern "a" in ${args} 
      Out: b # Replace the pattern string to "b" in ${args} 
...# [YAML syntax] End the document

OutValue::= Token | Token OutValue       # OutValue is the value for the "out" key 
Token::= AnyString | Keyword             # AnyString is a string provided by the user 
Keyword::= ArgIndex 
    | $queue                             # Represents the queue string 
    | $context                           # Represents the context string 
    | $device                            # Represents the device string 
    | $deref(ArgIndex)                   # The dereferenced value of the argument 
    | $type_name_of(ArgIndex)            # The type name of the argument 
    | $deref_type(ArgIndex)              # The dereferenced type name of the argument 
    | $addr_of(ArgIndex)                 # The address of the argument 
ArgIndex::= $Int                         # Int should be a greater than zero integer

- Rule: rule_foo 
  Kind: API 
  Priority: Takeover 
  In: foo 
  Out: $type_name_of($2) new_ptr = bar($deref($1), $3) 
  Includes: ["<header3>"]

int *ptr, *ptr2; 
foo(ptr, ptr2, 30);

int *ptr, *ptr2; 
int * new_ptr = bar(*ptr, 30);