SoMFInt32(3IV)

NAME
     SoMFInt32 (SoMInt32) - multiple-value field containing any number of
     int32_t integers

INHERITS FROM
     SoField > SoMField > SoMFInt32

SYNOPSIS
     #include <Inventor_c/fields/SoMFInt32.h>

     typedef SoMFInt32   SoMInt32

          Functions from class SoMFInt32:

     SoType              SoMInt32GetClassTypeId()
     void                SoMInt32GetTypeId(const SoMInt32 *this)
     int32_t             SoMInt32Get(const SoMInt32 *this, int i)
     const int32_t *     SoMInt32GetN(const SoMInt32 *this, int start)
     int                 SoMInt32Find(SoMInt32 *this, int32_t targetValue,
                              SbBool addIfNotFound = FALSE)
     void                SoMInt32SetN(SoMInt32 *this, int start, int num,
                              const int32_t *newValues)
     void                SoMInt32Set1(SoMInt32 *this, int index, int32_t
                              newValue)
     void                SoMInt32Set(SoMInt32 *this, int32_t newValue)
     int                 SoMInt32IsEq(const SoMInt32 *this, const SoMFInt32
                              *f)
     int                 SoMInt32IsNEq(const SoMInt32 *this, const SoMFInt32
                              *f)
     int32_t *           SoMInt32StartEdit(SoMInt32 *this)
     void                SoMInt32FinishEdit(SoMInt32 *this)

          Functions from class SoMField:

     int                 SoMInt32GetNum(const SoMInt32 *this)
     void                SoMInt32SetNum(SoMInt32 *this, int num)
     void                SoMInt32Del(SoMInt32 *this, int start, int num = -1)
     void                SoMInt32InsertSpace(SoMInt32 *this, int start, int
                              num)
     void                SoMInt32Get1(SoMInt32 *this, int index, SbString
                              *valueString)

          Functions from class SoField:

     void                SoMInt32SetIgnored(SoMInt32 *this, SbBool ignore)
     SbBool              SoMInt32IsIgnored(const SoMInt32 *this)
     SbBool              SoMInt32IsDflt(const SoMInt32 *this)
     SbBool              SoMInt32IsOfType(const SoMInt32 *this, SoType type)
     SbBool              SoMInt32SetFromStr(SoMInt32 *this, const char
                              *valueString)
     void                SoMInt32GetIntoStr(SoMInt32 *this, SbString
                              *valueString)
     void                SoMInt32Touch(SoMInt32 *this)
     SbBool              SoMInt32ConnFromField(SoMInt32 *this, SoField
                              *fromField)
     SbBool              SoMInt32ConnFrom(SoMInt32 *this, SoEngineOutput
                              *fromEngine)
     void                SoMInt32Disconn(SoMInt32 *this)
     SbBool              SoMInt32IsConn(const SoMInt32 *this)
     SbBool              SoMInt32IsConnFromField(const SoMInt32 *this)
     SbBool              SoMInt32GetConnField(const SoMInt32 *this, SoField
                              **writingField)
     SbBool              SoMInt32IsConnFromEngine(const SoMInt32 *this)
     SbBool              SoMInt32GetConnEngine(const SoMInt32 *this,
                              SoEngineOutput **engineOutput)
     void                SoMInt32EnableConn(SoMInt32 *this, SbBool flag)
     SbBool              SoMInt32IsConnEnabled(const SoMInt32 *this)
     int                 SoMInt32GetForwardConn(const SoMInt32 *this,
                              SoFieldList *list)
     SoFieldContainer *  SoMInt32GetContainer(const SoMInt32 *this)


DESCRIPTION
     A multiple-value field that contains any number of int32_t (32-bit)
     integers.

     SoMFInt32s are written to file as one or more integer values, in decimal,
     hexadecimal or octal format. When more than one value is present, all of
     the values are enclosed in square brackets and separated by commas; for
     example:

          [ 17, -0xE20, -518820 ]



FUNCTIONS
     SoType              SoMInt32GetClassTypeId()
     void                SoMInt32GetTypeId(const SoMInt32 *this)
          Returns the type for this class or a particular object of this
          class.

     int32_t             SoMInt32Get(const SoMInt32 *this, int i)
          Returns the i'th value of the field. Indexing past the end of the
          field (passing in i greater than getNum()) will return garbage.

     const int32_t *     SoMInt32GetN(const SoMInt32 *this, int start)
          Returns a pointer into the array of values in the field, starting at
          index start. The values are read-only; see the
          startEditing()/finishEditing() methods for a way of modifying values
          in place.

     int                 SoMInt32Find(SoMInt32 *this, int32_t targetValue,
                              SbBool addIfNotFound = FALSE)
          Finds the given value in the array and returns the index of that
          value in the array. If the value is not found, -1 is returned. If
          addIfNotFound is set, then targetValue is added to the end of the
          array (but -1 is still returned).

     void                SoMInt32SetN(SoMInt32 *this, int start, int num,
                              const int32_t *newValues)
          Sets num values starting at index start to the values in newValues.
          The array will be automatically be made larger to accomodate the new
          values, if necessary.

     void                SoMInt32Set1(SoMInt32 *this, int index, int32_t
                              newValue)
          Sets the index'th value in the array to newValue. The array will be
          automatically expanded, if necessary.

     void                SoMInt32Set(SoMInt32 *this, int32_t newValue)
          Sets the first value in the array to newValue, and deletes the
          second and subsequent values.

     int                 SoMInt32IsEq(const SoMInt32 *this, const SoMFInt32
                              *f)
     int                 SoMInt32IsNEq(const SoMInt32 *this, const SoMFInt32
                              *f)
          Returns TRUE if all of the values of this field equal (do not equal)
          those of the given field. If the fields are different types FALSE
          will always be returned (even if one field is an SoMFFloat with one
          value of 1.0 and the other is an SoMFInt with a value of 1, for
          example).

     int32_t *           SoMInt32StartEdit(SoMInt32 *this)
     void                SoMInt32FinishEdit(SoMInt32 *this)
          startEditing() returns a pointer to the internally-maintained array
          that can be modified. The values in the array may be changed, but
          values cannot be added or removed. It is illegal to call any other
          editing methods between StartEdit() and FinishEdit() (e.g. Set1(),
          Set(), etc).

          Fields, engines or sensors connected to this field and sensors are
          not notified that this field has changed until FinishEdit() is
          called. Calling  FinishEdit() always sets the IsDflt flag to FALSE
          and informs engines and sensors that the field changed, even if none
          of the values actually were changed.