SLLIB + SFITSIO ダイジェスト版 HTML マニュアル

使用頻度の高い API について，主要な内容を記述した， ビギナー向けのリファレンスマニュアルです．

SLLIB: 文字列連想配列 (asarray_tstringクラス)

asarray_tstring は文字列の連想配列を扱うためのクラスで，tstring クラスと 同様，スクリプト言語のような強力な文字列処理用 API を提供します． asarray_tstring のオブジェクト内では， tstringクラス のオブジェクト配列 が管理されており，各要素の参照を引き出す事で，tstring クラスの メンバ関数も使用可能です． 配列用バッファはほぼ完全な自動管理であり， 配列に対するアドレスを使う事がほとんど無く高い安全性を確保します． 下記のような機能を持ちます．

• ほぼ完全な文字列バッファの自動管理 (自動確保・自動拡張・自動開放)
• 要素単位のアクセス
• 値のセット，追加，挿入等で printf() の記法が使える API
• 文字列のデリミタでの分割
• 左右の空白，改行文字の除去
• 正規表現による置換
• キー文字列，要素文字列に対するポインタ配列の取得 など

asarray_tstring クラスは単独のクラスです．継承関係はありません．

型の定義:

namespace sli {
  typedef struct {
    const char *key;
    const char *value;
  } asarrdef_tstring;
}

基本機能のためのメンバ関数

tstring &operator[]( const char *key );
const tstring &operator[]( const char *key ) const;

asarray_tstring &operator=( const asarray_tstring &obj );

size_t length() const;

自身の連想配列の長さ(個数)を返します．

const char *const *cstrarray() const;

tstring &at( const char *key );
tstring &atf( const char *fmt, ... );
const tstring &at( const char *key ) const;
const tstring &atf( const char *fmt, ... ) const;
const tstring &at_cs( const char *key ) const;
const tstring &atf_cs( const char *fmt, ... ) const;

ssize_t index( const char *key ) const;
ssize_t indexf( const char *fmt, ... ) const;

const char *key( size_t index ) const;

const tarray_tstring &keys() const;

const tarray_tstring &values() const;

void dprint( const char *msg = NULL ) const;

asarray_tstring &swap( asarray_tstring &sobj );

asarray_tstring &init();
asarray_tstring &init( const asarray_tstring &obj );

asarray_tstring &assign( const asarrdef_tstring elements[] );
asarray_tstring &assign( const asarrdef_tstring elements[], size_t n );
asarray_tstring &assign( const char *key0, const char *val0,
                         const char *key1, ... );

asarray_tstring &assign_keys( const char *key0, ... );
asarray_tstring &assign_keys( const char *const *keys );
asarray_tstring &assign_keys( const tarray_tstring &keys );

asarray_tstring &assign_values( const char *val0, ... );
asarray_tstring &assign_values( const char *const *values );
asarray_tstring &assign_values( const tarray_tstring &values );

文字列の内容を元に，キーや値をセットするためのメンバ関数

asarray_tstring &split_keys( const char *src_str, const char *delims,
                             bool zero_str = false );
asarray_tstring &split_keys( const char *src_str, const char *delims, 
                             bool zero_str,
                             const char *quotations, int escape, bool rm_escape );

asarray_tstring &split_values( const char *src_str, const char *delims,
                               bool zero_str = false );
asarray_tstring &split_values( const char *src_str, const char *delims, 
                               bool zero_str,
                               const char *quotations, int escape, bool rm_escape );

連想配列の編集のためのメンバ関数

asarray_tstring &append( const char *key, const char *val );
asarray_tstring &appendf( const char *key, const char *fmt, ... );

asarray_tstring &append( const asarray_tstring &src );
asarray_tstring &append( const asarrdef_tstring elements[] );
asarray_tstring &append( const asarrdef_tstring elements[], size_t n );
asarray_tstring &append( const char *key0, const char *val0, 
                         const char *key1, ... );

asarray_tstring &insert( const char *key,
                         const char *newkey, const char *newval );
asarray_tstring &insertf( const char *key,
                          const char *newkey, const char *fmt, ... );

asarray_tstring &insert( const char *key, const asarray_tstring &src );
asarray_tstring &insert( const char *key, const asarrdef_tstring elements[] );
asarray_tstring &insert( const char *key,
                         const asarrdef_tstring elements[], size_t n );
asarray_tstring &insert( const char *key, 
                         const char *key0, const char *val0, 
                         const char *key1, ... );

asarray_tstring &erase();
asarray_tstring &erase( const char *key, size_t num_elements = 1 );

asarray_tstring &clean( const char *str = "" );

asarray_tstring &rename_a_key( const char *org_key, const char *new_key );

全配列要素に対する編集のためのメンバ関数

asarray_tstring &chomp( const char *rs = "\n" );

asarray_tstring &trim( const char *side_spaces = " \t\n\r\f\v" );
asarray_tstring &trim( int side_space );

asarray_tstring &ltrim( const char *side_spaces = " \t\n\r\f\v" );
asarray_tstring &ltrim( int side_space );

asarray_tstring &rtrim( const char *side_spaces = " \t\n\r\f\v" );
asarray_tstring &rtrim( int side_space );

asarray_tstring &strreplace( const char *org_str, const char *new_str,
                             bool all = false );

asarray_tstring &regreplace( const char *pat, 
                             const char *new_str, bool all = false );
asarray_tstring &regreplace( const tregex &pat, 
                             const char *new_str, bool all = false );

asarray_tstring &tolower();

asarray_tstring &toupper();