#include <c4d_file.h>

Detailed Description

Manages file and path names.

Private Attributes
maxon::Url	dummy1

Constructors/Destructors
	Filename ()

	Filename (const Char *string)

	Filename (const maxon::String &string)

	Filename (const Filename &src)

	~Filename ()

String Content
Bool	IsPopulated () const

String	GetString () const

void	SetString (const maxon::String &str)

Directory/File Parts
const Filename	GetDirectory () const

void	SetDirectory (const Filename &str)

const Filename	GetFile () const

void	SetFile (const Filename &str)

String	GetFileString () const

Suffix Part
String	GetSuffix () const

void	SetSuffix (const maxon::String &str)

void	ClearSuffix ()

void	ClearSuffixComplete ()

Bool	CheckSuffix (const maxon::String &str) const

Read/Write Memory
void	SetMemoryReadMode (void *adr, Int size=-1, Bool transferOwnership=false)

void	SetMemoryWriteMode (MemoryFileStruct *mfs)

Operators
const Filename &	operator= (const Filename &fname)

const Filename &	operator+= (const Filename &fname)

Bool	operator== (const Filename &fname) const

Bool	operator!= (const Filename &fname) const

void	CopyTo (Filename *dst) const

Bool	IsBrowserUrl () const

Bool	FileSelect (FILESELECTTYPE type, FILESELECT flags, const maxon::String &title, const maxon::String &force_suffix=maxon::String())

const Filename	operator+ (const Filename &fname1, const Filename &fname2)

static maxon::Result< Bool >	FileSelectMultiple (FILESELECT flags, const maxon::String &title, const maxon::Url &startUrl, const maxon::Id &settingsIdentifier, const maxon::Block< maxon::Tuple< maxon::String, maxon::String >> &filterStrings, const maxon::ValueReceiver< const maxon::Url & > &selectedUrls)

Constructor & Destructor Documentation

◆ Filename() [1/4]

Filename ( )

Default constructor.

◆ Filename() [2/4]

Filename ( const Char * string )

Constructs the filename from a character array.

Parameters

[in] string The filename character array.

◆ Filename() [3/4]

Filename ( const maxon::String & string )

Constructs the filename from a string.

Parameters

[in] string The filename string.

◆ Filename() [4/4]

Filename ( const Filename & src )

Copy constructor. Creates a filename from another filename.

Parameters

[in] src The source filename.

◆ ~Filename()

~Filename ( )

Default destructor.

Member Function Documentation

◆ IsPopulated()

Bool IsPopulated ( ) const

Checks if the filename has been set.

Returns: true if filename was set, otherwise false.

◆ GetString()

String GetString ( ) const

Gets the String of the filename.

Returns: The string with the full filename.

◆ SetString()

void SetString ( const maxon::String & str )

Sets the filename to the passed string.

Parameters

[in] str The string to use to set the filename.

◆ GetDirectory()

const Filename GetDirectory ( ) const

Gets the directory that the file is located.

Returns: The directory part for the filename.

◆ SetDirectory()

void SetDirectory ( const Filename & str )

Sets the directory for the filename. The file part remains unchanged.

Parameters

[in] str The directory to set for the filename.

◆ GetFile()

const Filename GetFile ( ) const

Gets the file part of the filename only, without the path.

Returns: The file part of the filename.

◆ SetFile()

void SetFile ( const Filename & str )

Sets the file part for the filename. The directory part remains unchanged.

Parameters

[in] str The file part to set for the filename.

◆ GetFileString()

String GetFileString ( ) const

Convenience function to directly get the file part string. Identical to GetFile().GetString().

Returns: The file part of the filename as a string.

◆ GetSuffix()

String GetSuffix ( ) const

Gets the suffix of the filename.

Note: Suffix strings do not contain the dot character '.'.

Returns: The suffix. Only contains the suffix part without dot (e.g. "TIF").

◆ SetSuffix()

void SetSuffix ( const maxon::String & str )

Sets the suffix part of the filename.

Note: Suffix strings do not contain the dot character '.'.

Parameters

[in] str A string with the suffix for the file. Only contains the suffix part and no dot (e.g. "TIF").

◆ ClearSuffix()

void ClearSuffix ( )

Clears the suffix part of the filename.

◆ ClearSuffixComplete()

void ClearSuffixComplete ( )

Same as ClearSuffix() only that it also clears suffixes longer than seven characters.

◆ CheckSuffix()

Bool CheckSuffix ( const maxon::String & str ) const

Checks if the suffix of the filename is the same as its string.

Parameters

[in] str The suffix to check against.

Returns: true if the suffix was checked successfully, otherwise false.

◆ SetMemoryReadMode()

void SetMemoryReadMode	(	void *	adr,
		Int	size = `-1`,
		Bool	transferOwnership = `false`
	)

Sets the filename to read from a memory block instead of from a file.

Parameters

[in]	adr	The memory to read from. The caller owns the pointed memory block.
[in]	size	The size of memory block starting at adr, or -1 if the buffer is "big enough".
[in]	transferOwnership	If true the ownership of the memory block is transfered to the caller, who then needs to free the memory with DeleteMem(). Otherwise (false by default) the memory block will be freed when the MemoryFileStruct is destructed.

◆ SetMemoryWriteMode()

void SetMemoryWriteMode ( MemoryFileStruct * mfs )

Sets the filename to write to a memory block instead of to a file.

Parameters

