extension_to_save_format method

extension_to_save_format(extension)

Converts a file name extension into a SaveFormat value.

def extension_to_save_format(self, extension: str):
    ...

Parameter	Type	Description
extension	str	The file extension. Can be with or without a leading dot. Case-insensitive.

Remarks

If the extension cannot be recognized, returns SaveFormat.UNKNOWN.

Exceptions

exception	condition
RuntimeError (Proxy error(ArgumentNullException))	Throws if the parameter is None.

Examples

Shows how to use the FileFormatUtil methods to detect the format of a document.

# Load a document from a file that is missing a file extension, and then detect its file format.
with system_helper.io.File.open_read(MY_DIR + 'Word document with missing file extension') as doc_stream:
    info = aw.FileFormatUtil.detect_file_format(stream=doc_stream)
    load_format = info.load_format
    self.assertEqual(aw.LoadFormat.DOC, load_format)
    # Below are two methods of converting a LoadFormat to its corresponding SaveFormat.
    # 1 -  Get the file extension string for the LoadFormat, then get the corresponding SaveFormat from that string:
    file_extension = aw.FileFormatUtil.load_format_to_extension(load_format)
    save_format = aw.FileFormatUtil.extension_to_save_format(file_extension)
    # 2 -  Convert the LoadFormat directly to its SaveFormat:
    save_format = aw.FileFormatUtil.load_format_to_save_format(load_format)
    # Load a document from the stream, and then save it to the automatically detected file extension.
    doc = aw.Document(stream=doc_stream)
    self.assertEqual('.doc', aw.FileFormatUtil.save_format_to_extension(save_format))
    doc.save(file_name=ARTIFACTS_DIR + 'File.SaveToDetectedFileFormat' + aw.FileFormatUtil.save_format_to_extension(save_format))

See Also

• module aspose.words
• class FileFormatUtil