---
name: "mfont_parse_name"
section: "3m17n"
platform: "linux"
package: "m17n-docs"
version: "1.8.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mfont_parse_name"
---

# mfont\_parse\_name(3m17n)

## NAME

mfont\_parse\_name -

## SYNOPSIS

**MFont**\* **mfont\_parse\_name** (const char \* *name*, MSymbol *format*)

## DESCRIPTION

Create a font by parsing a fontname. The **mfont\_parse\_name()** function creates a new font object. The properties are extracted fontname **name**.

**format** specifies the format of **name**. If **format** is **Mx**, **name** is parsed as XLFD (X Logical Font Description). If **format** is **Mfontconfig**, **name** is parsed as Fontconfig's textual representation of font. If **format** is **Mnil**, **name** is at first parsed as XLFD, and it it fails, parsed as Fontconfig's representation.

## RETURN VALUE

If the operation was successful, this function returns a pointer to the created font. Otherwise it returns `NULL`. \

## COPYRIGHT

Copyright (C) 2001 Information-technology Promotion Agency (IPA)\
 Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)\
 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License  \<http://www.gnu.org/licenses/fdl.html\>.