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

# mfont\_get\_prop(3m17n)

## NAME

mfont\_get\_prop -

## SYNOPSIS

void\* **mfont\_get\_prop** (**MFont** \* *font*, MSymbol *key*)

## DESCRIPTION

Get a property value of a font. The **mfont\_get\_prop()** function gets the value of **key** property of font **font**. **key** must be one of the following symbols:

`Mfoundry`, `Mfamily`, `Mweight`, `Mstyle`, `Mstretch`, `Madstyle`, `Mregistry`, `Msize`, `Mresolution`, `Mspacing`.

If **font** is a return value of **mfont\_find()**, **key** can also be one of the following symbols:

**Mfont\_ascent**, **Mfont\_descent**, **Mmax\_advance**.

## RETURN VALUE

If **key** is `Mfoundry`, `Mfamily`, `Mweight`, `Mstyle`, `Mstretch`, `Madstyle`, `Mregistry`, or `Mspacing`, this function returns the corresponding value as a symbol. If the font does not have **key** property, it returns `Mnil`. If **key** is `Msize`, `Mresolution`, **Mfont\_ascent**, Mfont\_descent, or **Mmax\_advance**, this function returns the corresponding value as an integer. If the font does not have **key** property, it returns 0. If **key** is something else, it returns `NULL` and assigns an error code to the external variable **merror\_code**. \

## 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\>.
