Technical Reference: Base Operating System and Extensions, Volume 1

layout_object_shapeboxchars Subroutine

Purpose

Shapes box characters.

Library

Layout Library (libi18n.a)

Syntax

#include <sys/lc_layout.h>

int layout_object_shapeboxchars( layout_object, InpBuf, InpSize, OutBuf) LayoutObject layout_object; const char *InpBuf; const size_t InpSize; char *OutBuf;

Description

The layout_object_shapeboxchars subroutine shapes box characters into the VT100 box character set.

Note: If you are developing internationalized applications that may support multibyte locales, please see Use of the libcur Package in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs

Parameters

layout_object	Specifies the LayoutObject structure created by the layout_object_create subroutine.
InpBuf	Specifies the source text to be processed.
InpSize	Specifies the number of code elements to be processed.
OutBuf	Contains the shaped output text.

Return Values

Upon successful completion, this subroutine returns a value of 0.

Error Codes

If this subroutine fails, it returns the following values:

LAYOUT_EILSEQ	Shaping stopped due to an input code element that cannot be mapped into the VT100 box character set.
LAYOUT_EINVAL	Shaping stopped due to an incomplete code element or shift sequence at the end of the input buffer.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The layout_object_create (layout_object_create Subroutine) subroutine, layout_object_editshape (layout_object_editshape or wcslayout_object_editshape Subroutine) subroutine, layout_object_free (layout_object_free Subroutine) subroutine, layout_object_getvalue (layout_object_getvalue Subroutine) subroutine, layout_object_setvalue (layout_object_setvalue Subroutine) subroutine, layout_object_transform (layout_object_transform or wcslayout_object_transform Subroutine) subroutine.

Bidirectionality and Character Shaping Overview in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

National Language Support Overview for Programming in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.