NAME

strwidth - returns the width of the specified text string

SPECIFICATION

C
long strwidth(str)
String str;

FORTRAN
integer*4 function strwid(str, length)
character*(*) str
integer*4 length

Pascal
function strwidth(str: pstring128): longint;

DESCRIPTION

strwidth returns the width, in pixels, of a text string, using the character spacing parameters of the currently selected raster font.  strwidth is useful only when there is a simple mapping from screen to world space.  The user must do the mapping. 

Undefined characters have zero width. 

In FORTRAN, there are two arguments to strwid : str is the name of the string and length is the number of characters in that string. 

SEE ALSO

getheight, getlwidth, mapw, mapw2

NOTE

This command can be used only in immediate mode. 

Version 2.4  —  May 08, 1986