---
name: "libmawk_initialize"
section: "3libmawk"
platform: "linux"
package: "libmawk1t64"
version: "1.0.4-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/libmawk_initialize"
---

# libmawk\_initialize(3libmawk)

create a new libmawk context

## NAME

libmawk\_initialize - create a new libmawk context

## SYNOPSIS

```
#include <libmawk.h>

mawk_state_t *libmawk_initialize(int s, char *argv[]);
```

## DESCRIPTION

The **libmawk\_initialize**() function returns a pointer to a newly created libmawk context. Any amount of libmawk contexts can live in parallel in an application. Arguments are the same as for a command line mawk session. Scripts are loaded (either from command line or from files using -f), variables are set (with -v), special options are set (with -W), etc.

## RETURN VALUE

A pointer to a new libmawk context or NULL on error.

## SEE ALSO

**libmawk\_initialize\_stage**(3libmawk), **libmawk\_uninitialize**(3libmawk),