Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.1.1 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2024.0.0. This page might be outdated.
However, this page did not exist in the previous stable version.

Scilab Help >> Preferences > setPreferencesValue

setPreferencesValue

Set preferences value (obsolete)

Syntax

setPreferencesValue(xpath, key_value [, doc])

Arguments

xpath

a string, represents the XPath request to get the node in the preferences file.

key_value

a 2xN matrix of strings, the key-values to set.

doc

a mlist typed XMLDoc, the XML document associated to the preference file.

Description

setPreferencesValue() is obsolete and will be removed in Scilab 6.1.x. Please use xmlSetValues() instead.

Set the values of the attributes in preferences file (SCIHOME+'/XConfiguration.xml').

Modifying incorrectly some preferences can alter Scilab's behaviour.

When doc is specified, the values are searched in this document. It is useful when several requests need to be done to avoid to parse again and again the same configuration file.

All valid XPath requests are possible. For example to write the XPath request to set proxy settings:

  • Open the file SCIHOME+'/XConfiguration.xml' and gets the nodes names to access to the expected node:

    <?xml version="1.0" encoding="utf-8" standalone="no"?>
    <interface height="600" path="1/" version="0.17" width="800">
        <general title="_(General)">
        ...
        </general>
        <web title="_(Web)">
            <body>
                <web command-browser="" command-mailer="" default-browser="true" default-mailer="true"/>
                <proxy enabled="false" host="" password="" port="" user=""/>
                <previous-proxy enabled="false" host="" password="" port="" user=""/>
            </body>
        </web>
        ...
    </interface>

    The path will be "/interface/web/body/proxy" (or to simplify "//web/body/proxy").

Examples

// Get the current values
prev = xmlGetValues("//web/body/proxy", ["enabled", "host", "port"]);
setPreferencesValue("//web/body/proxy", ["enabled", "host", "port"; "true", "my.proxy.org", "1234"]);

// Ok that's work
xmlGetValues("//web/body/proxy", ["enabled", "host", "port"])

// We restore the previous values
setPreferencesValue("//web/body/proxy", ["enabled", "host", "port" ; prev]);
xmlGetValues("//web/body/proxy", ["enabled", "host", "port"])

See also

  • xmlGetValues — Parses and gets values of chosen tags attributes in a XML file

History

VersionDescription
6.1.0 setPreferencesValue() declared obsolete, replaced with xmlSetValues().
Report an issue
<< SciNotes preferences Preferences Scilab code instrumentation >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Jan 03 14:23:44 CET 2022