Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.1.1 - Français

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

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

Aide de Scilab >> API Scilab > legacy > Scilab Gateway API > sci_types

sci_types

a C enumeration which defines the types available for a variable

Description

A C enumeration which defines the types available for a variable. You must include stack-c.h to benefit from this type definition.

The list of available types is the following:

  • 1 - sci_matrix: a matrix of doubles

  • 2 - sci_poly: a polynomials matrix

  • 4 - sci_boolean: a boolean matrix

  • 5 - sci_sparse: a sparse matrix

  • 6 - sci_boolean_sparse: a sparse boolean matrix

  • 7 - sci_matlab_sparse: a sparse matlab matrix

  • 8 - sci_ints: a matrix of integers

  • 9 - sci_handles: a graphical handle

  • 10 - sci_strings: a matrix of strings

  • 11 - sci_u_function: an uncompiled Scilab function

  • 13 - sci_c_function: a compiled Scilab function

  • 14 - sci_lib: a library of Scilab functions

  • 15 - sci_list: a Scilab list

  • 16 - sci_tlist: a Scilab tlist

  • 17 - sci_mlist: a Scilab mlist

  • 18 - sci_struct: a Scilab struct

  • 19 - sci_cell: a Scilab cell

  • 128 - sci_pointer (was: sci_lufact_pointer before Scilab 5.2): a pointer

Integers or enumeration types can be used to check the type of the variables. Using the enumeration type is recommended because of the explicit meaning of the value of the enumeration type.

Examples

In this example, the C gateway function takes one argument. Through a switch case structure, we display the type of the variable sent as a parameter.

#include "api_scilab.h"
#include "sciprint.h"

int sci_mysci_typesrhs(char * fname, void* pvApiCtx)
{
    int         iType = 0;
    int*        piAddr = NULL;
    SciErr      sciErr;

    sciErr = getVarAddressFromPosition(pvApiCtx, 1, &piAddr);
    if(sciErr.iErr)
    {
        printError(&sciErr, 0);
        return 1;
    }

    sciErr = getVarType(pvApiCtx, piAddr, &iType);
    if(sciErr.iErr)
    {
        printError(&sciErr, 0);
        return 1;
    }

    switch(iType)
    {
    case sci_matrix:
        sciprint("A matrix of doubles\n");
        break;
    case sci_poly:
        sciprint("A matrix of polynomials\n");
        break;
    case sci_boolean:
        sciprint("A matrix of booleans\n");
        break;
    case sci_sparse:
        sciprint("A sparse matrix of doubles\n");
        break;
    case sci_boolean_sparse:
        sciprint("A sparse matrix of booleans\n");
        break;
    case sci_matlab_sparse:
        sciprint("A sparse matlab matrix\n");
        break;
    case sci_ints:
        sciprint("A matrix of integers\n");
        break;
    case sci_handles:
        sciprint("A graphic handle\n");
        break;
    case sci_strings:
        sciprint("A matrix of strings\n");
        break;
    case sci_u_function:
        sciprint("An uncompiled Scilab function\n");
        break;
    case sci_c_function:
        sciprint("A compiled Scilab function\n");
        break;
    case sci_lib:
        sciprint("A library of Scilab functions\n");
        break;
    case sci_list:
        sciprint("A Scilab list\n");
        break;
    case sci_tlist:
        sciprint("A Scilab tlist\n");
        break;
    case sci_mlist:
        sciprint("A Scilab mlist\n");
        break;
    case sci_pointer:
        sciprint("A pointer\n");
        break;
    default:
        sciprint("Unknown type !\n"); // Should never happen
    }

    return 0;
}

See also

Report an issue
<< Scierror Scilab Gateway API sciprint >>

Copyright (c) 2022-2024 (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:33:09 CET 2022