Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

DwtCStrcpy(3Dwt)

Name

DwtCStrcpy, DwtCStrncpy − Copies a compound-string. 

Syntax

DwtCompString DwtCStrcpy(compound_string1)
     DwtCompString compound_string1;

DwtCompString DwtCStrncpy(compound_string1, num_chars)
     DwtCompString compound_string1;
     int num_chars;

Arguments

compound_string1
Specifies a compound-string to be copied to the output string.

num_charsSpecifies the number of characters to be copied.  If num_chars is less than the length of compound_string1, the resulting string will not be a valid compound-string. 

Description

The DwtCStrcpy function copies the string in compound_string1. 

The DwtCStrncpy function copies exactly the number of characters specified in num_chars, including the headers and trailers. 

The space for the resulting compound-string is allocated with these functions.  After using these functions, you should free this space by calling XtFree. 

Return Value

These functions return a pointer to the resulting compound-string. 

See Also

Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026