Index Index for
Section 3X
Index Alphabetical
listing for X
Bottom of page Bottom of
page		 

XmStringNCopy(3X)


OSF/Motif


NAME

  XmStringNCopy - A compound string function that creates a copy of a
  compound string


SYNOPSIS

  #include <Xm/Xm.h>

  XmString XmStringNCopy (s1, num_bytes)
	  XmString s1;
	  int num_bytes;


DESCRIPTION

  XmStringNCopy creates a copy of s1 that contains a specified number of
  bytes, including tags, directional indicators, and separators.  It then
  returns the resulting compound string.  The original strings are preserved.
  The space for the resulting compound string is allocated within the
  function. The application is responsible for managing the allocated space.
  The memory can be recovered by calling XmStringFree.

  s1  Specifies the compound string.

  num_bytes
      Specifies the number of bytes of s1 to copy. If this value is less than
      the length of s1, as many bytes as possible, but possibly fewer than
      this value, will be appended to s1 such that the resulting string is
      still a valid compound string.


RETURN VALUE

  Returns a new compound string.


SEE ALSO

  XmStringCreate(3X), XmStringFree(3X)

Index Index for
Section 3X
Index Alphabetical
listing for X
Top of page Top of
page