---
name: "tld_get_z"
section: "3"
platform: "linux"
package: "libidn"
version: "1.44-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/tld_get_z"
---

# tld\_get\_z(3)

API function

## NAME

tld\_get\_z - API function

## SYNOPSIS

**#include \<tld.h\>**

**int tld\_get\_z(const char \*** *in***, char \*\*** *out***);**

## ARGUMENTS

- const char \* in

  Zero terminated character array to process.

- char \*\* out

  Zero terminated ascii result string pointer.

## DESCRIPTION

Isolate the top-level domain of  *in* and return it as an ASCII string in  *out* .  The input string  *in* may be UTF-8, ISO-8859-1 or any ASCII compatible character encoding.

Return value: Return **TLD\_SUCCESS** on success, or the corresponding **Tld\_rc** error code otherwise.

## REPORTING BUGS

Report bugs to \<help-libidn@gnu.org\>.\
 General guidelines for reporting bugs: https://www.gnu.org/gethelp/\
 GNU Libidn home page: https://www.gnu.org/software/libidn/

## COPYRIGHT

Copyright © 2002-2026 Simon Josefsson.\
 Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

## SEE ALSO

The full documentation for **libidn** is maintained as a Texinfo manual.  If the **info** and **libidn** programs are properly installed at your site, the command

-

  **info libidn**

should give you access to the complete manual. As an alternative you may obtain the manual from:

-

  **https://www.gnu.org/software/libidn/manual/**