C++
inline int acedGetFullString( int cronly, const ACHAR * pString, ACHAR *& pResult );
File
acedads.h
Description
Deprecated. Function acedGetFullString() is an alternate form of acedGetString(). Instead of truncating any characters beyond the 132, acedGetFullString() returns a new copy of the entire string using acutUpdString() and updates pResult to point to the new copy. Aside from the manner in which it returns the input string, this function behaves exactly like acedGetString().
The caller is responsible for freeing the returned string using acutDelString().
This function returns the same error codes as acedGetString(). If there is insufficient memory for a copy of the string, this function returns RTERROR.
Callers should always check that pResult is not null before using it. If pResult is initially null, under some conditions, acedGetFullString() returns RTNORM but pResult is not be changed, which leaves it with a null value.
See function acedGetString() for more information.
Parameters
Parameters | Description |
---|---|
cronly | Input argument to specify whether the string can contain spaces |
pString | Input prompt string |
pResult | Output pointer to a full copy of the user's input; may be null |
Use Instead
ACCORE_PORT int acedGetString(int cronly, const ACHAR *prompt, AcString &sResult);