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

# mtext\_get\_prop\_keys(3m17n)

## NAME

mtext\_get\_prop\_keys -

## SYNOPSIS

int **mtext\_get\_prop\_keys** (**MText** \* *mt*, int *pos*, MSymbol \*\* *keys*)

## DESCRIPTION

Get a list of text property keys at a position of an M-text. The **mtext\_get\_prop\_keys()** function creates an array whose elements are the keys of text properties found at position **pos** in M-text **mt**, and sets \***keys** to the address of the created array. The user is responsible to free the memory allocated for the array.

## RETURN VALUE

If the operation was successful, **mtext\_get\_prop\_keys()** returns the length of the key list. Otherwise it returns -1 and assigns an error code to the external variable **merror\_code**.

## ERRORS

`MERROR_RANGE`

## SEE ALSO

**mtext\_get\_prop()**, **mtext\_put\_prop()**, **mtext\_put\_prop\_values()**, **mtext\_get\_prop\_values()**, **mtext\_push\_prop()**, **mtext\_pop\_prop()**\

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