OLA 文档中心

主题

2026-06-30

保存到文件 - XmlSaveToFile ​

函数简介 ​

将XML文档保存到文件。

接口名称 ​

XmlSaveToFile

DLL调用 ​

c
int32_t XmlSaveToFile(int64_t doc, const char* filepath, int32_t compact, int32_t* err);

参数说明 ​

参数名类型说明
doc长整数型XML文档句柄。
filepath字符串保存的文件路径。
compact整数型是否紧凑输出（0表示格式化，1表示紧凑）。
err整数型错误码输出参数，可为 NULL。见 XML 错误码说明。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
// 假设 xmlStr 来自 HTTP 响应、配置文件或文件读取
const char* xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>";
int32_t err = 0;
int64_t doc = ola.XmlParse(xmlStr, &err);
if (doc != 0 && err == 0) {
    int32_t saveErr = 0;
    ola.XmlSaveToFile(doc, "output/config.xml", 0, &saveErr);
    ola.XmlFree(doc);
}
csharp
using OLAPlug;

var ola = new OLAPlugServer();
// 假设 xmlStr 来自 HTTP 响应、配置文件或文件读取
string xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>";
int err;
long doc = ola.XmlParse(xmlStr, out err);
if (doc != 0 && err == 0)
{
    int saveErr;
    ola.XmlSaveToFile(doc, "output/config.xml", 0, out saveErr);
    ola.XmlFree(doc);
}
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
# 假设 xml_str 来自 HTTP 响应、配置文件或文件读取
xml_str = '<root><user id="1" enabled="true" level="10"><name>ola</name><role>admin</role></user></root>'
doc, err = ola.XmlParse(xml_str)
if doc != 0 and err == 0:
    save_err = ola.XmlSaveToFile(doc, "output/config.xml", 0)
    ola.XmlFree(doc)
java
import com.olaplug.OLAPlugServer;
import com.sun.jna.ptr.IntByReference;

OLAPlugServer ola = new OLAPlugServer();
// 假设 xmlStr 来自 HTTP 响应、配置文件或文件读取
String xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>";
IntByReference err = new IntByReference(0);
long doc = com.olaplug.OLAPlugDLLHelper.XmlParse(xmlStr, err);
if (doc != 0 && err.getValue() == 0) {
    IntByReference saveErr = new IntByReference(0);
    ola.XmlSaveToFile(doc, "output/config.xml", 0, saveErr);
    ola.XmlFree(doc);
}
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
// 假设 xmlStr 来自 HTTP 响应、配置文件或文件读取
xmlStr := "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>"
var err int32
doc := ola.XmlParse(xmlStr, &err)
if doc != 0 && err == 0 {
    var saveErr int32
    ola.XmlSaveToFile(doc, "output/config.xml", 0, &saveErr)
    ola.XmlFree(doc)
}
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
// 假设 xmlStr 来自 HTTP 响应、配置文件或文件读取
let xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>";
let mut err: i32 = 0;
let doc = ola.xml_parse(&xmlStr, &mut err as *mut i32);
if doc != 0 && err == 0 {
    let mut saveErr: i32 = 0;
    ola.xml_save_to_file(doc, "output/config.xml", 0, &mut saveErr as *mut i32);
    ola.xml_free(doc);
}
cpp
var ola = com("OlaPlug.OlaSoft")
// 假设 xmlStr 来自配置文件等
var xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>"
var err = 0
var doc = ola.XmlParse(xmlStr, err)
if(doc && err == 0) {
    var saveErr = 0
    ola.XmlSaveToFile(doc, "output/config.xml", 0, saveErr)
    ola.XmlFree(doc)
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
' 假设 xmlStr 来自配置文件等
xmlStr = "<root><user id=""1"" enabled=""true"" level=""10""><name>ola</name><role>admin</role></user></root>"
err = 0
doc = ola.XmlParse(xmlStr, err)
If doc <> 0 And err = 0 Then
    saveErr = 0
    ola.XmlSaveToFile(doc, "output/config.xml", 0, saveErr)
    ola.XmlFree(doc)
End If
text
.局部变量 ola, OLAPlug
ola.创建 ()
' 假设 xmlStr 来自配置文件等
xmlStr ＝ “<root><user id=“1“ enabled=“true“ level=“10“><name>ola</name><role>admin</role></user></root>“
err ＝ 0
doc ＝ ola.XmlParse (xmlStr, err)
.如果真 (doc ≠ 0 且 err ＝ 0)
    saveErr ＝ 0
    ola.XmlSaveToFile (doc, "output/config.xml", 0, saveErr)
    ola.XmlFree (doc)
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
// 假设 xmlStr 来自配置文件等
var xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>";
var err = 0;
var doc = ola.XmlParse(xmlStr, err);
if(doc && !err){
    var saveErr = 0;
    ola.XmlSaveToFile(doc, "output/config.xml", saveErr);
    ola.XmlFree(doc);
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
// 假设 xmlStr 来自配置文件等
文本型 xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>"
整数 err = 0
长整数 doc = ola.XmlParse(xmlStr, err)
如果真 (doc ≠ 0 且 err ＝ 0)
{
    整数 saveErr = 0
    ola.XmlSaveToFile(doc, "output/config.xml", 0, saveErr)
    ola.XmlFree(doc)
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
// 假设 xmlStr 来自 HTTP 响应、配置文件或文件读取
const char* xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>";
int32_t err = 0;
int64_t doc = ola.XmlParse(xmlStr, &err);
if (doc != 0 && err == 0) {
    int32_t saveErr = 0;
    ola.XmlSaveToFile(doc, "output/config.xml", 0, &saveErr);
    ola.XmlFree(doc);
}

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
const char* xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>";
int err = 0;
long doc = XmlParse(instance, xmlStr, &err);
if (doc != 0 && err == 0) {
    int saveErr = 0;
    XmlSaveToFile(instance, doc, "output/config.xml", 0, &saveErr);
    XmlFree(instance, doc);
}
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();

long instance = CreateCOLAPlugInterFace();
string xmlStr = "<root><user id=\"1\" enabled=\"true\" level=\"10\"><name>ola</name><role>admin</role></user></root>";
int err = 0;
long doc = XmlParse(instance, xmlStr, err);
if (doc != 0 && err == 0)
{
    int saveErr = 0;
    XmlSaveToFile(instance, doc, "output/config.xml", 0, &saveErr);
    XmlFree(instance, doc);
}
python
from ctypes import CDLL, c_int, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
xml_str = b'<root><user id="1" enabled="true" level="10"><name>ola</name><role>admin</role></user></root>'
err = c_int(0)
doc = ola.XmlParse(instance, xml_str, err)
if doc and err.value == 0:
    int saveErr = 0;
    XmlSaveToFile(instance, doc, "output/config.xml", 0, &saveErr);
    ola.XmlFree(instance, doc)

返回值 ​

错误码含义见 XML 错误码说明。

返回值说明
1成功。
0失败。

注意事项 ​

项目说明
如果文件已存在如果文件已存在，会被覆盖。
如果目录不存在如果目录不存在，保存会失败。
格式compact=0 时保存格式化的XML，compact=1 时保存紧凑的XML。
路径支持相对路径和绝对路径。