Skip to content

    TCustomIniFile.Create

    Instantiate a new instance of TCustomIniFile.

    Declaration

    Source position: inifiles.pp line 176

    public 
constructor Create(const AFileName: string; 
                  ADefaultEncoding: TEncoding; 
                  AOptions: TIniFileOptions=[]);

constructor Create(const AFileName: string; 
                  ADefaultEncoding: TEncoding; AOwnsEncoding: Boolean; 
                  AOptions: TIniFileOptions=[]);

constructor Create(const AFileName: string; 
                  AOptions: TIniFileOptions=[]);  virtual;

constructor Create(const AFileName: string; AEscapeLineFeeds: Boolean)
                  ;  virtual;

    Description

    Create creates a new instance of TCustomIniFile and loads it with the data from AFileName, if this file exists. If the ifoEscapeLineFeeds option is present in AOptions or AEscapeLineFeeds parameter is True, then lines which have their end-of-line markers escaped with a backslash, will be concatenated. This means that the following 2 lines 

    Description=This is a \
line with a long text

    is equivalent to 

    Description=This is a line with a long text

    By default, not escaping of linefeeds is performed (for Delphi compatibility)

    Default options for the TCustomIniFile.Options property can be specified in AOptions.

    A Default string encoding can be specified in aEncoding. If aOwnsEncoding is True the encoding will be freed when the ini file instance is destroyed.

    Errors

    If the file cannot be read, an exception may be raised.

    See also

    Name Description
    Destroy Remove the TCustomIniFile instance from memory.
    TCustomIniFile.Options Options currently in effect.