constants-and-functions.md

description
Description of constants and functions

Constants & Functions

Starting from v0.8.2, HyperDbg supports functions in the script engine. Here's a description of how function can be defined within scripts.

Naming convention

We suggest using snake_case as the naming convention. However, you can use any other naming conventions as well.

Functions

HyperDbg functions are defined using the same syntax as the C programming language.

Function: void

This is an example of a function that does not return any value (void). This code defines my_func which prints two integers. It's called three times with arguments (1, 2). Then, it prints the hexadecimal value of variable my_var, which is 79.

? {
    
  void my_func(int var, int var2) {
    printf("var = %d, var2 = %d\n", var, var2);
    return;
    printf("this statement is never shown!\n");
  }
  
  for (int i = 0; i < 3; i++) {
    my_func(1, 2);
  }

  int my_var = 79;
  printf("%x\n", my_var);
}

Function: int

This is an example of functions that return an integer. This code defines four functions: my_func1, my_func2, my_func3, and my_func4.

my_func1 adds 1 to its argument and prints the result.

my_func2 multiplies its argument by 2 and prints the result.

my_func3 also multiplies its argument by 2 and prints the result.

my_func4 calls my_func1, my_func2, and my_func3, then sums their results and prints the total.

Finally, it calls my_func4 with an argument of 2 and prints the result.

? {
    
  int my_func1(int var1) {
    result = var1 + 1;
    printf("my_func1 %d\n", result);
    return result;
  }
  
  int my_func2(int var1) {
    result = var1 * 2;
    printf("my_func2 %d\n", result);
    return result;
  }
  
  int my_func3(int var1) {
    result = var1 * 2;
    printf("my_func3 %d\n", result);
    return result;
  }
  
  int my_func4(int var1) {
    result = my_func1(var1) + my_func2(var1) + my_func3(var1);
    printf("my_func4 %d\n", result);
    return result;
  }

  printf("%d\n", my_func4(2));
}

Examples

Example 1: Recursive Fibonacci

The following function calculates the nth Fibonacci number recursively.

? {

  int my_func(int var1) {
    if (var1 == 0) {
      return 0;
    }
    if (var1 == 1) {
      return 1;
    }
    return my_func(var1 - 1) + my_func(var1 - 2);
  }
  
  var = my_func(9);
  printf("%d", var);
}

Example 2: Iterative Fibonacci

This function calculates the nth Fibonacci number iteratively using a loop.

? {

  int my_func(int varn) {
      
    int varf0 = 0;
    int varf1 = 1;
    int varfn = 0; //comment

    if (varn == 0) {
      return varf0;
    }
    if (varn == 1) {
      return varf1;
    }

    int i = 0;
    
    for (i = 2; i <= varn; i++) {
      varfn = varf0 + varf1;
      varf0 = varf1;
      varf1 = varfn;
    }
    return varfn;
  }
  
  printf("%d", my_func(9));
}

Constants

At the moment, dslang does not support constants but the support for these items will be added to the script-engine in future versions!