GLib.test_init
Description: Reference for GLib.test_init

### Function

# GLibtest_init

since: 2.16

#### Declaration [src]

    void
    g_test_init (
      int* argc,
      char*** argv,
      ...
    )

#### Description [src]

Initializes the GLib testing framework.

This includes seeding the test random number generator, setting the program name, and parsing test-related commandline args.

This should be called before calling any other `g_test_*()` functions.

The following arguments are understood:

- `-l`: List test cases available in a test executable.
- `--seed=SEED`: Provide a random seed to reproduce test runs using random numbers.
- `--verbose`: Run tests verbosely.
- `-q`, `--quiet`: Run tests quietly.
- `-p PATH`: Execute all tests matching the given path.
- `-s PATH`: Skip all tests matching the given path. This can also be used to force a test to run that would otherwise be skipped (ie, a test whose name contains “/subprocess”).
- `-m {perf|slow|thorough|quick|undefined|no-undefined}`: Execute tests according to these test modes:

`perf`: Performance tests, may take long and report results (off by default).

`slow`, `thorough`: Slow and thorough tests, may take quite long and maximize coverage (off by default).

`quick`: Quick tests, should run really quickly and give good coverage (the default).

`undefined`: Tests for undefined behaviour, may provoke programming errors under `g_test_trap_subprocess()` or `g_test_expect_message()` to check that appropriate assertions or warnings are given (the default).

`no-undefined`: Avoid tests for undefined behaviour.

- `--debug-log`: Debug test logging output.

Any parsed arguments are removed from `argv`, and `argc` is adjust accordingly.

The following options are supported:

- `G_TEST_OPTION_NO_PRGNAME`: Causes `g_test_init()` to not call `g_set_prgname()`. Since. 2.84
- `G_TEST_OPTION_ISOLATE_DIRS`: Creates a unique temporary directory for each unit test and sets XDG directories to point there for the duration of the unit test. See `G_TEST_OPTION_ISOLATE_DIRS`.
- `G_TEST_OPTION_NONFATAL_ASSERTIONS`: This has the same effect as `g_test_set_nonfatal_assertions()`. Since 2.84

Since 2.58, if tests are compiled with `G_DISABLE_ASSERT` defined, `g_test_init()` will print an error and exit. This is to prevent no-op tests from being executed, as `g_assert()` is commonly (erroneously) used in unit tests, and is a no-op when compiled with `G_DISABLE_ASSERT`. Ensure your tests are compiled without `G_DISABLE_ASSERT` defined.

Available since: 2.16

This function is not directly available to language bindings.

#### Parameters

`argc`

  Type: `int*`

  Address of the `argc` parameter of `main()`.

  The data is owned by the caller of the function.

`argv`

  Type: `char***`

  Address of the `argv` parameter of `main()`.

  The data is owned by the caller of the function.
  The value is a NUL terminated UTF-8 string.

`...`

  Type: ``

  `NULL`-terminated list of special options.