[in] mfs The memory file to write to. The caller owns the pointed memory file.

◆ operator=()

const Filename& operator= ( const Filename & fname )

Assignment operator. Assigns the right-operand filename to the left-operand filename.

Parameters

[in] fname The right-operand filename.

Returns: The left-operand filename.

◆ operator+=()

const Filename& operator+= ( const Filename & fname )

Concatenates the filenames and set the left-hand operand to the result.

Parameters

[in] fname The right-operand filename.

Returns: The left-operand filename.

◆ operator==()

Bool operator== ( const Filename & fname ) const

Checks if two filenames are equal.

Parameters

[in] fname The right-operand filename.

Returns: true if filenames are equal, otherwise false.

◆ operator!=()

Bool operator!= ( const Filename & fname ) const

Check if two filenames are different.

Parameters

[in] fname The right-operand filename.

Returns: true if filenames are different, otherwise false.

◆ CopyTo()

void CopyTo ( Filename * dst ) const

Copies the filename to dst.

Parameters

[out] dst The destination filename. The caller owns the pointed filename.

◆ IsBrowserUrl()

Bool IsBrowserUrl ( ) const

Checks if the filename is a content browser url.

Returns: true if the filename is a browser url, otherwise false.

◆ FileSelect()

Bool FileSelect	(	FILESELECTTYPE	type,
		FILESELECT	flags,
		const maxon::String &	title,
		const maxon::String &	force_suffix = `maxon::String()`
	)

Opens a file selector dialog. Example: To load a file:

Bool ok = fn.FileSelect(FILESELECTTYPE::ANYTHING, FILESELECT::LOAD, "Load");

Bool

maxon::Bool Bool

Definition: ge_sys_math.h:55

FILESELECT::LOAD

@ LOAD

Load dialog.

FILESELECTTYPE::ANYTHING

@ ANYTHING

Any file.

To save a bmp file:

Bool ok = fn.FileSelect(FILESELECTTYPE::IMAGES, FILESELECT::SAVE, "Save", "bmp");

FILESELECT::SAVE

@ SAVE

Save dialog.

FILESELECTTYPE::IMAGES

@ IMAGES

Image files.

Parameters

[in]	type	The type of file to show in the file selector: FILESELECTTYPE
[in]	flags	The file selector flags: FILESELECT
[in]	title	The title for the file selector dialog.
[in]	force_suffix	Set this to suffix to force a filename suffix when in save mode.

Returns: true if the user selected a file, otherwise false.

◆ FileSelectMultiple()

static maxon::Result<Bool> FileSelectMultiple	(	FILESELECT	flags,
		const maxon::String &	title,
		const maxon::Url &	startUrl,
		const maxon::Id &	settingsIdentifier,
		const maxon::Block< maxon::Tuple< maxon::String, maxon::String >> &	filterStrings,
		const maxon::ValueReceiver< const maxon::Url & > &	selectedUrls
	)

static

FileSelectMultiple allows to select files or folders in a OS file chooser dialog.

Parameters

[in]	flags	Flags see FILESELECT.
[in]	title	Title to be set in the window.
[in]	startUrl	Start url to select in the file chooser.
[in]	settingsIdentifier	Identifier to store settings for different callers (e.g. window dimensions etc). Every caller can have different settings. Keep empty for default settings
[in]	filterStrings	Array with tuples for valid file suffixes. first: name, second: ; seperated list of suffixes. e.g. BaseArray<Tuple<String, String>> filterStrings; filterStrings.Append({"All files"_s, "."_s}) iferr_return; filterStrings.Append({"3D-Formats"_s, ".c4d;.dem;.dxf;.iob;.lwo;.lws;.3dm;.3dmf;.ai;.ps;.wrl;.3ds;.obj;.mon;.dae;.dwg;.fbx;.igs"_s}) iferr_return;
[out]	selectedUrls	Value receiver which is triggered for every selected url.

Returns: True on success. False if user canceled. Error otherwise.

Friends And Related Function Documentation

◆ operator+

const Filename operator+	(	const Filename &	fname1,
		const Filename &	fname2
	)

friend

Concatenates the two filenames. It will join directories and files parts.

Parameters

[in]	fname1	The left-operand filename.
[in]	fname2	The right-operand filename.

Returns: The result of the concatenation of the 2 filenames.

Member Data Documentation

◆ dummy1

maxon::Url dummy1

private

Detailed Description

Private Attributes

Constructors/Destructors

String Content

Directory/File Parts

Suffix Part

Read/Write Memory

Operators

Constructor & Destructor Documentation

◆ Filename() [1/4]

◆ Filename() [2/4]

◆ Filename() [3/4]

◆ Filename() [4/4]

◆ ~Filename()

Member Function Documentation

◆ IsPopulated()

◆ GetString()

◆ SetString()

◆ GetDirectory()

◆ SetDirectory()

◆ GetFile()

◆ SetFile()

◆ GetFileString()

◆ GetSuffix()

◆ SetSuffix()

◆ ClearSuffix()

◆ ClearSuffixComplete()

◆ CheckSuffix()

◆ SetMemoryReadMode()

◆ SetMemoryWriteMode()

◆ operator=()

◆ operator+=()

◆ operator==()

◆ operator!=()

◆ CopyTo()

◆ IsBrowserUrl()

◆ FileSelect()

◆ FileSelectMultiple()

Friends And Related Function Documentation

◆ operator+

Member Data Documentation

◆ dummy1