---
name: "cgiGetValue"
section: "3"
platform: "linux"
package: "cgilib"
version: "0.6-1.1+b1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/cgiGetValue"
---

# cgiGetValue(3)

Return the value of a CGI variable

## NAME

cgiGetValue - Return the value of a CGI variable

## SYNOPSYS

```
#include <cgi.h>

char *cgiGetValue (s_cgi *parms, const char *name);
```

## DESCRIPTION

This routine returns a pointer to the value of a cgi variable. Encoded characters (%nn) are already decoded.  One must not free the pointer.

If **multiple** fields are used (i.e. a variable that may contain several values) the value returned contains all these values concatenated together with a newline character as separator.

Memory allocated by the returned value is automatically freed by the final call to [**cgiFree**(3)](/cgiFree/3.md).

## RETURN VALUE

On success a pointer to a string is returned.  If the variable wasn't transmitted through CGI or was empty NULL is returned.

## AUTHOR

This CGI library is written by Martin Schulze \<joey@infodrom.org\>.  If you have additions or improvements please get in touch with him.

## SEE ALSO

[**cgiGetVariables**(3)](/cgiGetVariables/3.md), [**cgiGetCookie**(3)](/cgiGetCookie/3.md), [**cgiGetCookies**(3)](/cgiGetCookies/3.md), [**cgiDebug**(3)](/cgiDebug/3.md), [**cgiHeader**(3)](/cgiHeader/3.md), [**cgiInit**(3)](/cgiInit/3.md), [**cgiFree**(3)](/cgiFree/3.md).