Content-type: text/html Man page of m_setvalues_layout

m_setvalues_layout

Section: Layout Service Library Functions (3LAYOUT)
Updated: 8 Jun 1999
Index Return to Main Contents
 

NAME

m_setvalues_layout - set layout values of a LayoutObject  

SYNOPSIS

cc [ flag... ] file... -llayout [ library... ]
#include <sys/layout.h>

int m_setvalues_layout(LayoutObject layout_object, const LayoutValues values, int *index_returned);  

DESCRIPTION

The m_setvalues_layout() function changes the layout values of a LayoutObject.

The layout_object argument specifies a LayoutObject returned by the m_create_layout(3LAYOUT) function.

The values argument specifies the list of layout values that are to be changed. The values are written into the LayoutObject and may affect the behavior of subsequent layout functions. Some layout values do alter internal states maintained by a LayoutObject.

The m_setvalues_layout() function can be implemented as a macro that evaluates the first argument twice.  

RETURN VALUES

Upon successful completion, the requested layout values are set and 0 is returned. Otherwise -1 is returned and errno is set to indicate the error. If any value cannot be set, none of the layout values are changed and the (zero-based) index of the first value causing the error is returned in index_returned.  

ERRORS

The m_setvalues_layout() function may fail if:

EINVAL The layout value specified by index_returned is unknown, its value is invalid, or the layout_object argument is invalid.

EMFILE There are {OPEN_MAX} file descriptors currently open in the calling process.

 

USAGE

Do not use expressions with side effects such as auto-increment or auto-decrement within the first argument to the m_setvalues_layout() function.  

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe

 

SEE ALSO

m_create_layout(3LAYOUT), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
USAGE
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:38:32 GMT, October 02, 2010