fSaveBuffer (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / External file functions

Operating mode in Windows Vista (and later)

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fSaveBuffer (Function)

In french: fSauveBuffer

Creates and fills an external file with the content of a string or buffer variable. If the file already exists, it is deleted and recreated.

Remarks:

The strings containing binary "0" ("\0") are supported.
the created file is always in ANSI format.
The buffer variable is filled by fLoadBuffer.

Example

MonBuffer is Buffer
...
fSaveBuffer("c:\tmp\MonFichier.raw", MonBuffer)

Syntax

<Result> = fSaveBuffer(<File to create> , <Content>)

<Result>: Boolean

True if the operation was successful,
False otherwise. To get more details on the error, use ErrorInfo with the errMessage constant.

<File to create>: Character string

Name and full (or relative) path of the file to create. A UNC path can be used. The file extension determines the type of file to create.
The file path can correspond to a full path or to a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder Under iPhone/iPad, on both the device and the emulator, the file system is read-only. An application can only write to its installation directory or one of its subdirectories.
The file path can correspond to a full path or to a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder: In Android, the file system is read-only on the device and on the emulator. An application can only write to its installation directory or one of its subdirectories, as well as to the external memory (SDCard).

<Content>: Buffer variable or Character String variable

Name of the Buffer or Character String variable that constitutes the content of the file.

Remarks

Operating mode in Windows Vista (and later)

If this function does not work properly in Windows Vista (and later), check whether the file or directory used is not in one of the system directories (Windows directory or "Program Files" directory).

In Windows Vista (and later), with the UAC mechanism (User Account Control) enabled, you must have administrator privileges to handle and/or modify the files or directories in system directories (Windows directory or "Program Files" directory).

Programming tip: If you need to manipulate / modify files or directories, without needing administrator privileges, it is advisable:

avoid writing to the Windows directory or to the "Program Files" directory,
use the system directory of the application (returned by SysDir with the srAppDataCommun constant, for example).

Remark: Under Windows Vista (and higher), the virtualization mechanism makes applications Vista-compatible.. If the file is created in a system directory without having sufficient rights, this file will actually be created in another directory (C:\Users\<LOGIN>AppData\Local\VirtualStore\Windows\). In this case, the file cannot be shared between several applications.

Component: wd300std.dll