オブジェクトルーチン：
アトリビュート ユーティリティ関数 (１つの値の関数)

以下のルーチンは、シンプルな get および set による long、float、t_symbol * のアトリビュートの値へのアクセスを提供します。これらは、どんなアトリビュートに対しても使用することができますが、複数の値を持つアトリビュートのインスタンス内であっても、アトリビュートのデータ配列の最初の要素しか返しません。

object_attr_getlong
     
  与えられた親オブジェクトとアトリビュート名から、アトリビュートの値を得るために、object_attr_getlong 関数を使います。
   
  long object_attr_getlong(void *x, t_symbol *s);
     
  x アトリビュートの親オブジェクト
  s アトリビュートの名前
     
 

このルーチンは、成功した場合には、指定されたアトリビュートの値を返し、失敗した場合には０を返します。アトリビュートが関数で指定された型でない場合、このルーチンはアトリビュートからの有効な値を強制的に型変換しようとします。


object_attr_getfloat
     
  与えられた親オブジェクトとアトリビュート名から、アトリビュートの値を得るために、object_attr_getfloat 関数を使います。
   
  float object_attr_getfloat(void *x, t_symbol *s);
     
  x アトリビュートの親オブジェクト
  s アトリビュートの名前
     
 

このルーチンは、成功した場合には、指定されたアトリビュートの値を返し、失敗した場合には０を返します。アトリビュートが、関数で指定された型でない場合、このルーチンは、アトリビュートからの有効な値を強制的に型変換しようとします。


object_attr_getsym
     
  与えられた親オブジェクトとアトリビュート名から、アトリビュートの値を得るために、object_attr_getsym 関数を使います。
   
  t_symbol *object_attr_getsym(void *x, t_symbol *s);
     
  x アトリビュートの親オブジェクト
  s アトリビュートの名前
     
 

このルーチンは、成功した場合には、指定されたアトリビュートの値を返し、失敗した場合には空のシンボル（gensym("") または _sym_nothing と同じもの）を返します。


object_attr_setlong
     
  与えられた親オブジェクトとアトリビュート名によって、アトリビュートの値をセットするために、 object_attr_setlong 関数を使います。このルーチンは、与えられたデータを使って、アトリビュートの set メソッドを呼び出します。
   
  t_max_err object_attr_setlong(void *x, t_symbol *s, long c);
     
  x アトリビュートの親オブジェクト
  s アトリビュートの名前
  c 整数（int）; アトリビュートのための新しい値
     
 

このルーチンは、成功するとエラーコード MAX_ERR_NONE を返し、失敗した場合には“ext_obex.h”で定義される他のエラーコードの１つを返します。


object_attr_setfloat
     
 

与えられた親オブジェクトとアトリビュート名によって、アトリビュートの値をセットするために、
object_attr_ setfloat 関数を使います。このルーチンは、与えられたデータを使って、アトリビュートの setメソッドを呼び出します。

   
  t_max_err object_attr_setfloat(void *x, t_symbol *s, float c);
     
  x アトリビュートの親オブジェクト
  s アトリビュートの名前
  c 浮動小数点数（float）; アトリビュートのための新しい値
     
 

このルーチンは、成功するとエラーコード MAX_ERR_NONE を返し、失敗した場合には“ext_obex.h”で定義される他のエラーコードの１つを返します。


object_attr_setsym
     
  与えられた親オブジェクトとアトリビュート名によって、アトリビュートの値をセットするために、 object_attr_setsym 関数を使います。このルーチンは、与えられたデータを使って、アトリビュートの set メソッドを呼び出します。
   
  t_max_err object_attr_setsym(void *x, t_symbol *s, t_symbol *c);
     
  x アトリビュートの親オブジェクト
  s アトリビュートの名前
  c t_symbol * ; アトリビュートのための新しい値
     
 

このルーチンは、成功するとエラーコード MAX_ERR_NONE を返し、失敗した場合には“ext_obex.h”で定義される他のエラーコードの１つを返します。