2.2.4.13.12 Folder::GetName

GetName

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include

Description

Get the name of a folder

Return the name of a folder to a string reference

Syntax

string GetName( )

BOOL GetName( string & strName )

Parameters

strName: [output] String to receive folder name

Return

Returns the name of a folder to a string

TRUE on success, FALSE if the folder is not valid.

Examples

EX1

// Try to create two subfolders of root using the same name
// Illustrates getting actual name of folder which was created
void Folder_GetName_Ex1()
{
    Folder fldRoot("/");
    Folder fldMyFolder();
    fldMyFolder = fldRoot.AddSubfolder("MyFolder");
    if( fldMyFolder.IsValid() )
    {
        string strCurrFld = fldMyFolder.GetName();
        printf("The folder name is \"%s\"\n", strCurrFld);
    }
    else
        printf("Problem in creation of /MyFolder\n");
    fldMyFolder = fldRoot.AddSubfolder("MyFolder");
    if( fldMyFolder.IsValid() )
    {
        string strCurrFld = fldMyFolder.GetName();
        printf("The folder name is \"%s\"\n", strCurrFld);
    }
    else
        printf("Problem in creation of /MyFolder\n");
}

EX2

// Another method of getting a folder name using a string reference
void    Folder_GetName_Ex2()
{
    Folder fld = Project.ActiveFolder();
    string strName;
    if( fld.GetName(strName) )
        printf("Current folder is: %s", strName);
}