FilePathGetUniqueFilePath Method

Gets a unique file path for the given file by checking for name collisions and adding a sequence number to the end of the file name if there is a collision.

Definition

Namespace: Gemstone.IO
Assembly: Gemstone.Common (in Gemstone.Common.dll) Version: 1.0.165 -- Release Build+e14d337b173ad33e50be6747ce5b02f477f99484

C#View Source Request Example

public static string GetUniqueFilePath(
	string originalFilePath
)

VBView Source Request Example

Public Shared Function GetUniqueFilePath ( 
	originalFilePath As String
) As String

C++View Source Request Example

public:
static String^ GetUniqueFilePath(
	String^ originalFilePath
)

JavaScriptView Source Request Example

Gemstone.IO.FilePath.GetUniqueFilePath = function(originalFilePath);

Parameters

originalFilePath String: The path to the original file before adding the sequence number.

Return Value

String
The unique path to the file.

Remarks

This method is designed to handle the case where the user wishes to create a file in a folder with a given name when there is a possibility that the name is already taken. Using this method, it is possible to create files with names in the following format:

File.ext
File (1).ext
File (2).ext
...

This method uses a linear search to find a unique file name, so it is suitable for situations where there are a small number of collisions for each file name. This will detect and fill gaps that can occur when files are deleted (for instance, if "File (1).ext" were deleted from the list above).

FilePathGetUniqueFilePath Method

Definition

Parameters

Return Value

Remarks

See Also

Reference