Share

acedGetFullString

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.

Warning

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);

Was this information helpful?