otsu.hiNote

クラス hiU

java.lang.Object

otsu.hiNote.hiU

public class hiU
extends Object

hiNoteシステムの核として表示、トレースなどに焦点を絞ったメソッドを用意しています。

 汎用データ表示機構 hiU.str()

hiU.str(Object)で toStringを持つオブジェクトも、 配列やList,Map,toStringメソッドを持たないクラスオブジェクトも表示できます。 階層化していても構いません。型によって呼び分ける必要はありません。
hiFieldFormat.オプション一覧にあるオプションを指定することにより表示形式を選択できます。

   int                 i     = 7;
   int                 ai[]  ={ 1,2,3 };
   String              ss[][]={{"abc","def"},{"uvw","xyz"},{"ABC","XYZ"}};
   ArrayList<String[]> as=new ArrayList<String[]>();
                          as.add(ss[0]);as.add(ss[1]);as.add(ss[2]);
   HashMap<String,String> dict=new HashMap<String,String>();
                          dict.put("a","A");dict.put("b","B");
   class X {
     int    x;
     int    y;
     String s;
     X(int x_,int y_,String s_){x=x_;y=y_;s=s_;}
     }
   X x=new X(3,7,"abc");
   ---
   System.out.println(hiU.str(i));
    ⇒ 7 // 単純値
   System.out.println(hiU.str(ai));
    ⇒ [1, 2, 3] // 配列
   System.out.println(hiU.str(ss));
    ⇒ [[abc, def], [uvw, xyz], [ABC, XYZ]] // 配列の配列
   System.out.println(hiU.str(as));
    ⇒ [[abc, def], [uvw, xyz], [ABC, XYZ]] // 配列のリスト
   System.out.println(hiU.str(dict));
    ⇒ {a=A, b=B} // Map(辞書)
   System.out.println(hiU.str(x));
    ⇒ {x=3, y=7, s=abc} // 自作クラス
   System.out.println(hiU.str(x,hiU.WITH_INDENT));
   // 自作クラス,インデント付き
    ⇒ {
      x=3
     ,y=7
     ,s=abc}
   System.out.println(hiU.str(x,hiU.WITH_INDENT|hiU.WITH_TYPE));
   // 自作クラス,インデント,型名付き
    ⇒ (X){
      x=(int)3
     ,y=(int)7
     ,s=(String)abc}

 連結式API

表示形態に関する指定の多くはstr()メソッドに付加するフラグ指定ですが、表示長リミットや深さ制限など数値指定のものや、アノーテーションを無効化する設定などは専用関数で行います。

メソッドはstr_forma()に続くカスケード式でstrで終端します。

   String _text=hiU.str_format()
                   .str_limit(30)
                   .str_depth(2)
                   .str_ignore_annotations(hiU.AsHex.class,hiU.AsBase64.class)
                              .for_classes(X.class,Y.class,Z.class)
                   .str(_data);

                    // JSON_STYLEに設定されているUSE_AT_FIELDを無効にする
   String _json=hiU.str_format()
                   .str_disable_option(hiU.USE_AT_FIELD)
                   .str(_data,hiU.JSON_STYLE)

 デバグ用関数階層ログ機能 hiU.i(),hiU.m(),hiU.o()

関数の呼び出し階層を表示するデバグ用ログ出力機能を持ちます。
関数の入り口でi()、出口前でo()を呼び出せばの関数入りと出としてしてネスト形式のトレース文がログファイルに出力されます。
関数の中でm(String)を用いればネスト形式でトレース文が出ます。

// 次の様なクラスがあり、幾つかの階層を経て呼び出されると
class MyClass {
   final static boolean D=true;
   void woo(int n_){
      if(D) hiU.i("n_="+n_);
      // 何か処理
      if(D) hiU.m("message");
      // 
      if(D) hiU.o();
      }
   };
// 次のように呼び出し階層が表示されます。上位階層はhiU.i()無でも表示されます。
0001 - > Test.main  
0001 |  - > TestClass2.boo (from Test.main#98)  
0001 |  |  - > TestClass.foo (from TestClass2.boo#Test.java.62)  
0001 |  |  |  --> MyClass.woo#Test.java.15 (from TestClass.foo#Test.java.54) n_=13
0001 |  |  |  |  [#Test.java.17] message
0001 |  |  |  <-- MyClass.woo#Test.java.19 (to TestClass.foo#Test.java.54) 
表示されるのはクラス名.関数名#ファイル.行番号とhiU.i()の場合は呼び出し元の情報です。

 出口での出力を自動にする。

hiTry.Tクラスインスタンスをtryブロックで使用すれば、ブロックの出入りでトレースが出ます。途中で抜けても出トレースがでます。

// 次の様なクラスがあり、幾つかの階層を経て呼び出されると
class MyClass {
   final static boolean D=true;
   void WOO(int n_){try(hiTry.T t=hiTry.T.t(D,"n="+n_);){
      // 何か処理
      if(D) hiU.m("message");  // line 23
      if( n_>1 ) return;       // line 24
      if(D) hiU.m("message2"); // line 25
      }}                       // line 26
   }
// 次のように呼び出し階層が表示されます。
0001 |  - > TestClass2.BOO (from Test.main#101)  
0001 |  |  - > TestClass.FOO (from TestClass2.BOO#Test.java.65)  
0001 |  |  |  --> MyClass.WOO#Test.java.21 (from TestClass.FOO#Test.java.57) n=13
0001 |  |  |  |  [#Test.java.23] message
0001 |  |  |  <-- MyClass.WOO#Test.java.26 (to TestClass.FOO#Test.java.57) 
// この例ではline 25でメッセージを出す前にreturnしています。残念ながら現版ではreturnの行番号ではなくブロックの終わりの行番号が表示されます。

 出力先やフォーマットの変更。

出力先はデフォルトでは標準エラー出力(errですが、 変更することも 追加することも可能です。
標準エラーと特定のファイルに同時に出すといったことも可能です。
行先頭の番号はスレッドidです。マルチスレッドで出力しても行の途中で混ざることはありません。
行先頭のフォーマットは変更可能で日付、時刻、ミリ秒なども表示することができます。

トレース文のフォーマットは@link otsu.hiNote.hiStack#setTraceFormat(String,long,int)}で変更できます。
スレッド毎に異なるフォーマットを置きたい場合はhiStack.setThreadTraceFormat(String,long,int)で変更できます。
設定法はhiStack.setTraceFormat(String,long,int)を参照してください。

トレース先はデフォルトでは標準エラーです。
環境変数"hiTRACE"にファイル名を指定することにより、出力先を変更できます。
ファイル名には時刻、スレッドIDを付加することができます。時刻はタスク起動時 のもので"日_時分秒_ミリ秒"の形式となります。時刻は${TIME}、スレッドIDは${TID} で指定します。スレッドID指定をした場合は、１タスク内でも異なるスレッドは それぞれのスレッドIDを付けたファイルに出力されます。

  例)
   SET hiTRACE=test.log                 単純名     test.log
   SET hiTRACE=test_${TIME}.log         時刻       test_26_183020_033.log
   SET hiTRACE=test_${TID}.log          スレッドID test_0049.log
   SET hiTRACE=test_${TIME}_${TID}.log  混合       test_26_183020_033_0049.log

名前指定の場合、出力の度にオープン/クローズを繰り返します。
hiTRACE指定には補助的オプションがあります。ファイル名の後ろにセミコロンでつなぎます。

	KEEP_OTHER		標準エラーへの出力を停止しません
	NO_APPEND		最初にオープンするとき、APPENDモードにしません
	KEEP_OPEN		オープンしっぱなしにします。この指定がない場合出力の度にクローズします
	NO_ERR		ファイルIOエラーを標準出力に出しません

 例）
   SET hiTRACE=test.log;NO_APPEND;KEEP_OTHER

i(),o()などのログ出力の他、別ファイルへのテストログ出力を行う関数 t(Object...),tn(int,Object...)が用意されています。
出力先は10個まで設定できtn(int,Object...)では0～9までの 数値で出力先を指定できます。
環境変数"hiLOG"にファイル名を指定することにより、出力先を変更できます。
ファイル名の前に一桁の数字とコロンを付けることにより0番から9番までの 設定となります。

  例)
   === 環境変数設定
   SET hiLOG=0:test.log      0番の出力をtest.logとする
   SET hiLOG=1:kekka.txt     0番の出力をtest.logとする
   === プログラム
   hiU.tn(0,"abc");            test.logに"abc"が出力される
   hiU.tn(1,"abc");            kekka.txtに"abc"が出力される

出力の度にオープン/クローズを繰り返します。

 ライブラリ内共通フラグ

hiUはライブラリ内で共通に使うフラグ値の定義を持ちます。
ライブラリ内のフラグ-APIはlongを使いますが、hiU.XXXXで与えられるフラグはintの範囲に収めてあります、

値(16進)	値(2進/半分)	値(10進)	名前
0000 0000	---- 0000 0000 0000 0000	0	NO_OPTION, NONE
0000 0001	---- 0000 0000 0000 0001	1	SKIP, CHECK_ESCAPE, AS_MEMBER, HEIGHT,
0000 0002	---- 0000 0000 0000 0010	2	RETRY, WITH_NEW_ID, NO_GROUP, DOUBLE_QUOTE_FOR_CHAR, WIDTH
0000 0004	---- 0000 0000 0000 0100	4	NO_ESCAPE
0000 0008	---- 0000 0000 0000 1000	8	NO_LIMIT, DEEP, OTHER_NO_LIMIT, SKIP_FUNC_NAME
0000 0010	---- 0000 0000 0001 0000	16	CLOSE_EACH_TIME, IGNORE_LEVEL, IGNORE_TOP_LEVEL, AS_SAME_LEVEL, SINGLE_REGION
0000 0020	---- 0000 0000 0010 0000	32	MEMORY_SAVE, SAVE_MEMORY, REUSE_ADDR, BYTE_AS_DEC, NO_QUOTE_CONCAT,
0000 0040	---- 0000 0000 0100 0000	64	OMIT_EMPTY_MAP_ELEMENT, NO_LINE_NUMBER, SPEED
0000 0080	---- 0000 0000 1000 0000	128	KEEP_QUOTE, AUTO_FLUSH, BODY, EVEN_FINAL_STATIC, AS_IS
0000 0100	---- 0000 0001 0000 0000	256	KEEP_NULL, EVEN_NULL, WITH_TYPE, WITH_NAME
0000 0200	---- 0000 0010 0000 0000	512	KEEP_LINE_SEPARATOR, NO_TRIM, WITH_COLON, NUMERICAL_REFERENCE
0000 0400	---- 0000 0100 0000 0000	1024	NO_QUOTE, DO_TRIM, CHECK_UNKNOWN_FIELD, DECODE
0000 0800	---- 0000 1000 0000 0000	2048	KEEP_SPACE, WITH_SINGLE_QUOTE
0000 1000	---- 0001 0000 0000 0000	4096	OMIT_NULL, OMIT_EMPTY_ELEMENT, IF_EXIST
0000 2000	---- 0010 0000 0000 0000	8192	SPACE_AS_DLMT, END_AT_EOF, AS_NO_DISP, TERSE, OMIT_CALLER
0000 4000	---- 0100 0000 0000 0000	16384	IGNORE_QUOTE, WITH_INDENT
0000 8000	---- 1000 0000 0000 0000	32768	OMIT_SPACE, IGNORE_SPACE, NO_FLUSH, NAME_WITH_QUOTE
0001 0000	0000 0000 0000 0001 ----	65536	AS_STRING, KEEP_BOM, INDENT_WITH_BAR, ADD_BOM
0002 0000	0000 0000 0000 0010 ----	131072	AS_EMPTY_STRING, NO_ERR_PRINT
0004 0000	0000 0000 0000 0100 ----	262144	CONCAT_STR, WITH_BEGIN_END, IGNORE_toString
0008 0000	0000 0000 0000 1000 ----	524288	KEEP_OPEN, NO_BEGIN_END, TARGET_CLASS_toString
0010 0000	0000 0000 0001 0000 ----	1048576	ONLY_FIRST, DELETE_ON_ERROR, SHALLOW, EVEN_PRIVATE_STATIC, AS_OBJECT
0020 0000	0000 0000 0010 0000 ----	2097152	KEEP_REDUNDANCY, KEEP_DELIMITER, VERBOSE, APPEND, USE_AT_FIELD
0040 0000	0000 0000 0100 0000 ----	4194304	KEEP_ON_ERROR, DOUBLE_QUOTE_FOR_MAP_KEY, AS_NULL
0080 0000	0000 0000 1000 0000 ----	8388608	ONLY_ONE_TARGET, ONLY_TARGET_CLASS, OMIT_LAST_SPACE, OMIT_SUFFIX,
0100 0000	0000 0001 0000 0000 ----	16777216	DO_NOT_CREATE_FOLDER, SINGLE_LINE_STRING, AS_null_DISP
0200 0000	0000 0010 0000 0000 ----	33554432	CHECK_COMMENT, MIDDLE, WITH_INDEX, WITH_ADDR, WITH_LINE_NUMBER, WITH_STACK
0400 0000	0000 0100 0000 0000 ----	67108864	ONLY_PUBLIC, ONLY_MATCHED, CHECK_QUOTE, LAST, PUBLIC_ONLY
0800 0000	0000 1000 0000 0000 ----	134217728	KEEP_LAST_NULL, CHECK_TOP, TOP, OMIT_UNDERSCORED
1000 0000	0001 0000 0000 0000 ----	268435456	NO_COMMENT, STRICT, PACK_BYTES, INTOLERANCE
2000 0000	0010 0000 0000 0000 ----	536870912	FORCE, WITH_EXCEPTION, DIRECT, LITERAL, EVEN_JAVA_CLASS
4000 0000	0100 0000 0000 0000 ----	1073741824	MODERATE, NOT_STRICT, TOLERANCE, SPACE_AS_USUAL_CHAR NO_EXCEPTION, SHORT_AS_HEX, IGNORE_CASE
8000 0000	1000 0000 0000 0000 ----	-2147483648	REVERSE, WEAK

 例外について

otsu.hiNoteライブラリではExceptionは次の方針に従って取り扱われます。

• 実装メソッドにはThrowsを付けない（付けたとしてもRuntimeExceptionの派生のみ）
• interfaceのメソッドは全てThrows Exceptionとする。

実装メソッド内では発生するExceptionを hiU.rap(ex)を用いて hiException(RuntimeExceptionの派生)として再throwしています。発生したExceptionが 例えばIOExceptionであればcauseにIOExceptionを持つhiExceptionが throwされ、発生したExceptionがRuntimeExceptionであればそのままthrow されます。

   public void someFunc(){ // throwsを持たない
      try{
         // throws定義を持つメソッド呼び出し
         }
      catch(Exception ex){
         throw hiU.rap(ex);
         }
      }

ラムダ式用のInterfaceは全てthrows Exceptionを持つものとしています。
従ってラムダ式内ではthrows Exceptionを持つメソッド(例えばIOメソッド）などを呼ぶ場合でもExceptionの隠ぺい処理を行う必要がありません。
ライブラリ側でhiExceptionでラッピングします。

 UTF-8の標準出力と標準エラー出力 hiU.out hiU.err

hiU.out,hiU.errはそれぞれSystem.outとSystem.errを文字コードUTF-8用にオープンし直したものです。

System.out,System.errと同じ様に使用できます。

System.outとSystem.errと同じくPrintStreamとなっています。

PrintWriter化したhiU.out_pw,hiU.err_pwも用意してあります。

 バージョン３で他クラスに引き渡されたメソッド

バージョン２ではhiUの多くのメソッドは他クラスで実行され、hiUは中継のみ行っていました。
このためhiUはメソッドが多く、JAVADOC内での検索に支障をきたしていました。
バージョン３ではhiU.i(),hiU.str(),hiU.hex()といったデバグ用の表記を残し、他の中継を取りやめました。

hiUクラスから別クラスに移されたものを以下に載せます。

hiHexに移動 hiHexは16進文字列とバイナリデータの変換を行います バイト単位の細かい操作はhiBytesが取り扱います。
hiU.halfByteChar	⇒	hiHex.halfByteChar
hiU.halfByteCharSmall	⇒	hiHex.halfByteCharSmall
hiU.byteStr	⇒	hiHex.byteStr
hiU.byteStrSmall	⇒	hiHex.byteStrSmall
hiU.hex	⇒	hiHex.str
hiU.encodeHex	⇒	hiHex.encodeHex
hiU.parseHex	⇒	hiHex.parseHex
hiU.getHexBytes	⇒	hiHex.toBytes
hiU.str2bytes	⇒	hiHex.str2bytes
hiBytesに移動
hiU.getBinBytes	⇒	hiBytes.getBinBytes
hiU.newBytes	⇒	hiBytes.newBytes
hiU.bitOff	⇒	hiBytes.bitOff
hiU.bitOn	⇒	hiBytes.bitOn
hiU.ints	⇒	hiBytes.ints
hiU.bytes	⇒	hiBytes.bytes
hiTextに移動
hiU.trim	⇒	hiText.trim
hiU.trimTop	⇒	hiText.trimTop
hiU.trimLast	⇒	hiText.trimLast
hiU.tokens	⇒	hiText.tokens
hiU.divide	⇒	hiText.divide
hiU.join	⇒	hiText.join
hiU.detab	⇒	hiText.detab
hiU.justSize	⇒	hiText.justSize
hiU.length2	⇒	hiText.length2
hiU.justSize2	⇒	hiText.justSize2
hiU.fill	⇒	hiText.fill
hiU.fill2	⇒	hiText.fill2
hiU.replace	⇒	hiText.replace
hiU.shorten	⇒	hiText.shorten
hiU.shortenTop	⇒	hiText.shortenTop
hiU.shortenLast	⇒	hiText.shortenLast
hiU.shortenLast2	⇒	hiText.shortenLast2
hiU.dbgStr	⇒	hiText.dbgStr
hiU.trimComment	⇒	hiText.trimComment
hiU.trimQuote	⇒	hiText.trimQuote
hiU.space	⇒	hiText.space
hiU.lastPart	⇒	hiText.lastPart
hiU.basePart	⇒	hiText.basePart
hiU.lastName	⇒	hiText.lastName
hiU.replaceUniCode	⇒	hiText.replaceUniCode
hiU.isAlphaNumeric	⇒	hiText.isAlphaNumeric
hiFileに移動
hiU.delete	⇒	hiFile.delete
hiU.asBufferedReader	⇒	hiFile.asBufferedReader
hiU.openPrintStream	⇒	hiFile.openPrintStream
hiU.canOpenFileR	⇒	hiFile.canOpenFileR
hiU.canOpenResFileR	⇒	hiFile.canOpenResFileR
hiU.openResTextFileR	⇒	hiFile.openResTextFileR
hiU.skipUTF8BOM	⇒	hiFile.skipUTF8BOM
hiU.readByte	⇒	hiFile.readBytes/td>
hiU.readBytes	⇒	hiFile.readBytes
hiU.tryReadBytes	⇒	hiFile.tryReadBytes
hiU.absolutePath	⇒	hiFile.absolutePath
hiU.parentPath	⇒	hiFile.parentPath
hiU.path	⇒	hiFile.path
hiU.readLines	⇒	hiFile.readTextAll
hiTimeに移動
hiU.dispTime	⇒	hiTime.dispTime
hiU.timeDiff	⇒	hiTime.timeDiff
hiU.lapTime	⇒	hiTime.lapTime
hiU.currentMilliSec	⇒	hiTime.currentMilliSec
hiU.currentTime	⇒	hiTime.currentTime
hiU.sleep	⇒	hiTime.sleep
hiArgsに移動
hiU.args	⇒	hiArgs.args
hiArraysに移動
hiU.parseInts	⇒	hiArrays.parseInts
hiU.intsToLong	⇒	hiArrays.intsToLong
hiU.shortsToInt	⇒	hiArrays.shortsToInt
hiU.intToShorts	⇒	hiArrays.intToShorts
hiU.atoa	⇒	hiArrays.atoa
hiU.toStrArrayList	⇒	hiArrays.toStrArrayList
hiU.toStrArray	⇒	hiArrays.toStrArray
hiU.toList	⇒	hiArrays.toList
hiU.lastOf	⇒	hiArrays.lastOf
hiU.get	⇒	hiArrays.get
hiU.shuffle	⇒	hiArrays.shuffled_ints
hiStackに移動
hiU.getStackTrace	⇒	hiStack.getStackTrace
hiU.setTraceFormat	⇒	hiStack.setTraceFormat
hiU.Traceに移動
hiU.setLogFile	⇒	hiU.str,hiU.Trace.setLogFile
hiU.setTraceFile	⇒	hiU.str,hiU.Trace.setTraceFile
hiU.setPrinter	⇒	hiU.str,hiU.Trace.setPrinter
hiU.addPrinter	⇒	hiU.str,hiU.Trace.addPrinter
hiU.delPrinter	⇒	hiU.str,hiU.Trace.delPrinter
hiU.delPrinters	⇒	hiU.str,hiU.Trace.delPrinters
hiU.setTraceFormat	⇒	hiU.str,hiU.Trace.setTraceFormat
hiU.setTraceFold	⇒	hiU.str,hiU.Trace.setTraceFold
hiU.setThreadTraceFormat	⇒	hiU.str,hiU.Trace.setThreadTraceFormat
hiU.get_trace_format_expanded	⇒	hiU.str,hiU.Trace.get_trace_format_expanded
hiU内で統合されたもの
hiU.toString	⇒	hiU.str,hiU.strs
hiU.parseInt	⇒	hiU.atoi
hiU.parseLong	⇒	hiU.atol
hiU.parseDouble	⇒	hiU.atod
hiU.parseBoolean	⇒	hiU.atob
hiU標準入出力の扱い WindowsでもUTF-8で出すようにしました。
System.out	:	(PrintStream)hiU.out (UTF-8)
System.err	:	(PrintStream)hiU.err (UTF-8)
System.out	:	(PrintWriter)hiU.out_pw(UTF-8)
System.err	:	(PrintWriter)hiU.err_pw(UTF-8)
hiU.out	⇒	PrintWriterからPrintStream(UTF-8)に変更
hiU.err	⇒	PrintWriterからPrintStream(UTF-8)に変更
hiU.out_utf8	⇒	hiU.out_pw
hiU.err_utf8	⇒	hiU.err_pw
hiU以外でも一部クラスが整理されました。 ここに合わせて載せます。 XML系など一部のクラスははotsu.hiNoteパッケージからotsu.hiGadgetパッケージに移動しました。 otsu.hiNoteとotsu.hiGadetは同一のjarで配布されます。 ビルド法はこれまでと同じで各ソースで  import otsu.hiGagde.* を加えると使用できます。
hiSocket.udp	:	hiSocket.UdpIF
hiUDPSocket	:	hiSocket.UDP
hiMulticastSocket	:	hiSocket.UDP.Multicast
hiObjectSocket	:	hiSocket.TCP
hiTextSocket	:	hiSocket.TCP.ForText
hiObjectSocket	:	hiSocket.TCP.ForObject
hiValue	:	hiRef.V1
hiPair	:	hiRef.V2
hiTrio	:	hiRef.V3
hiLRegress(直線回帰)	:	hiRegress.Linear
hiQRegress(二次回帰)	:	hiRegress.Quad
hiLastValue	:	hiLastValue
hiLastIntValues	:	hiLastValues.Int
hiLastDoubleValues	:	hiLastValues.Dbl
hiSyncDque	:	(hiGadget)hiSyncDque
hiSyncAque	:	(hiGadget)hiSyncAque
hiSyncCounter	:	(hiGadget)hiSyncCounter
hiJSONutl	:	(hiGadget)hiJSONutl
hiXML	:	(hiGadget)hiXML
hiDom	:	(hiGadget)hiDom
hiHTTP	:	(hiGadget)hiHTTP
hiLinesReader	:	(hiGadget)hiLinesReader
hiTextWriter	:	(hiGadget)hiTextWriter
hiTemplate	:	(hiGadget)hiTemplate
hiLinesReader	:	(hiGadget)hiLinesReader

 

ネストされたクラスのサマリー

ネストされたクラス

修飾子とタイプ	クラスと説明
static interface	hiU.AcceptTypes @AcceptTypes.
static interface	hiU.AltName @AltNames 解釈用代替名 データ解釈時の代替名です。
static interface	hiU.AsBase64 バイト配列をbase64形式で表示する.
static interface	hiU.AsHex バイト配列を先頭に#を付加した16進表示する hiU.str()でバイト配列を先頭に#を付加した16進表示します。
static interface	hiU.BiConsumerEx<T,U,X extends Exception> 例外を持つBiConsumer(引数２個、メソッドはaccept).
static interface	hiU.BiFunctionEx<T,U,R,X extends Exception> 例外を持つ引数２個のFunction(メソッドはapply).
static interface	hiU.ConsumerEx<T,X extends Exception> 例外を持つConsumer(引数１個メソッドはaccept).
static interface	hiU.FunctionEx<T,R,X extends Exception> 例外を持つ引数１個Function(戻り値一個メソッドはapply).
static interface	hiU.Optional @Printable オプショナルフィールド
static interface	hiU.Printable @Printable 印字可能.
static interface	hiU.PrintAs @PrintAs 印字フォーマット指定 str(Object) 指定のフォーマットで印字します
static interface	hiU.PrinterIF hiUのログ機能で使用する仮想プリンタ.
static interface	hiU.PrintName @PrintName 印字用代替名.
static interface	hiU.QuadrConsumerEx<T1,T2,T3,T4,X extends Exception> 例外を持つQuadrConsumer(引数４個、メソッドはaccept).
static interface	hiU.QuadrFunctionEx<T1,T2,T3,T4,R,X extends Exception> 例外を持つ引数４個のFunction(メソッドはapply).
static interface	hiU.RunnableEx<X extends Exception> 例外を持つRunnable(引数無し、メソッドはrun).
static interface	hiU.SupplierEx<R,X extends Exception> 例外を持つSupplier(引数１個、戻り値無し、メソッドはget).
static class	hiU.Trace ログ/トレースに関するメソッド群
static interface	hiU.TriConsumerEx<T,U,V,X extends Exception> 例外を持つTriConsumer(引数３個、メソッドはaccept).
static interface	hiU.TriFunctionEx<T,U,V,R,X extends Exception> 例外を持つ引数３個のFunction(メソッドはapply).
static interface	hiU.TypeHintField @TypeHintField.
static class	hiU.UnexpectedEOFException 予期しないEOF.
static interface	hiU.UnPrintable @UnPrintable 印字しない.

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static String	_v_ ライブラリのバージョン
static long	ADD_BOM PrintStream生成時にBOMを先頭に付ける(UTF-8のみ).
static Pattern	ALPHA_NUMERIC_STR_EXPR_PAT 英数字文字列の正規表現Pattern.
static String	ALPHA_NUMERIC_STR_EXPR_STR 英数字文字列の正規表現.
static long	APPEND 追加モード.
static long	AS_EMPTY_STRING nullとせず空文字列とする.
static long	AS_IS 変更を施さずそのまま.
static long	AS_MEMBER メンバーとして扱う hiU.str()のオプション。
static long	AS_NO_DISP nullを表示しない.
static long	AS_NULL 空文字列とせずnullとする hiText.tokens(String,String,long)、hiArgs.args(String[],long) のオプション動作指定として用います。
static long	AS_null_DISP null時に"null"文字列を表示する.
static long	AS_OBJECT Objectとして送信する hiUDPPrintWriterで文字列を単純byte並びではなくJavaのオブジェクトプロトコルで送信します。
static long	AS_SAME_LEVEL 自動toStringでベースクラス要素を引き上げ展開する 自動toString実行時にベースクラスの要素を派生クラスに展開します。
static long	AS_STRING JSON解析時にbool,doubleを文字列型にする.
static long	AUTO_FLUSH オートフラッシュモード テキストファイルオープンでオートフラッシュモード指定を行う。
static long	BODY BODY部の処理をする hiText.xmlEscape(String,long) のオプションに指定すると、引用符などattribute用のエスケープ は行いません。
static long	BYTE_AS_DEC byte値表示時に10進数を用いる.
static String	CHAR_SET hiUで使う標準の文字セット（UTF-8)
static Charset	charSet_UTF8 UTF-8のCharset
static long	CHECK_COMMENT コメントをチェックする.
static long	CHECK_ESCAPE '\'(逆スラッシュ)をエスケープとして処理する.
static long	CHECK_QUOTE 引用をチェックする.
static long	CHECK_TOP 先頭をチェックする.
static long	CHECK_UNKNOWN_FIELD 指定フィールドが無い場合エラーとする.
static long	CHECK_UNSET_FIELD 値が設定されないフィールドをチェックする.
static long	CLOSE_EACH_TIME ファイルを毎回クローズする hiU管理ログファイルは出力の度にオープン/クローズを行うことが できる。
static long	CONCAT_STR 引用符の繋がりで結合しない.
static long	DECODE デコードします
static long	DEEP 深いデータ複製をとる.
static long	DELETE_ON_ERROR 失敗時削除.
static long	DIRECT 直接実行.
static long	DO_NOT_CREATE_FOLDER ファイル生成時にフォルダは生成しない.
static long	DO_TRIM 空白、null値のトリミングを行う.
static long	DOUBLE_QUOTE_FOR_CHAR char表示でダブルクオートを使う.
static long	DOUBLE_QUOTE_FOR_MAP_KEY Mapのキー表示に引用符を付ける hiU.str(Object,option)による表示でMapのキー引用符が無い場合、付加します。
static byte[]	EMPTY_BYTE_ARRAY 要素数0のbyte配列
static int[]	EMPTY_INT_ARRAY 要素数0のint配列
static String	EMPTY_STRING 空文字列
static String[]	EMPTY_STRING_ARRAY 要素数0の文字列配列
static long	END_AT_EOF stream読み込みをEOFで正常終了扱いとする.
static PrintStream	err System.errのUTF-8版.
static PrintWriter	err_pw System.errのPrintWriter.
static long	EVEN_FINAL_STATIC final要素にも適用する hiU.str()などでfinal要素も表示します。
static long	EVEN_JAVA_CLASS トレース時にJavaクラスからの呼び出し情報にもソース行を付ける.
static long	EVEN_NULL nullでも実行する.
static long	EVEN_PRIVATE_STATIC hiU.str()でprivate static変数も表示.
static long	FORCE 強制力を持つ.
static long	HEIGHT 高さを示す.
static Charset	hiU_charSet hiUで使う標準の文字セット.
static long	IF_EXIST 存在する場合のみ実行する.
static long	IGNORE_CASE 大文字小文字を区別しない.
static long	IGNORE_LEVEL 階層を無視する.
static long	IGNORE_QUOTE 引用符を特別扱いしない.
static long	IGNORE_SPACE 空白を無視する.
static long	IGNORE_TOP_LEVEL 第１階層を無視する.
static long	IGNORE_toString toStringを無視する.
static BufferedReader	in System.inのBufferedReader.
static BufferedReader	in_utf8 System.inのBufferedReader.
static long	INDENT_WITH_BAR インデントにバーを付ける.
static long	INTOLERANCE 厳密さを要求する.
static long	JSON_STYLE JSON形式をhiU.str()で得るオプション.
static long	JSON_STYLE_WITH_INDENT JSON形式(インデント付き）をhiU.str()で得るオプション.
static String	KANJI_EXPR_STR かな漢字の正規表現の範囲指定.
static long	KEEP_BOM utfファイル、読み込み時にBOMをスキップしない.
static long	KEEP_DELIMITER デリミッターを保持する.
static long	KEEP_LAST_NULL hiText.split関数で最後がデリミタの場合最後の空要素を保持する.
static long	KEEP_LINE_SEPARATOR ファイル読み込み時改行コードを保持する.
static long	KEEP_NULL null値を保持する.
static long	KEEP_ON_ERROR エラー時に削除しない.
static long	KEEP_OPEN ファイルをオープンしっぱなしにする.
static long	KEEP_QUOTE 引用符を保持する.
static long	KEEP_REDUNDANCY 冗長な情報を保持する.
static long	KEEP_SPACE 空白を保持する.
static long	LAST 最後尾を現す.
static String	LINE_SEPARATOR システムの行分割子
static long	LITERAL 引数を即値とみなす（正規表現扱いしない）.
static Object	LOG_LOCK setTraceFile(),t()の排他ロックオブジェクト.
static boolean	MASTERD 試験用フラグ
static long	MEMORY_SAVE SAVE_MEMORYと同じ.
static long	MIDDLE 中央を現す.
static long	MODERATE 控え目.
static long	NAME_WITH_QUOTE 自動toStringで要素名に引用符をつける.
static long	NO_BEGIN_END 開始終了で囲まない.
static long	NO_COMMENT コメントを出さない.
static long	NO_ERR_PRINT
static long	NO_ESCAPE エスケープ表現を避ける.
static long	NO_EXCEPTION 例外を投げない.
static long	NO_FLUSH オートフラッシュモード テキストファイルオープンで非オートフラッシュモード指定を行う。
static long	NO_GROUP 正規表現の置き換えでグループ参照しない.
static long	NO_LIMIT 最大限度を外す.
static long	NO_LINE_NUMBER 行番号を付加しない.
static long	NO_OPTION オプション指定のないことを表す.
static long	NO_QUOTE 文字列に引用符を付ける.
static long	NO_QUOTE_CONCAT 引用連結を行わない.
static long	NO_TRIM 空白、null値のトリミングを行わない.
static Pattern	NON_SPACE_EXPR_PAT １文字の非空白文字を現す正規表現Pattern.
static String	NON_SPACE_EXPR_STR 非空白文字の正規表現文字列.
static Pattern	NON_SPACEs_EXPR_PAT 連続する空白文字を現す正規表現Pattern.
static String	NON_SPACEs_EXPR_STR 連続する非空白文字の正規表現文字列.
static long	NONE オプション指定のないことを表す.
static long	NOT_STRICT 厳密さを要求しない.
static long	NUMERICAL_REFERENCE 2バイト文字を16進数参照に変換する.
static long	OMIT_CALLER トレース時に呼び出し元の行番号を表示しない.
static long	OMIT_EMPTY_ELEMENT 空要素を排除する.
static long	OMIT_EMPTY_MAP_ELEMENT 辞書の空要素を排除する.
static long	OMIT_LAST_SPACE hiText.split関数で最後のデリミタに空白文字のみが連続する場合、要素としない.
static long	OMIT_NULL nullポインタまたは長さ0の要素を削除する.
static long	OMIT_SPACE 空白を削除する.
static long	OMIT_SUFFIX hiStack.lineNumber()でファイル名の最後の.javaを削除する 共通フラグ一覧 参照
static long	OMIT_UNDERSCORED _で始まるまたは終わるフィールドを無視する.
static long	ONLY_FIRST 最初の一個のみ対象とする.
static long	ONLY_MATCHED マッチしたもののみ.
static long	ONLY_ONE_TARGET /** 指定のもの以外を無効にする.
static long	ONLY_PUBLIC public要素のみを表示する.
static long	ONLY_TARGET_CLASS 自動toStringを直接対象クラスについてのみ行う 　自動toString時にベースクラスやフィールドに関しては要素展開表示を行いません。
static long	OTHER_NO_LIMIT 対象外のものは限度なしとする.
static PrintStream	out System.outのUTF-8版.
static PrintWriter	out_pw System.outのPrintWriter.
static long	PACK_BYTES byte配列の表示時に4bytesごとにパックする（先頭に#が付く).
static long	PUBLIC_ONLY public要素のみを表示します.
static long	RETRY 失敗時にリトライをする.
static long	REUSE_ADDR サーバSocketでアドレスを強制再利用する.
static long	REVERSE 反転指定.
static long	SAVE_MEMORY メモリ使用量の少ない手法を採用する.
static long	SHALLOW 浅いデータ複製をとる.
static long	SHORT_AS_HEX byte値表示時に10進数を用いる.
static String[]	SINGLE_EMPTY_STRING_ARRAY 空文字列１個の配列
static long	SINGLE_LINE_STRING 複数行に渡る文字列を許可しない hiJSONでダブルクオート、シングルクオートによる文字列が複数行に渡るのを許可しない。
static long	SINGLE_REGION 単領域扱いをする.
static String	SJIS_1BYTE_CODE String#getBytes("Shift_JIS")で1バイトになってしまう全角文字.
static long	SKIP 読み飛ばし指定.
static long	SKIP_FUNC_NAME hiJSONで関数形式配列記述で関数名を読み飛ばす. hiJSONで関数形式配列記述で要素が１個の場合、関数名、配列階層を飛ばし１個のObjectとします。
static long	SPACE_AS_DLMT 空白でも分割する.
static long	SPACE_AS_USUAL_CHAR 空白文字を通常の文字扱いする.
static Pattern	SPACE_EXPR_PAT １文字の空白文字を現す正規表現Pattern.
static String	SPACE_EXPR_STR 空白文字の正規表現文字列.
static Pattern	SPACEs_EXPR_PAT 連続する空白文字を現す正規表現Pattern.
static String	SPACEs_EXPR_STR 連続する空白文字の正規表現文字列.
static String	SPACEs_STR 空白の正規表現"用"文字列.
static long	SPEED 処理速度を重視した手法を採用する.
static long	STR_CONCAT CONCAT_STRと同じ.
static long	STRICT 厳密さを要求する 構文の解析などにおいて、厳密さを要求する.
static int	T_OUTPUT t(Object...)のトレース設定番号
static long	TARGET_CLASS_ONLY 自動toString表示を直接対象クラスについてのみ行う 　自動toString時にベースクラスやフィールドに関しては要素展開表示を行いません。
static long	TARGET_CLASS_toString 対象クラスにtoStringがある場合利用(BASEクラスは無視).
static long	TERSE 短く表示する.
static long	TOLERANCE 厳密さを要求しない.
static long	TOP 先頭を現す.
static long	USE_AT_FIELD hiU.str()でタイプ名仮想フィールド@class,@typeを置く.
static boolean	use_exception デフォルト指定の無い値取得で値が無い場合RuntimeExceptionを投げる
static Charset	UTF8 UTF-8のCharset
static long	VERBOSE 冗長な情報を保持する.
static long	WEAK 弱設定指定.
static long	WIDTH 幅を示す.
static long	WITH_ADDR 自動toStringでアドレス相当値を表示する.
static long	WITH_BEGIN_END 開始終了で囲む.
static long	WITH_COLON キーと値の分離表示にコロンを使う.
static long	WITH_EXCEPTION 異常時にreturn値ではなくRuntimeExceptionを投げる.
static long	WITH_INDENT インデントを付ける.
static long	WITH_INDEX インデックス値を表示する.
static long	WITH_LINE_NUMBER hiStack.parentFuncNameでファイル行番号を付加する 共通フラグ一覧 参照
static long	WITH_NAME 名前を表示する.
static long	WITH_NEW_ID 同一idの場合後ろに_番号を付けて登録する.
static long	WITH_SINGLE_QUOTE シングルクオートを使う.
static long	WITH_STACK Exception短縮表示でスタックも表示する.
static long	WITH_TYPE タイプ名を付ける、またはタイプチェックを行う.

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static RuntimeException	asRuntimeException(Exception exp_) ExceptionをhiException(RuntimeException)にラップする.
static boolean	atob(String str_) Boolean文字列をパーズする.
static boolean	atob(String str_, boolean def_) Boolean文字列をパーズする.
static double	atod(String str_) 浮動少数文字列をパーズする。
static double	atod(String str_, double def_) 浮動少数文字列をパーズする.
static double	atod(String str_, String exMsg_) 浮動少数文字列をパーズする。
static int	atoi(String str_) 整数文字列をパーズする.
static int	atoi(String str_, int def_) 整数文字列をパーズする.
static int	atoi(String str_, String msg_) 整数文字列をパーズする.
static long	atol(String str_) 整数文字列をパーズする。
static long	atol(String str_, long def_) 整数文字列をパーズする。
static long	atol(String str_, String exMsg_) 整数文字列をパーズする。
static String	className(Object obj_) Objectのクラス名を得る.
static void	close(Closeable... ios_) 例外を投げないclose.
static void	close(Object... ios_) Closeableがない1.7以前のシステム用close(廃棄予定) 引数Objectがcloseメソッドを持つ場合呼び出します。
static String	currentFuncName() カレント関数名を得る.
static long	currentThreadId() カレントスレッドidを得る.
static String	dtoa(double d_) doubleの文字列を得る
static boolean	equals(String text1_, String text2_) ２つStringの単純比較(nullを許す) Stringにはnullがセットされる場合は良くあります。
static <T> boolean	equals(T obj1_, T obj2_) オブジェクトの比較(null可,equals使用)(試験中).
static void	fi(String frmt_, Object... args_) 関数inのトレース(フォーマットメッセージ付き).
static void	fm(String frmt_, Object... args_) 関数内でのメッセージ出力(フォーマット付き).
static void	fo(String frmt_, Object... args_) 関数outのトレース(フォーマットメッセージ付き).
static String	format(String frmt_, Object... args_) 標準フォーマット変換（Exception無し）.
static String[]	funcNameNest() 関数ネストを得る（全段）.
static String[]	funcNameNest(int level_) 関数ネストを得る（段数指定）.
static String[]	funcNameNest(int start_, int level_) 指定親レベルからび関数ネストを得る（段数指定）.
static String	getStackTrace(Exception ex_) ExceptionのstackTraceを文字列に得る.
static void	i() 関数inのトレース(付加メッセージなし).
static void	i(Object... msg_) 関数inのトレース(付加メッセージ付き).
static void	i(String msg_) 関数inのトレース(付加メッセージ付き).
static void	ignoreException(hiU.RunnableEx<Exception> func_) 例外を無視する呼び出し.
static void	ignoreException(hiU.RunnableEx<Exception> func_, long option_) 例外を無視する呼び出し(標準エラー出力あり).
static String	indent(int level_) 階層を表す文字列を作成する.
static String	indent(int level_, String indent1_, String indent2_) 階層を文字列（パターン指定）を作成する.
static String	indentBar(int level_) 階層を表すバー付き文字列を作成する.
static boolean	isNull(boolean[] array_) boolean 配列がnullまたは空であるかチェックする
static boolean	isNull(byte[] array_) byte 配列がnullまたは空であるかチェックする
static boolean	isNull(char[] array_) char 配列がnullまたは空であるかチェックする
static boolean	isNull(Collection collection_) リスト/コレクションがnullまたは空であるかチェックする
static boolean	isNull(double[] array_) double 配列がnullまたは空であるかチェックする
static boolean	isNull(float[] array_) float 配列がnullまたは空であるかチェックする
static boolean	isNull(int[] array_) innt 配列がnullまたは空であるかチェックする
static boolean	isNull(long[] array_) long 配列がnullまたは空であるかチェックする
static boolean	isNull(Map map_) Mapがnullまたは空であるかチェックする
static boolean	isNull(Object[] array_) Object 配列がnullまたは空であるかチェックする
static boolean	isNull(short[] array_) short 配列がnullまたは空であるかチェックする
static boolean	isNull(String str_) 文字列がnullまたは空文字列であるかをチェックする.
static boolean	isOff(int flags_, int flag_bit_) /** フラグビットがoffか調べる.
static boolean	isOff(long flags_, long flag_bit_) /** フラグビットがoffか調べる.
static boolean	isOn(int flags_, int flag_bit_) フラグビットがonか調べる.
static boolean	isOn(long flags_, long flag_bit_) フラグビットがonか調べる.
static boolean	isUnix() システムがUNIXを調べる.
static boolean	isWindows() システムがWindowsを調べる.
static String	itoa(int i_) intの文字列を得る.
static String	itoa3(int i_) intの３桁区切りの文字列を得る.
static StringBuilder	join(StringBuilder sb_, Iterable objs_, String dlmt_) Objectのリストを文字列連結しStringBuilderに付加する.
static int	lastUnitSize(int unitSize_, int size_) 最後のユニット内のデータ数.
static String	ltoa(long l_) longの文字列を得る
static String	ltoa3(long l_) longの3桁区切りの文字列を得る
static void	m(Object... msg_) 関数内でのメッセージ出力.
static void	m(String msg_) 関数内でのメッセージ出力.
static String	memorySizeInfo() メモリサイズ情報表示を得る.
static void	o() 関数outのトレース(付加メッセージなし).
static void	o(Object... msg_) 関数outのトレース(付加メッセージ付き).
static void	o(String msg_) 関数outのトレース(付加メッセージ付き).
static double	otod(Object obj_) Objectからdouble値を得る.
static int	otoi(Object obj_) Objectからint値を得る.
static long	otol(Object obj_) Objectからlong値を得る.
static void	p(Object... msg_) 関数内でのメッセージ出力.
static String	parentFuncName(int level_) 親関数名を得る.
static int	rand(int xi_) 線形合同法による乱数生成.
static RuntimeException	rap(Exception exp_) ExceptionをhiException(RuntimeException)にラップする.
static <T,U> void	rap(hiU.BiConsumerEx<T,U,Exception> func_, T arg_, U arg2_) 例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.
static <T> void	rap(hiU.ConsumerEx<T,Exception> func_, T arg_) 例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.
static <T1,T2,T3,T4> void	rap(hiU.QuadrConsumerEx<T1,T2,T3,T4,Exception> func_, T1 arg_, T2 arg2_, T3 arg3_, T4 arg4_) 例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.
static void	rap(hiU.RunnableEx func_) 例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.
static <T,U,V> void	rap(hiU.TriConsumerEx<T,U,V,Exception> func_, T arg_, U arg2_, V arg3_) 例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.
static <T,U,R> R	rapF(hiU.BiFunctionEx<T,U,R,Exception> func_, T arg_, U arg2_) 例外を投げる戻り値ありのラムダ式をラップし、RuntimeExceptionを投げる.
static <T,R> R	rapF(hiU.FunctionEx<T,R,Exception> func_, T arg_) 例外を投げる戻り値ありのラムダ式をラップし、RuntimeExceptionを投げる.
static <T1,T2,T3,T4,R> R	rapF(hiU.QuadrFunctionEx<T1,T2,T3,T4,R,Exception> func_, T1 arg_, T2 arg2_, T3 arg3_, T4 arg4_) 例外を投げる戻り値ありのラムダ式をラップし、RuntimeExceptionを投げる.
static <T,U,V,R> R	rapF(hiU.TriFunctionEx<T,U,V,R,Exception> func_, T arg_, U arg2_, V arg3_) 例外を投げる戻り値ありのラムダ式をラップし、RuntimeExceptionを投げる.
static String	s(String text_) 文字列nullで""を返す単純メソッド.
static hiFieldFormat	str_format() hiFieldFormatを得る.
static String	str(int[] ints_, int offset_, int length_) intの配列の指定部分を表示する(試験中).
static String	str(Object obj_) Objectを表示する(toStringを持たないObjectや配列も可) 配列や辞書も表示できます。
static String	str(Object obj_, long option_) str(Object)にオプションをつけたもの.
static void	str(Object obj_, long option_, StringBuilder sb_) Objectを文字列化する.
static String	str(Throwable ex_)
static String	str(Throwable ex_, long option_) 短縮Exception文字列を得る（スタックトレースなどオプション付き）.
static String	str(Throwable ex_, long option_, int depth_) 短縮Exception文字列を得る（スタックトレースなどオプション付き）.
static String	strs(Object... obj_) 複数オブジェクトの文字表示.
static String	sysCharSet() システム（仮想マシン）のデフォルトの文字セットを得る.
static void	t(Object... msg_) TraceまたはTest出力.
static void	tn(int n_, Object... msg_) TraceまたはTest出力（設定番号指定あり）.
static String	toHankaku(CharSequence val_) 数値文字列を半角化する.
static int	unitNum(int unitSize_, int size_) ユニット数。
static void	use_exception(boolean flag_) デフォルト指定の無い値取得で値が無い場合RuntimeExceptionを投げる デフォルトではExceptionを投げます。
static long	usedMemory() 使用中のメモリサイズを得る.
void	wait(Object obj_) 明示Exception無しのwait.

クラスから継承されたメソッド java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

_v_

public static final String _v_

ライブラリのバージョン

関連項目:

定数フィールド値

MASTERD

public static final boolean MASTERD

試験用フラグ

関連項目:

定数フィールド値

NO_OPTION

public static final long NO_OPTION

オプション指定のないことを表す.

オプション指定引数の必要な関数でオプション指定がない 場合指定します。値は0です。
NONEと同じです。

オプション指定の定数は異なる名前でありながら同じ値を持つものも多くあります。

関連項目:

定数フィールド値

out_pw

public static final PrintWriter out_pw

System.outのPrintWriter.

System.outのPrintWriterです。文字コードはUTF-8となります。 次の手続きで得られるものと同等です。

   new PrintWriter(System.out,true); // trueは自動フラッシュ

out

public static final PrintStream out

System.outのUTF-8版.

err_pw

public static final PrintWriter err_pw

System.errのPrintWriter.

System.errのPrintWriterです。文字コードはUTF-8となります。 次の手続きで得られるものと同等です。

   new PrintWriter(System.err,true);

err

public static final PrintStream err

System.errのUTF-8版.

in

public static final BufferedReader in

System.inのBufferedReader.

System.inのBufferedReaderです。文字コードはシステム標準です。 次の手続きで得られるものと同等です。

   new BufferedReader(new InputStreamReader(System.in));

in_utf8

public static final BufferedReader in_utf8

System.inのBufferedReader.

System.inの文字セットutf-8のBufferedReaderです。次の手続きで得られるものと同等です。

   new BufferedReader(new InputStreamReader(System.in),"utf-8");

charSet_UTF8

public static final Charset charSet_UTF8

UTF-8のCharset

UTF8

public static final Charset UTF8

UTF-8のCharset

hiU_charSet

public static Charset hiU_charSet

hiUで使う標準の文字セット. デフォルトではStandardCharsets.UTF_8です

CHAR_SET

public static String CHAR_SET

hiUで使う標準の文字セット（UTF-8)

NONE

public static final long NONE

オプション指定のないことを表す.

オプション指定引数の必要な関数でオプション指定がない 場合指定します。値は0です。

   // 例
   PrintStream ps= hiFile.openPrintStream("test.txt","utf-8",hiU.NONE);

共通フラグ一覧 参照

関連項目:

定数フィールド値

REVERSE

public static final long REVERSE

反転指定.

共通フラグ一覧 参照

関連項目:

定数フィールド値

WEAK

public static final long WEAK

弱設定指定.

共通フラグ一覧 参照

関連項目:

定数フィールド値

WITH_EXCEPTION

public static final long WITH_EXCEPTION

異常時にreturn値ではなくRuntimeExceptionを投げる.

共通フラグ一覧 参照

関連項目:

定数フィールド値

END_AT_EOF

public static final long END_AT_EOF

stream読み込みをEOFで正常終了扱いとする.

streamが正常にデータ単位の切れ目でEOFとなる場合 Exceptionを発生させず「終了」を返す指定です。
「終了」の示し方はメソッドにより異なります。
hiUで用意されるread関数は原始的なものであるため このオプションは使用せず、関数そのものが別々で あり、かつEOF時にはEOFExceptionとhiU.UnexpectedEOFException を呼び分ける形としています。

共通フラグ一覧 参照

関連項目:

定数フィールド値

AS_NO_DISP

public static final long AS_NO_DISP

nullを表示しない.

hiU.str()のオプション。nullデータを省略します。

AS_NO_DISP(hiFieldFormat)参照

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

TERSE

public static final long TERSE

短く表示する.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

OMIT_CALLER

public static final long OMIT_CALLER

トレース時に呼び出し元の行番号を表示しない.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

SKIP

public static final long SKIP

読み飛ばし指定.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

CHECK_ESCAPE

public static final long CHECK_ESCAPE

'\'(逆スラッシュ)をエスケープとして処理する.

hiText.splitなどで

共通フラグ一覧 参照

関連項目:

定数フィールド値

AS_MEMBER

public static final long AS_MEMBER

メンバーとして扱う

hiU.str()のオプション。ベースクラスをメンバ(_super_)として表示します。

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

HEIGHT

public static final long HEIGHT

高さを示す.

共通フラグ一覧 参照

関連項目:

定数フィールド値

SHALLOW

public static final long SHALLOW

浅いデータ複製をとる.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

EVEN_PRIVATE_STATIC

public static final long EVEN_PRIVATE_STATIC

hiU.str()でprivate static変数も表示.

共通フラグ一覧 参照

関連項目:

定数フィールド値

AS_OBJECT

public static final long AS_OBJECT

Objectとして送信する

hiUDPPrintWriterで文字列を単純byte並びではなくJavaのオブジェクトプロトコルで送信します。

共通フラグ一覧 参照

関連項目:

定数フィールド値

ONLY_FIRST

public static final long ONLY_FIRST

最初の一個のみ対象とする.

共通フラグ一覧 参照

関連項目:

定数フィールド値

DEEP

public static final long DEEP

深いデータ複製をとる.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

IGNORE_LEVEL

public static final long IGNORE_LEVEL

階層を無視する.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

IGNORE_TOP_LEVEL

public static final long IGNORE_TOP_LEVEL

第１階層を無視する.

hiText.parseXMLでDocument階層を無視します。

共通フラグ一覧 参照

関連項目:

定数フィールド値

AS_SAME_LEVEL

public static final long AS_SAME_LEVEL

自動toStringでベースクラス要素を引き上げ展開する

自動toString実行時にベースクラスの要素を派生クラスに展開します。

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

SAVE_MEMORY

public static final long SAVE_MEMORY

メモリ使用量の少ない手法を採用する.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

MEMORY_SAVE

public static final long MEMORY_SAVE

SAVE_MEMORYと同じ.

共通フラグ一覧 参照

関連項目:

定数フィールド値

REUSE_ADDR

public static final long REUSE_ADDR

サーバSocketでアドレスを強制再利用する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

CHECK_UNSET_FIELD

public static final long CHECK_UNSET_FIELD

値が設定されないフィールドをチェックする.

共通フラグ一覧 参照

関連項目:

定数フィールド値

BYTE_AS_DEC

public static final long BYTE_AS_DEC

byte値表示時に10進数を用いる.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

NO_QUOTE_CONCAT

public static final long NO_QUOTE_CONCAT

引用連結を行わない.

hiPropertyの解析時に引用連結を行いません。
デフォルトではhiPropertyでは定義行の最初が引用符の場合引用連結を行います。

   "ab" cd "e'f" 'g"h'
   通常 -> abcde'fg"h
   指定 -> "ab" cd "e'f" 'g"h'

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

SPEED

public static final long SPEED

処理速度を重視した手法を採用する.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

KEEP_QUOTE

public static final long KEEP_QUOTE

引用符を保持する.

hiUでは hiText.tokens(String,String,long)、hiArgs.args(String[],long) のオプション動作指定として用います。

共通フラグ一覧 参照

関連項目:

定数フィールド値

AS_IS

public static final long AS_IS

変更を施さずそのまま.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

KEEP_NULL

public static final long KEEP_NULL

null値を保持する.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

EVEN_NULL

public static final long EVEN_NULL

nullでも実行する.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

AS_NULL

public static final long AS_NULL

空文字列とせずnullとする

hiText.tokens(String,String,long)、hiArgs.args(String[],long) のオプション動作指定として用います。

共通フラグ一覧 参照

関連項目:

定数フィールド値

DOUBLE_QUOTE_FOR_MAP_KEY

public static final long DOUBLE_QUOTE_FOR_MAP_KEY

Mapのキー表示に引用符を付ける

hiU.str(Object,option)による表示でMapのキー引用符が無い場合、付加します。
これはJSON出力の為に用意された特殊な指定です。この指定をするとMapのキーは必ずダブルクオートで囲まれます。 hiU.NO_QUOTEは無効になりhiU.DOUBLE_QUOTE_FOR_CHARが有効になることに注意が必要です。

共通フラグ一覧 参照

関連項目:

, 定数フィールド値

AS_EMPTY_STRING

public static final long AS_EMPTY_STRING

nullとせず空文字列とする.

共通フラグ一覧 参照

関連項目:

定数フィールド値

NO_TRIM

public static final long NO_TRIM

空白、null値のトリミングを行わない.

hiText.tokens(String,String,long)、hiArgs.args(String[],long) のオプション動作指定として用います。

共通フラグ一覧 参照

関連項目:

定数フィールド値

KEEP_LINE_SEPARATOR

public static final long KEEP_LINE_SEPARATOR

ファイル読み込み時改行コードを保持する.

hiUとしては特に用途を定めていません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

NUMERICAL_REFERENCE

public static final long NUMERICAL_REFERENCE

2バイト文字を16進数参照に変換する.

hiText.xmlEscape(String,long) のオプション動作指定として用います。

関連項目:

定数フィールド値

DO_TRIM

public static final long DO_TRIM

空白、null値のトリミングを行う. hiUでは使用していない。NO_TRIMとの競合に関しては これを使うメソッドに依存する

共通フラグ一覧 参照

関連項目:

定数フィールド値

CHECK_UNKNOWN_FIELD

public static final long CHECK_UNKNOWN_FIELD

指定フィールドが無い場合エラーとする.

共通フラグ一覧 参照

関連項目:

定数フィールド値

DECODE

public static final long DECODE

デコードします

関連項目:

定数フィールド値

KEEP_SPACE

public static final long KEEP_SPACE

空白を保持する.

hiText.tokens(String,String,long)、hiArgs.args(String[],long) で空白をデリミッター扱いしない指定として仕様します

共通フラグ一覧 参照

関連項目:

定数フィールド値

BODY

public static final long BODY

BODY部の処理をする

hiText.xmlEscape(String,long) のオプションに指定すると、引用符などattribute用のエスケープ は行いません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

OMIT_NULL

public static final long OMIT_NULL

nullポインタまたは長さ0の要素を削除する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

IF_EXIST

public static final long IF_EXIST

存在する場合のみ実行する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

SPACE_AS_DLMT

public static final long SPACE_AS_DLMT

空白でも分割する.

hiText.tokens(String,String,long)、hiArgs.args(String[],long) で空白を弱デリミッターとします。

共通フラグ一覧 参照

関連項目:

定数フィールド値

CONCAT_STR

public static final long CONCAT_STR

引用符の繋がりで結合しない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

STR_CONCAT

public static final long STR_CONCAT

CONCAT_STRと同じ.

共通フラグ一覧 参照

関連項目:

定数フィールド値

IGNORE_QUOTE

public static final long IGNORE_QUOTE

引用符を特別扱いしない.

hiText.tokens(String,String,long)、hiArgs.args(String[],long) で引用符を特別扱いしないようにします。

共通フラグ一覧 参照

関連項目:

定数フィールド値

OMIT_SPACE

public static final long OMIT_SPACE

空白を削除する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

IGNORE_SPACE

public static final long IGNORE_SPACE

空白を無視する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

NAME_WITH_QUOTE

public static final long NAME_WITH_QUOTE

自動toStringで要素名に引用符をつける.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

WITH_INDENT

public static final long WITH_INDENT

インデントを付ける.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

INDENT_WITH_BAR

public static final long INDENT_WITH_BAR

インデントにバーを付ける.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

WITH_COLON

public static final long WITH_COLON

キーと値の分離表示にコロンを使う.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

NO_QUOTE

public static final long NO_QUOTE

文字列に引用符を付ける.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

WITH_SINGLE_QUOTE

public static final long WITH_SINGLE_QUOTE

シングルクオートを使う.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

DO_NOT_CREATE_FOLDER

public static final long DO_NOT_CREATE_FOLDER

ファイル生成時にフォルダは生成しない.

ファイル生成時にベースフォルダが無い場合フォルダを生成しない。
この指定が無い場合はフォルダを生成する。

共通フラグ一覧 参照

関連項目:

定数フィールド値

SINGLE_LINE_STRING

public static final long SINGLE_LINE_STRING

複数行に渡る文字列を許可しない

hiJSONでダブルクオート、シングルクオートによる文字列が複数行に渡るのを許可しない。

この指定があっても逆クオートによる文字列は複数行が可能です。

共通フラグ一覧 参照

関連項目:

定数フィールド値

APPEND

public static final long APPEND

追加モード.

ファイルオープンで追加モード指定を行う。

共通フラグ一覧 参照

関連項目:

定数フィールド値

USE_AT_FIELD

public static final long USE_AT_FIELD

hiU.str()でタイプ名仮想フィールド@class,@typeを置く.

@hiU.TypeHintField修飾されている型の表示時に内部に@typeフィールドを置き、指定の文字列が示されます.

共通フラグ一覧 参照

関連項目:

定数フィールド値

KEEP_OPEN

public static final long KEEP_OPEN

ファイルをオープンしっぱなしにする.

hiU管理ログファイルは出力の度にオープン/クローズを行うことが できるが、この指定があるとオープンしたままとなる。

共通フラグ一覧 参照

関連項目:

定数フィールド値

CLOSE_EACH_TIME

public static final long CLOSE_EACH_TIME

ファイルを毎回クローズする

hiU管理ログファイルは出力の度にオープン/クローズを行うことが できる。この指定があると毎回オープン/クローズを行う

共通フラグ一覧 参照

関連項目:

定数フィールド値

SINGLE_REGION

public static final long SINGLE_REGION

単領域扱いをする.

共通フラグ一覧 参照

関連項目:

定数フィールド値

RETRY

public static final long RETRY

失敗時にリトライをする.

リトライ間隔やリトライ回数はメソッド毎にことなります。

共通フラグ一覧 参照

関連項目:

定数フィールド値

NO_GROUP

public static final long NO_GROUP

正規表現の置き換えでグループ参照しない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

WIDTH

public static final long WIDTH

幅を示す.

共通フラグ一覧 参照

関連項目:

定数フィールド値

DOUBLE_QUOTE_FOR_CHAR

public static final long DOUBLE_QUOTE_FOR_CHAR

char表示でダブルクオートを使う.

共通フラグ一覧 参照

関連項目:

定数フィールド値

STRICT

public static final long STRICT

厳密さを要求する

構文の解析などにおいて、厳密さを要求する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

INTOLERANCE

public static final long INTOLERANCE

厳密さを要求する.

構文の解析などにおいて、厳密さを要求する

共通フラグ一覧 参照

関連項目:

定数フィールド値

NOT_STRICT

public static final long NOT_STRICT

厳密さを要求しない.

構文の解析などにおいて、厳密には誤りであっても、許容できるものは許容する

共通フラグ一覧 参照

関連項目:

定数フィールド値

TOLERANCE

public static final long TOLERANCE

厳密さを要求しない.

構文の解析などにおいて、厳密には誤りであっても、許容できるものは許容する

共通フラグ一覧 参照

関連項目:

定数フィールド値

SPACE_AS_USUAL_CHAR

public static final long SPACE_AS_USUAL_CHAR

空白文字を通常の文字扱いする.

文字列解析に於いて空白文字を特別扱いしない

共通フラグ一覧 参照

関連項目:

定数フィールド値

NO_LIMIT

public static final long NO_LIMIT

最大限度を外す.

共通フラグ一覧 参照

関連項目:

定数フィールド値

SKIP_FUNC_NAME

public static final long SKIP_FUNC_NAME

hiJSONで関数形式配列記述で関数名を読み飛ばす. hiJSONで関数形式配列記述で要素が１個の場合、関数名、配列階層を飛ばし１個のObjectとします。

共通フラグ一覧 参照

関連項目:

定数フィールド値

OTHER_NO_LIMIT

public static final long OTHER_NO_LIMIT

対象外のものは限度なしとする.

共通フラグ一覧 参照

関連項目:

定数フィールド値

WITH_NEW_ID

public static final long WITH_NEW_ID

同一idの場合後ろに_番号を付けて登録する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

ONLY_ONE_TARGET

public static final long ONLY_ONE_TARGET

/** 指定のもの以外を無効にする.

setLogFileで指定すると標準エラーへの出力が抑止されます。

共通フラグ一覧 参照

関連項目:

定数フィールド値

ONLY_TARGET_CLASS

public static final long ONLY_TARGET_CLASS

自動toStringを直接対象クラスについてのみ行う

　自動toString時にベースクラスやフィールドに関しては要素展開表示を行いません。

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

TARGET_CLASS_ONLY

public static final long TARGET_CLASS_ONLY

自動toString表示を直接対象クラスについてのみ行う

　自動toString時にベースクラスやフィールドに関しては要素展開表示を行いません。

共通フラグ一覧 参照

関連項目:

定数フィールド値

DELETE_ON_ERROR

public static final long DELETE_ON_ERROR

失敗時削除.

テキストファイルの書き込みモードオープンで失敗した場合 ファイルを削除します。不正文字コード指定オープンで 空ファイルが作成されることを防ぎます。

共通フラグ一覧 参照

関連項目:

定数フィールド値

KEEP_ON_ERROR

public static final long KEEP_ON_ERROR

エラー時に削除しない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

AUTO_FLUSH

public static final long AUTO_FLUSH

オートフラッシュモード

テキストファイルオープンでオートフラッシュモード指定を行う。

共通フラグ一覧 参照

関連項目:

定数フィールド値

EVEN_FINAL_STATIC

public static final long EVEN_FINAL_STATIC

final要素にも適用する

hiU.str()などでfinal要素も表示します。

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

NO_FLUSH

public static final long NO_FLUSH

オートフラッシュモード

テキストファイルオープンで非オートフラッシュモード指定を行う。

共通フラグ一覧 参照

関連項目:

定数フィールド値

AS_STRING

public static final long AS_STRING

JSON解析時にbool,doubleを文字列型にする.

共通フラグ一覧 参照

関連項目:

定数フィールド値

KEEP_BOM

public static final long KEEP_BOM

utfファイル、読み込み時にBOMをスキップしない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

ADD_BOM

public static final long ADD_BOM

PrintStream生成時にBOMを先頭に付ける(UTF-8のみ).

UTF-8のBOM '0xEFBBBF' をテキストファイルの書き込みオープン時 APPENDで無い場合先頭に付加する.
excel用のファイルを作るなどの特殊用途以外では使うべきではありません。

   // 例
   PrintStream ps= hiFile.openPrintStream("test.csv","utf-8",hiU.ADD_BOM);
   ps.println("A,B,B");

共通フラグ一覧 参照

関連項目:

定数フィールド値

NO_ERR_PRINT

public static final long NO_ERR_PRINT

関連項目:

定数フィールド値

WITH_BEGIN_END

public static final long WITH_BEGIN_END

開始終了で囲む.

共通フラグ一覧 参照

関連項目:

定数フィールド値

IGNORE_toString

public static final long IGNORE_toString

toStringを無視する.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

NO_BEGIN_END

public static final long NO_BEGIN_END

開始終了で囲まない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

TARGET_CLASS_toString

public static final long TARGET_CLASS_toString

対象クラスにtoStringがある場合利用(BASEクラスは無視).

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

NO_ESCAPE

public static final long NO_ESCAPE

エスケープ表現を避ける.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

KEEP_REDUNDANCY

public static final long KEEP_REDUNDANCY

冗長な情報を保持する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

VERBOSE

public static final long VERBOSE

冗長な情報を保持する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

KEEP_DELIMITER

public static final long KEEP_DELIMITER

デリミッターを保持する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

WITH_NAME

public static final long WITH_NAME

名前を表示する.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

WITH_INDEX

public static final long WITH_INDEX

インデックス値を表示する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

WITH_TYPE

public static final long WITH_TYPE

タイプ名を付ける、またはタイプチェックを行う.

自動toStringでタイプ名を表示します。

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

WITH_ADDR

public static final long WITH_ADDR

自動toStringでアドレス相当値を表示する.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

WITH_LINE_NUMBER

public static final long WITH_LINE_NUMBER

hiStack.parentFuncNameでファイル行番号を付加する

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

WITH_STACK

public static final long WITH_STACK

Exception短縮表示でスタックも表示する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

AS_null_DISP

public static final long AS_null_DISP

null時に"null"文字列を表示する.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

CHECK_COMMENT

public static final long CHECK_COMMENT

コメントをチェックする.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

CHECK_QUOTE

public static final long CHECK_QUOTE

引用をチェックする.

共通フラグ一覧 参照

関連項目:

定数フィールド値

PUBLIC_ONLY

public static final long PUBLIC_ONLY

public要素のみを表示します.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

ONLY_PUBLIC

public static final long ONLY_PUBLIC

public要素のみを表示する. PUBLIC_ONLYと同じ

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

ONLY_MATCHED

public static final long ONLY_MATCHED

マッチしたもののみ.

共通フラグ一覧 参照

関連項目:

定数フィールド値

OMIT_EMPTY_ELEMENT

public static final long OMIT_EMPTY_ELEMENT

空要素を排除する.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

OMIT_EMPTY_MAP_ELEMENT

public static final long OMIT_EMPTY_MAP_ELEMENT

辞書の空要素を排除する.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

NO_LINE_NUMBER

public static final long NO_LINE_NUMBER

行番号を付加しない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

JSON_STYLE

public static final long JSON_STYLE

JSON形式をhiU.str()で得るオプション.

JSON形式として成り立つのは文字列のList、配列、辞書などです。

   hiU.WEAK
  |hiU.WITH_COLON|hiU.NO_LIMIT|hiU.AS_null_DISP
  |hiU.AS_SAME_LEVEL|hiU.NAME_WITH_QUOTE|hiU.USE_AT_FIELD
  |hiU.OMIT_EMPTY_MAP_ELEMENT|hiU.OMIT_EMPTY_ELEMENT
  |hiU.DOUBLE_QUOTE_FOR_CHAR;

シングルクオートにしたい場合はhiU.JSON_STYLE|hiU.WITH_SINGLE_QUOTEと 指定してください。

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

JSON_STYLE_WITH_INDENT

public static final long JSON_STYLE_WITH_INDENT

JSON形式(インデント付き）をhiU.str()で得るオプション.

次の値を持ちます。

   hiU.JSON_STYLE|hiU.WITH_INDENT

共通フラグ一覧 参照

関連項目:

定数フィールド値

KEEP_LAST_NULL

public static final long KEEP_LAST_NULL

hiText.split関数で最後がデリミタの場合最後の空要素を保持する.

split関数の仕様をJavaの標準ライブラリに合わせてあります。

  JavaのStringのsplitは文字列の最後がデリミタの
    ",a,".split(",");
  では理屈上
    [, a, ]  [ 空　a  空 ]
  となるべきところ最後の空要素が作られず
    [, a]    [ 空　a ]
  となってしまう仕様となっています。

hiText.split関数ではオプションでhiU.KEEP_LAST_NULLを付けると 最後の空要素が作られます

共通フラグ一覧 参照

関連項目:

定数フィールド値

OMIT_UNDERSCORED

public static final long OMIT_UNDERSCORED

_で始まるまたは終わるフィールドを無視する.

共通フラグ一覧 参照

関連項目:

定数フィールド値

OMIT_LAST_SPACE

public static final long OMIT_LAST_SPACE

hiText.split関数で最後のデリミタに空白文字のみが連続する場合、要素としない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

OMIT_SUFFIX

public static final long OMIT_SUFFIX

hiStack.lineNumber()でファイル名の最後の.javaを削除する

共通フラグ一覧 参照

関連項目:

定数フィールド値

MIDDLE

public static final long MIDDLE

中央を現す.(未使用).

共通フラグ一覧 参照

関連項目:

定数フィールド値

LAST

public static final long LAST

最後尾を現す.(未使用).

共通フラグ一覧 参照

関連項目:

定数フィールド値

TOP

public static final long TOP

先頭を現す.(未使用).

共通フラグ一覧 参照

関連項目:

定数フィールド値

CHECK_TOP

public static final long CHECK_TOP

先頭をチェックする.

共通フラグ一覧 参照

関連項目:

定数フィールド値

NO_COMMENT

public static final long NO_COMMENT

コメントを出さない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

PACK_BYTES

public static final long PACK_BYTES

byte配列の表示時に4bytesごとにパックする（先頭に#が付く).

共通フラグ一覧 参照

関連項目:

定数フィールド値

FORCE

public static final long FORCE

強制力を持つ.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

EVEN_JAVA_CLASS

public static final long EVEN_JAVA_CLASS

トレース時にJavaクラスからの呼び出し情報にもソース行を付ける.

共通フラグ一覧 参照

関連項目:

定数フィールド値

SHORT_AS_HEX

public static final long SHORT_AS_HEX

byte値表示時に10進数を用いる.

共通フラグ一覧 参照

関連項目:

hiFieldFormat.option, 定数フィールド値

DIRECT

public static final long DIRECT

直接実行.

共通フラグ一覧 参照

関連項目:

定数フィールド値

LITERAL

public static final long LITERAL

引数を即値とみなす（正規表現扱いしない）.

共通フラグ一覧 参照

関連項目:

定数フィールド値

MODERATE

public static final long MODERATE

控え目.

共通フラグ一覧 参照

関連項目:

定数フィールド値

IGNORE_CASE

public static final long IGNORE_CASE

大文字小文字を区別しない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

NO_EXCEPTION

public static final long NO_EXCEPTION

例外を投げない.

共通フラグ一覧 参照

関連項目:

定数フィールド値

EMPTY_STRING

public static final String EMPTY_STRING

空文字列

関連項目:

定数フィールド値

SINGLE_EMPTY_STRING_ARRAY

public static final String[] SINGLE_EMPTY_STRING_ARRAY

空文字列１個の配列

EMPTY_STRING_ARRAY

public static final String[] EMPTY_STRING_ARRAY

要素数0の文字列配列

EMPTY_INT_ARRAY

public static final int[] EMPTY_INT_ARRAY

要素数0のint配列

EMPTY_BYTE_ARRAY

public static final byte[] EMPTY_BYTE_ARRAY

要素数0のbyte配列

SPACEs_STR

public static final String SPACEs_STR

空白の正規表現"用"文字列.

全角空白を含む空白文字列です。次のようになっています

  " \t\r\n\f\b\u3000"

これ自体では空白文字の並びにすぎないことに注意してください。

関連項目:

定数フィールド値

SPACE_EXPR_STR

public static final String SPACE_EXPR_STR

空白文字の正規表現文字列.

全角空白を含む空白文字の正規表現です。次のようになっています

  "[ \t\r\n\f\b\u3000]"

例えば次の様な使い方ができます。

    //String text;
    // 空白文字を消去する
    String text_with_no_space= text.replaceAll(SPACE_EXPR_STR,"");

関連項目:

定数フィールド値

NON_SPACE_EXPR_STR

public static final String NON_SPACE_EXPR_STR

非空白文字の正規表現文字列.

非空白文字（全角空白を含む）の正規表現です。次のようになっています

  "[^ \t\r\n\f\b\u3000]"

関連項目:

定数フィールド値

SPACEs_EXPR_STR

public static final String SPACEs_EXPR_STR

連続する空白文字の正規表現文字列.

連続する全角空白を含む空白文字の正規表現です。次のようになっています

  "[ \t\r\n\f\b\u3000]+"

例えば次の様な使い方ができます。

    String text="ab  cd　e f";// bとcの間は2個の空白。dとeの間は全角空白
    String texts[]= text.split(SPACEs_EXPR_STR);
    // 「ab」「cd」「e」「f」
    String texts[]= text.split(SPACE_EXPR_STR);
    // 「ab」「」「cd」「e」「f」

関連項目:

定数フィールド値

NON_SPACEs_EXPR_STR

public static final String NON_SPACEs_EXPR_STR

連続する非空白文字の正規表現文字列.

連続する非空白文字（全角空白を含む）の正規表現です。次のようになっています

  "[^ \t\r\n\f\b\u3000]+"

関連項目:

定数フィールド値

SPACE_EXPR_PAT

public static final Pattern SPACE_EXPR_PAT

１文字の空白文字を現す正規表現Pattern.

次の作業で得られるものと同等です。

  Pattern.compile(hiU.SPACE_EXPR_STR);

NON_SPACE_EXPR_PAT

public static final Pattern NON_SPACE_EXPR_PAT

１文字の非空白文字を現す正規表現Pattern. 次の作業で得られるものと同等です。

  Pattern.compile(hiU.SPACE_EXPR_STR);

SPACEs_EXPR_PAT

public static final Pattern SPACEs_EXPR_PAT

連続する空白文字を現す正規表現Pattern. 次の作業で得られるものと同等です。

  Pattern.compile(hiU.SPACE_EXPR_STR+"+");

NON_SPACEs_EXPR_PAT

public static final Pattern NON_SPACEs_EXPR_PAT

連続する空白文字を現す正規表現Pattern. 次の作業で得られるものと同等です。

  Pattern.compile(hiU.SPACE_EXPR_STR+"+");

ALPHA_NUMERIC_STR_EXPR_STR

public static final String ALPHA_NUMERIC_STR_EXPR_STR

英数字文字列の正規表現. 英数字('_'を許す)文字列の正規表現です。次のようになっています

  "^[a-zA-Z_0-9]*$"

関連項目:

定数フィールド値

ALPHA_NUMERIC_STR_EXPR_PAT

public static final Pattern ALPHA_NUMERIC_STR_EXPR_PAT

英数字文字列の正規表現Pattern. 英数字('_'を許す)文字列の正規表現Patternです。次のようになっています

  Pattern.compile(hiU.ALPHA_NUMERIC_STR_EXPR_STR);

KANJI_EXPR_STR

public static final String KANJI_EXPR_STR

かな漢字の正規表現の範囲指定.

かな漢字のUniCode範囲の文字列です。
次のように正規表現の範囲指定の一部として使用できます。

   String  namePattern="[a-zA-Z_"+hiU.KANJI_EXPR_STR+"]"
                      +"[a-zA-Z_0-9"+hiU.KANJI_EXPR_STR+"]*";
   Pattern p= Pattern.compile(namePattern);

長音記号、中点や繰り返し記号も含みます。次のコード範囲となっています。

   4e00-9fa5（漢字）     3041-3094（かな）
   309b-309e（かな記号） 30a1-30fc（カタカナ）

文字列の中に直接UniCodeで文字が埋められている形となります。
 "一-龥ぁ-ゔ゛-ゞァ-ー"

関連項目:

定数フィールド値

SJIS_1BYTE_CODE

public static String SJIS_1BYTE_CODE

String#getBytes("Shift_JIS")で1バイトになってしまう全角文字.

次の文字はString#getBytes("Shift_JIS")で1バイトになってしまいます。
 ～,―,－
hiText.length2(str)関数で予めこれらは 2バイトになる全角文字に置き換えた上で長さを取得しています。
他の全角/半角取扱い関数でもこれが参照されています。
正規表現の形で置いてあります。
 public static String SJIS_1BYTE_CODE="[～―－]";
これ以外の文字で対処したいものがある場合、この定義を変更する必要があります。

LINE_SEPARATOR

public static String LINE_SEPARATOR

システムの行分割子

LOG_LOCK

public static Object LOG_LOCK

setTraceFile(),t()の排他ロックオブジェクト. setTraceFile()でセットしたファイル名を別スレッドでrenameするなど の作業を行う場合、このオブジェクトでsynchronized制御を行えば t()との競合を避けることができます。

use_exception

public static boolean use_exception

デフォルト指定の無い値取得で値が無い場合RuntimeExceptionを投げる

T_OUTPUT

public static int T_OUTPUT

t(Object...)のトレース設定番号

メソッドの詳細

ignoreException

public static void ignoreException(hiU.RunnableEx<Exception> func_)

例外を無視する呼び出し.

パラメータ:

func_ - 実行する式

ignoreException

public static void ignoreException(hiU.RunnableEx<Exception> func_,
                                   long option_)

例外を無視する呼び出し(標準エラー出力あり).

パラメータ:

func_ - 実行する式

option_ - オプション hiU.WITH_STACK (調整の可能性あり）

rap

public static final RuntimeException rap(Exception exp_)

ExceptionをhiException(RuntimeException)にラップする.

ExceptionからRuntimeExceptionを得ます。引数がRuntimeException の場合キャストして戻します。RuntimeExceptionでない場合 新たなRuntimeExceptionを生成し、その引数とします。

次のような使い方をします。

void func(){// Exceptionを返さない関数
   try{
      func2();// Exceptionを返す関数
      }
   catch(Exception ex_){
      throw hiU.rap(ex_);
      }
   }

interfaceの関数の多くがExceptionを特定しており、実装で 発生するExceptionをそのまま投げることができません。
通常RuntimeExceptionでラップしますが、無意味にラップが 重なることがあります。この関数は極めて単純なものですが、 無意味なRuntimeExceptionの重ね着を避けることができます。

パラメータ:

exp_ - 例外

戻り値:

hiException(ex_)または引数のRuntimeException

asRuntimeException

public static final RuntimeException asRuntimeException(Exception exp_)

ExceptionをhiException(RuntimeException)にラップする.

ExceptionをRuntimeExceptionでラップします。
ただしラップしようとするExceptionがRuntimeExceptionの場合はそのまま返します。
無用なRutimeExceptionの重なりは発生しません

   @Override
   public void run(){// throws Exxceptionにできない
      try{
         foo();// throws Exceptionを持つメソッド
         }
      catch(Exception _ex){
         throw hiU.asRuntimeException(_ex);
         }
      }

パラメータ:

exp_ - 例外

戻り値:

hiException(ex_)または引数のRuntimeException

rap

public static final void rap(hiU.RunnableEx func_)

例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.

Exceptionを投げる可能性のあるラムダ式のExceptionをRuntimeExceptionでラップします。

パラメータ:

func_ - 引数を持たないラムダ式

rap

public static final <T> void rap(hiU.ConsumerEx<T,Exception> func_,
                                 T arg_)

例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.

例えば例外を投げるラムダ式を受けるthrows無の関数は次のように実現できます。

   public void doIt(hiU.ConsumerEx<String,Exception> func_,String arg_){
      hiU.rap(func_,arg_);
      }

型パラメータ:

T - 引数型

パラメータ:

func_ - ラムダ式

arg_ - ラムダ式に与える引数

rap

public static final <T,U> void rap(hiU.BiConsumerEx<T,U,Exception> func_,
                                   T arg_,
                                   U arg2_)

例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.

型パラメータ:

T - 第１引数型

U - 第２引数型

パラメータ:

func_ - ラムダ式

arg_ - ラムダ式に与える引数

arg2_ - ラムダ式に与える第２引数

rap

public static final <T,U,V> void rap(hiU.TriConsumerEx<T,U,V,Exception> func_,
                                     T arg_,
                                     U arg2_,
                                     V arg3_)

例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.

型パラメータ:

T - 第１引数型

U - 第２引数型

V - 第３引数型

パラメータ:

func_ - ラムダ式

arg_ - ラムダ式に与える引数

arg2_ - ラムダ式に与える第２引数

arg3_ - ラムダ式に与える第３引数

rap

public static final <T1,T2,T3,T4> void rap(hiU.QuadrConsumerEx<T1,T2,T3,T4,Exception> func_,
                                           T1 arg_,
                                           T2 arg2_,
                                           T3 arg3_,
                                           T4 arg4_)

例外を投げるラムダ式をラップし、RuntimeExceptionを投げる.

型パラメータ:

T1 - 第１引数型

T2 - 第２引数型

T3 - 第３引数型

T4 - 第４引数型

パラメータ:

func_ - ラムダ式

arg_ - ラムダ式に与える引数

arg2_ - ラムダ式に与える第２引数

arg3_ - ラムダ式に与える第３引数

arg4_ - ラムダ式に与える第４引数

rapF

public static final <T,R> R rapF(hiU.FunctionEx<T,R,Exception> func_,
                                 T arg_)

例外を投げる戻り値ありのラムダ式をラップし、RuntimeExceptionを投げる.

型パラメータ:

T - 第１引数型

R - 戻り値型

パラメータ:

func_ - ラムダ式

arg_ - ラムダ式に与える引数

戻り値:

ラムダ式の戻り値

rapF

public static final <T,U,R> R rapF(hiU.BiFunctionEx<T,U,R,Exception> func_,
                                   T arg_,
                                   U arg2_)

例外を投げる戻り値ありのラムダ式をラップし、RuntimeExceptionを投げる.

型パラメータ:

T - 第１引数型

U - 第２引数型

R - 戻り値型

パラメータ:

func_ - ラムダ式

arg_ - ラムダ式に与える引数

arg2_ - ラムダ式に与える第２引数

戻り値:

ラムダ式の戻り値

rapF

public static final <T,U,V,R> R rapF(hiU.TriFunctionEx<T,U,V,R,Exception> func_,
                                     T arg_,
                                     U arg2_,
                                     V arg3_)

例外を投げる戻り値ありのラムダ式をラップし、RuntimeExceptionを投げる.

型パラメータ:

T - 第１引数型

U - 第２引数型

V - 第３引数型

R - 戻り値型

パラメータ:

func_ - ラムダ式

arg_ - ラムダ式に与える引数

arg2_ - ラムダ式に与える第２引数

arg3_ - ラムダ式に与える第３引数

戻り値:

ラムダ式の戻り値

rapF

public static final <T1,T2,T3,T4,R> R rapF(hiU.QuadrFunctionEx<T1,T2,T3,T4,R,Exception> func_,
                                           T1 arg_,
                                           T2 arg2_,
                                           T3 arg3_,
                                           T4 arg4_)

例外を投げる戻り値ありのラムダ式をラップし、RuntimeExceptionを投げる.

型パラメータ:

T1 - 第１引数型

T2 - 第２引数型

T3 - 第３引数型

T4 - 第４引数型

R - 戻り値型

パラメータ:

func_ - ラムダ式

arg_ - ラムダ式に与える引数

arg2_ - ラムダ式に与える第２引数

arg3_ - ラムダ式に与える第３引数

arg4_ - ラムダ式に与える第４引数

戻り値:

ラムダ式の戻り値

use_exception

public static void use_exception(boolean flag_)

デフォルト指定の無い値取得で値が無い場合RuntimeExceptionを投げる

デフォルトではExceptionを投げます。

パラメータ:

flag_ - true:投げる、false:投げない

i

public static void i()

関数inのトレース(付加メッセージなし).

スレッドid、ネストを表す縦バーの並び、-->、関数名 の形のメッセージを出力します。

   プログラム例   hiU.i();
   出力例　       0001 |  |  |  -->TraceSample.woo 

i

public static void i(String msg_)

関数inのトレース(付加メッセージ付き).

スレッドid、ネストを表す縦バーの並び、-->、関数名、付加メッセージ の形のメッセージを出力します。

   プログラム例   hiU.i("i="+i);
   出力例　       0001 |  |  |  -->TraceSample.woo  i=4

引数がnullの場合"nuLL"と表示されます。

パラメータ:

msg_ - 付加メッセージ

fi

public static void fi(String frmt_,
                      Object... args_)

関数inのトレース(フォーマットメッセージ付き).

スレッドid、ネストを表す縦バーの並び、-->、関数名、付加メッセージ の形のメッセージを出力します。

   プログラム例   hiU.fi("s=\"%s\",i=%d",s,i);
   出力例　       0001 |  |  |  -->TraceSample.woo  s="abc",i=4

フォーマット異常の場合はformat(String,Object...)に従います。

パラメータ:

frmt_ - 付加メッセージフォーマット

args_ - 引数（不定個)

i

public static void i(Object... msg_)

関数inのトレース(付加メッセージ付き).

スレッドid、ネストを表す縦バーの並び、-->、関数名 の形のメッセージを出力します。

   プログラム例
     String[] foo2(int ai[]){
        if(D) hiU.i("ai=",ai);
        String[] as= new String[ai.length];
        for(int idx=0;idx < ai.length;++idx){
           as[idx]="ai["+idx+"]="+ai[idx];
           }
        if(D) hiU.o("as=",as);
        return as;
        }
   出力例　
     0001 |  |  |  -->TraceSample.foo2  ai=[3, 4, 7, 11]

引数は６個まで書くことができます。各引数の展開形の間には空白が置かれます。

補足-1:
引数がArrayListなどの場合はArrayListのtoString()で[n, n, n]という 表示が得られます。
staticインスタンスhiFieldFormat.defaultFrmtを使っています。
このインスタンスの設定を変更すればデリミッターなどの変更が可能です。 m(Object...)の表示にも反映されます。
補足-2:
可変引数としていないのは可変引数にすると、String配列などを与えたときに 無用のワーニングが出るためです。

パラメータ:

msg_ - 付加メッセージ

o

public static void o()

関数outのトレース(付加メッセージなし).

スレッドid、ネストを表す縦バーの並び、<--、関数名 の形のメッセージを出力します。

   プログラム例   hiU.o();
   出力例　       0001 |  |  |  <--TraceSample.woo

o

public static void o(String msg_)

関数outのトレース(付加メッセージ付き).

スレッドid、ネストを表す縦バーの並び、<--、関数名、付加メッセージ の形のメッセージを出力します。

   プログラム例   hiU.o("ret="+i);
   出力例　       0001 |  |  |  <--TraceSample.woo  ret=4

パラメータ:

msg_ - 付加メッセージ

fo

public static void fo(String frmt_,
                      Object... args_)

関数outのトレース(フォーマットメッセージ付き).

スレッドidなどのフォーマット、ネストを表す縦バーの並び、<--、関数名、付加メッセージ の形のメッセージを出力します。

   プログラム例   hiU.fo("s=%s;ret=%d",s,ret);
   出力例　       0001 |  |  |  <--TraceSample.woo  s=XYZ;ret=4

フォーマット異常の場合はformat(String,Object...)に従います。

パラメータ:

frmt_ - フォーマット

args_ - 引数列

o

public static void o(Object... msg_)

関数outのトレース(付加メッセージ付き).

   プログラム例
     String[] foo2(int ai[]){
        if(D) hiU.i("ai=",ai);
        String[] as= new String[ai.length];
        for(int idx=0; idx < ai.length; ++idx){
           as[idx]="ai["+idx+"]="+ai[idx]";
           }
        if(D) hiU.o(as);
        return as;
        }
   出力例
      0001 |  |  |  <--TraceSample.foo2  as=[ai[0]=3, ai[1]=4, ai[2]=7, ai[3]=11]

パラメータ:

msg_ - 付加メッセージ

m

public static void m(String msg_)

関数内でのメッセージ出力.

スレッドidなどのフォーマット、ネストを表す縦バーの並び、付加メッセージ の形のメッセージを出力します。

   プログラム例   hiU.m("message i="+i);
   出力例　       0001 |  |  |  |  message i=5 

i(),o()の矢印部("-->","<--")が空白に置き換わったものです。
i()を持たない関数内でm()だけを発行すると、"- >"で関数名が 出力されます。

パラメータ:

msg_ - 付加メッセージ

fm

public static void fm(String frmt_,
                      Object... args_)

関数内でのメッセージ出力(フォーマット付き).

スレッドid、ネストを表す縦バーの並び、付加メッセージ の形のメッセージを出力します。

   プログラム例   hiU.fm("message s=%s,i=%d",s,i);
   出力例　       0001 |  |  |  |  message s=abc,i=5 

i(),o()の矢印部("-->","<--")が空白に置き換わったものです。
i()を持たない関数内でm()だけを発行すると、"- >"で関数名が 出力されます。
フォーマット異常の場合はformat(String,Object...)に従います。

パラメータ:

frmt_ - フォーマット

args_ - 引数列

m

public static void m(Object... msg_)

関数内でのメッセージ出力.

スレッドid、ネストを表す縦バーの並び、付加メッセージ の形のメッセージを出力します。

   プログラム例   hiU.m("ai=",ai); // ai:intの配列として
   出力例　       0001 |  |  |  |  ai=[4, 7, 3, 9] 

i(),o()の矢印部("-->","<--")が空白に置き換わったものです。
i()を持たない関数内でm()だけを発行すると、"- >"で関数名が 出力されます。

引数が配列の場合は要素の数20個まで、階層は２レベルまで展開 されます。数、階層に制限を設けているのは思わぬ大量の出力を 生成しないためです。
なお+を用いて標準のString演算を行った場合は配列は展開されず

   プログラム例   hiU.m("ai="+ai); // ai:intの配列として
   出力例　　　   0001 |  |  |  |  ai=[I@2e7263

といった表示となります。

パラメータ:

msg_ - 付加メッセージ

p

public static void p(Object... msg_)

関数内でのメッセージ出力.

hiU.m(msg)からネスト表示を取り去った 形のメッセージを出力します。

   プログラム例   hiU.p("ai=",ai); // ai:intの配列として
   出力例　       0001 ai=[4, 7, 3, 9] 

パラメータ:

msg_ - メッセージ

strs

public static String strs(Object... obj_)

複数オブジェクトの文字表示.

パラメータ:

obj_ - 文字列化したいObject

戻り値:

生成された文字列

str

public static String str(Object obj_)

Objectを表示する(toStringを持たないObjectや配列も可)

配列や辞書も表示できます。 引数objectがtoStringを持たないクラスの場合でもクラスの要素の値を表示することができます。

パラメータ:

obj_ - 文字列化したいObject

戻り値:

生成された文字列

str

public static final String str(Object obj_,
                               long option_)

str(Object)にオプションをつけたもの.

パラメータ:

obj_ - 文字列化したいObject

option_ - 表示オプション

戻り値:

生成された文字列

関連項目:

hiFieldFormat.option

str

public static String str(int[] ints_,
                         int offset_,
                         int length_)

intの配列の指定部分を表示する(試験中).

パラメータ:

ints_ - 表示する配列

offset_ - 開始位置

length_ - 長さ

戻り値:

変更後のsb_

str_format

public static final hiFieldFormat str_format()

hiFieldFormatを得る.

longで指定する以外のstr()オプションを指定する場合次のような使い方をします。

   hiU.str_format()
      .str_disable_option(hiU.OMIT_EMPTY_ELEMENT) // 空要素も表示する
      .str_depth(2) // 2段目の階層まで表示
      .str(xxxx);
   hiU.str(xxxx);   // 前回の設定の影響を受けない

戻り値:

フォーマッタ

str

public static final void str(Object obj_,
                             long option_,
                             StringBuilder sb_)

Objectを文字列化する.

パラメータ:

obj_ - 文字列化するデータ

option_ - オプション

sb_ - 文字列を入れるStringBuilder

関連項目:

hiFieldFormat.option

str

public static final String str(Throwable ex_,
                               long option_)

短縮Exception文字列を得る（スタックトレースなどオプション付き）.

クラス名とメッセージからなる短縮表現を得ます。
hiU.WITH_STACKオプションを付けるとスタックトレースが表示されます。
ファイル名とクラス名が一致する場合はファイル名は省略されます。

パラメータ:

ex_ - 例外

option_ - オプション (hiU.WITH_STACK)

戻り値:

短縮表現

str

public static final String str(Throwable ex_)

str

public static final String str(Throwable ex_,
                               long option_,
                               int depth_)

短縮Exception文字列を得る（スタックトレースなどオプション付き）.

depth_スタックレベルの最小連続個数を指定できます。例えば2を指定した場合、 スタックが7段だとすると最深部2段、省略3段、最浅部2段が表示されます。デフォルトは32段となっています。

パラメータ:

ex_ - 例外

option_ - オプション

depth_ - 最小連続階層

戻り値:

例外を表す文字列

s

public static String s(String text_)

文字列nullで""を返す単純メソッド.

パラメータ:

text_ - テキスト

戻り値:

nullの場合空文字列

format

public static String format(String frmt_,
                            Object... args_)

標準フォーマット変換（Exception無し）.

String.format()のExceptionを回避します。
　　*フォーマット異常の場合は、異常内容に続いて、フォーマット文字列 各引数のtoString()文字列を並べた文字列を返します。
例えば、次のような引数（%dに対して文字列)

   String msg1=hiU.format("s1=%s d1=%d","abc",17);

を与えると次の文字列が得られます。

   s1=abc d1=17

フォーマットの間違いがあると、エラーメッセージが付加されます。 例えば次のように"%d"に文字列を与えると

   String msg2=hiU.format("s1=%s d1=%d","abc","xyz");

エラーメッセージが付加された文字列となります。

   d != java.lang.String:s1=%s d1=%d;abc;xyz

format記述の詳細はFormatterにあります。

基本形はC言語のprintfの形式と同じで
 %{フラグ}{幅}{.精度} です。
例えば次のような指定ができます。

%d	単純整数	10	int i=10
%04X	0フィルした16進数	000A	int i=10
%.2f	小数点以下2桁	123.45	double d=123.456

パラメータ:

frmt_ - フォーマット

args_ - 引数列

戻り値:

フォーマットされた文字列

t

public static void t(Object... msg_)

TraceまたはTest出力.

T_OUTPUT(デフォルト0)番のトレース設定に出力します。
hiU.t("abc")はhiU.tn(hiU.T_OUTPUT,"abc")と同じです。
出力先はhiU.Trace.setTraceFile(int,String,long)または環境変数hiTRACEで設定できます。
無設定の場合は標準エラーに出力されます。

パラメータ:

msg_ - 出力したいメッセージオブジェクト;多重化した配列なども表示できます。

tn

public static void tn(int n_,
                      Object... msg_)

TraceまたはTest出力（設定番号指定あり）.

指定番のトレース設定に出力します。
出力先はhiU.Trace.setTraceFile(int,String,long)または環境変数hiTRACEで設定できます。
無設定の場合は標準エラーに出力されます。

パラメータ:

n_ - トレース設定番号指定

msg_ - 出力したいメッセージオブジェクト;多重化した配列なども表示できます。

funcNameNest

public static String[] funcNameNest(int level_)

関数ネストを得る（段数指定）.

hiStack.funcNameNest(int)の別名です

パラメータ:

level_ - 取得する最大段数

戻り値:

関数名リスト

funcNameNest

public static String[] funcNameNest(int start_,
                                    int level_)

指定親レベルからび関数ネストを得る（段数指定）.

hiStack.funcNameNest(int,int)の別名です

パラメータ:

start_ - 開始位置

level_ - 取得する最大段数

戻り値:

関数名リスト

funcNameNest

public static String[] funcNameNest()

関数ネストを得る（全段）.

hiStack.funcNameNest()の別名です

戻り値:

関数名リスト

currentFuncName

public static String currentFuncName()

カレント関数名を得る.

hiStack.currentFuncName()の別名です

戻り値:

カレント関数名 "クラス名.関数名"

parentFuncName

public static String parentFuncName(int level_)

親関数名を得る.

hiStack.parentFuncName(int)の別名です

パラメータ:

level_ - 0:自分,1:親,2:親の親

戻り値:

親関数名 "クラス名.関数名"　レベル外の場合は空文字列

関連項目:

hiU.currentFuncName(), hiU.parentFuncName(), hiU.currentThreadId()

currentThreadId

public static long currentThreadId()

カレントスレッドidを得る.

次の操作と同等です。

Thread.currentThread().getId()

戻り値:

スレッドid

関連項目:

currentFuncName(), parentFuncName(int)

indentBar

public static String indentBar(int level_)

階層を表すバー付き文字列を作成する.

指定の階層分、階層を表す文字列を作成します。
負の場合長さ0の文字列が返ります。
正の場合指定値の下位１バイトのみ使用されます。

パラメータ:

level_ - ネストレベル

戻り値:

階層文字列

indent

public static String indent(int level_)

階層を表す文字列を作成する. 負の場合長さ0の文字列が返ります。
正の場合指定値の下位１バイトのみ使用されます。
１階層は３個の空白となります。

パラメータ:

level_ - ネストレベル

戻り値:

階層文字列

indent

public static String indent(int level_,
                            String indent1_,
                            String indent2_)

階層を文字列（パターン指定）を作成する. 負の場合長さ0の文字列が返ります。
正の場合指定値の下位１バイトのみ使用されます。
階層を表す文字の指定ができます。
５段が１セットで、４段は文字列１、１段は文字列２が使われます。

パラメータ:

level_ - ネストレベル

indent1_ - インデントに用いる文字列１

indent2_ - インデントに用いる文字列２

戻り値:

階層文字列

className

public static String className(Object obj_)

Objectのクラス名を得る.

次のコードと同じです。

   Object o;
   // oにクラスセット
   String name= o==null?"nuLL":o.getClass().getSimpleName(); 

パラメータ:

obj_ - 対象Object

戻り値:

Objectのクラス名

close

public static void close(Closeable... ios_)

例外を投げないclose.

close()呼び出しで例外が投げられないようにします。
必ずしもファイル用とは限りませんのでhiUに置いてあります。

パラメータ:

ios_ - closeしたいioインスタンス並び

close

public static void close(Object... ios_)

Closeableがない1.7以前のシステム用close(廃棄予定)

引数Objectがcloseメソッドを持つ場合呼び出します。

パラメータ:

ios_ - closeしたいioインスタンス並び

sysCharSet

public static final String sysCharSet()

システム（仮想マシン）のデフォルトの文字セットを得る.

次の操作と同等です。

   String charset = java.nio.charset.Charset.defaultCharset().name();

戻り値:

システムの文字セット

atoi

public static final int atoi(String str_)

整数文字列をパーズする.

整数文字列をパーズします。前方の空白と、後方の非整数文字列は無視されます。
例:" 12xxx"->12
hiU.use_exceptionをtrueにすると、パーズ失敗時に 例外を投げます。falseの場合0を返します。

パラメータ:

str_ - パーズする文字列

戻り値:

パーズされた数値

例外:

RuntimeException - 形式異常

atoi

public static final int atoi(String str_,
                             String msg_)

整数文字列をパーズする.

整数文字列をパーズします。前方の空白と、後方の非整数文字列は無視されます。
例:" 12xxx"->12
パーズに失敗するとmsg_を理由をcauseとしメッセージとするhiExceptionが投げられます。

パラメータ:

str_ - パーズする文字列

msg_ - Exceptionに重ねるメッセージ

戻り値:

パーズされた数値

atoi

public static final int atoi(String str_,
                             int def_)

整数文字列をパーズする.

整数文字列をパーズします。前方の空白と、後方の非整数文字列は無視されます。
例:" 12xxx"->12
パーズに失敗するとdef_が返ります。

パラメータ:

str_ - パーズする文字列

def_ - パーズできなかった場合の値

戻り値:

パーズされた数値

otoi

public static final int otoi(Object obj_)

Objectからint値を得る.

toString()で文字列化した後intにパーズします

パラメータ:

obj_ - オブジェクト

戻り値:

整数

itoa

public static final String itoa(int i_)

intの文字列を得る.

Integer.toString()の代わりに用意されました。 0～999の間の数の変換が高速化されています。

パラメータ:

i_ - 数値

戻り値:

文字列

itoa3

public static final String itoa3(int i_)

intの３桁区切りの文字列を得る.

パラメータ:

i_ - 数値

戻り値:

文字列

atol

public static long atol(String str_)

整数文字列をパーズする。

浮動少数文字列をパーズします。
hiU.use_exceptionをtrueにすると、パーズ失敗時に 例外を投げます。falseの場合0を返します。

パラメータ:

str_ - パーズする文字列

戻り値:

パーズされた数値

atol

public static long atol(String str_,
                        String exMsg_)

整数文字列をパーズする。

浮動少数文字列をパーズします。
パーズ失敗時は"固定メッセージ;"+exMsg_を持つRuntimeExceptionを投げます。

パラメータ:

str_ - パーズする文字列

exMsg_ - パーズ失敗時に例外メッセージに付加する文字列

戻り値:

パーズされた数値

atol

public static long atol(String str_,
                        long def_)

整数文字列をパーズする。

浮動少数文字列をパーズします。
パーズ失敗時にはdef_が返ります。

パラメータ:

str_ - パーズする文字列

def_ - パーズできなかった場合の値

戻り値:

パーズされた数値

otol

public static final long otol(Object obj_)

Objectからlong値を得る.

toString()で文字列化した後longにパーズします

パラメータ:

obj_ - オブジェクト

戻り値:

整数

ltoa

public static String ltoa(long l_)

longの文字列を得る

パラメータ:

l_ - 数値

戻り値:

文字列

ltoa3

public static final String ltoa3(long l_)

longの3桁区切りの文字列を得る

パラメータ:

l_ - 数値

戻り値:

文字列

toHankaku

public static String toHankaku(CharSequence val_)

数値文字列を半角化する. 全角数値(１，２など）を半角数値（1,2などにします) 変換するのは 0～9,a～f,A-F,ドット,マイナス、プラスです。

パラメータ:

val_ - 全角数値

戻り値:

半角数値

atod

public static double atod(String str_)

浮動少数文字列をパーズする。

hiU.use_exceptionをtrueにすると、パーズ失敗時に 例外を投げます。falseの場合0を返します。

パラメータ:

str_ - パーズする文字列

戻り値:

パーズされた数値

atod

public static double atod(String str_,
                          String exMsg_)

浮動少数文字列をパーズする。

パーズ失敗時は"固定メッセージ;"+exMsg_を持つRuntimeExceptionを投げます。

パラメータ:

str_ - パーズする文字列

exMsg_ - パーズ失敗時に例外メッセージに付加する文字列

戻り値:

パーズされた数値

atod

public static double atod(String str_,
                          double def_)

浮動少数文字列をパーズする.

パラメータ:

str_ - パーズする文字列

def_ - パーズできなかった場合の値

戻り値:

パーズされた数値

otod

public static final double otod(Object obj_)

Objectからdouble値を得る.

toString()で文字列化した後doubleにパーズします

パラメータ:

obj_ - オブジェクト

戻り値:

整数

dtoa

public static String dtoa(double d_)

doubleの文字列を得る

パラメータ:

d_ - 数値

戻り値:

文字列

atob

public static boolean atob(String str_,
                           boolean def_)

Boolean文字列をパーズする.

パラメータ:

str_ - パーズする文字列

def_ - パーズできなかった場合の値

戻り値:

パーズされた数値

atob

public static final boolean atob(String str_)

Boolean文字列をパーズする.

文字は大文字小文字は問いません。
次の文字列は肯定(true)と判断されます。
 true,yes,affirmative,ok,on,1以上の整数
次の文字列は否定(false)と判断されます。
 false,no,negative,ng,off,not,none,0以下の整数

パラメータ:

str_ - パーズする文字列

戻り値:

パーズされた数値

isNull

public static final boolean isNull(String str_)

文字列がnullまたは空文字列であるかをチェックする.

文字列が空であることのプログラム上の表現はnullと""が混在します。
この関数は極めて単純なものですが、バグ回避に大きく貢献する 現実重視のものです。

   // String strとして
   if( hiU.isNull(str) ) {...}              // は
   if( sts==null || str.length()==0 ) {...} // と同じ

パラメータ:

str_ - 文字列

戻り値:

true:nullまたは空、else:文字内容あり

isNull

public static final boolean isNull(Collection collection_)

リスト/コレクションがnullまたは空であるかチェックする

パラメータ:

collection_ - チェックするリスト/コレクション

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(Map map_)

Mapがnullまたは空であるかチェックする

パラメータ:

map_ - チェックするマップ

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(Object[] array_)

Object 配列がnullまたは空であるかチェックする

パラメータ:

array_ - チェックする配列

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(int[] array_)

innt 配列がnullまたは空であるかチェックする

パラメータ:

array_ - チェックする配列

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(char[] array_)

char 配列がnullまたは空であるかチェックする

パラメータ:

array_ - チェックする配列

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(byte[] array_)

byte 配列がnullまたは空であるかチェックする

パラメータ:

array_ - チェックする配列

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(double[] array_)

double 配列がnullまたは空であるかチェックする

パラメータ:

array_ - チェックする配列

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(float[] array_)

float 配列がnullまたは空であるかチェックする

パラメータ:

array_ - チェックする配列

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(boolean[] array_)

boolean 配列がnullまたは空であるかチェックする

パラメータ:

array_ - チェックする配列

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(short[] array_)

short 配列がnullまたは空であるかチェックする

パラメータ:

array_ - チェックする配列

戻り値:

true:nullまたはempty、else：要素あり

isNull

public static final boolean isNull(long[] array_)

long 配列がnullまたは空であるかチェックする

パラメータ:

array_ - チェックする配列

戻り値:

true:nullまたはempty、else：要素あり

isOn

public static final boolean isOn(int flags_,
                                 int flag_bit_)

フラグビットがonか調べる.

単純操作ですが、意味を明確に示すために導入しました。

　次の２つは同等です
   if( (flags_&flag_bit_)!=0 ) ...
   if( hiU.isOn(flags_,flag_bit_) ) ...

パラメータ:

flags_ - フラグ並び

flag_bit_ - フラグビット

戻り値:

true:フラグon,false:フラグoff

isOn

public static final boolean isOn(long flags_,
                                 long flag_bit_)

フラグビットがonか調べる.

単純操作ですが、意味を明確に示すために導入しました。

　次の２つは同等です
   if( (flags_&flag_bit_)!=0 ) ...
   if( hiU.isOn(flags_,flag_bit_) ) ...

パラメータ:

flags_ - フラグ並び

flag_bit_ - フラグビット

戻り値:

true:フラグon,false:フラグoff

isOff

public static final boolean isOff(int flags_,
                                  int flag_bit_)

/** フラグビットがoffか調べる.

単純操作ですが、意味を明確に示すために導入しました

　次の２つは同等です
   if( (flags_&flag_bit_)==0 ) ...
   if( hiU.isOff(flags_,flag_bit_) ) ...

パラメータ:

flags_ - フラグ並び

flag_bit_ - フラグビット

戻り値:

true:フラグof,false:フラグon

isOff

public static final boolean isOff(long flags_,
                                  long flag_bit_)

/** フラグビットがoffか調べる.

単純操作ですが、意味を明確に示すために導入しました

　次の２つは同等です
   if( (flags_&flag_bit_)==0 ) ...
   if( hiU.isOff(flags_,flag_bit_) ) ...

パラメータ:

flags_ - フラグ並び

flag_bit_ - フラグビット

戻り値:

true:フラグof,false:フラグon

equals

public static boolean equals(String text1_,
                             String text2_)

２つStringの単純比較(nullを許す)

Stringにはnullがセットされる場合は良くあります。 そのままequals比較を行いExceptionを発生させてしまうことも 良くあります。この関数は２つのStringのどちらもnullを ゆるし、かつnullは長さ0の文字列と等しいとして比較します。

   // String text1,text2として
   boolean b= hiU.equals(text1,text2);
  は
   boolean b;
   if(text1==null || text1.length()==0 ){
      b= (text2==null)||(text2.length()==0);
      }
   else{
      b= text1.equals(text2);
      }
   と同じです。

パラメータ:

text1_ - 文字列(null可)

text2_ - 文字列(null可)

戻り値:

true:等しい、false:等しくない

unitNum

public static int unitNum(int unitSize_,
                          int size_)

ユニット数。ある数が何ユニットになるか計算する.

極めて単純な計算式なのですが毎回考えるのは面倒なので 用意しました。
式は
 (size-1)/unitSize+1
です。
ユニットサイズが8の場合、0->0 1～8->1 9～17->2 という値が 得られます。

パラメータ:

unitSize_ - ユニットの長さ、バイトであれば8

size_ - データサイズ

戻り値:

ユニット数

lastUnitSize

public static int lastUnitSize(int unitSize_,
                               int size_)

最後のユニット内のデータ数. 極めて単純な計算式なのですが毎回考えるのは面倒なので 用意しました。
式は
 (size-1)%unitSize+1
です。
ユニットサイズが8の場合 0->0 1～8->1～8 9～16->1～8

パラメータ:

unitSize_ - ユニットの長さ、バイトであれば8

size_ - データサイズ

戻り値:

最後のユニットのデータ長

getStackTrace

public static String getStackTrace(Exception ex_)

ExceptionのstackTraceを文字列に得る. hiStack.getStackTrace(Exception)の別名

パラメータ:

ex_ - スタックトレースを得たいException

戻り値:

スタックトレース文字列

usedMemory

public static long usedMemory()

使用中のメモリサイズを得る.

使用中のメモリサイズを次のようにして得ます。

  Runtime runtime= Runtime.getRuntime();
  runtime.totalMemory()-runtime.freeMemory();

戻り値:

メモリサイズ

memorySizeInfo

public static String memorySizeInfo()

メモリサイズ情報表示を得る.

次の文字列が得られます。

   used:使用 free:空き total:全

戻り値:

メモリサイズ情報を表す文字列

join

public static StringBuilder join(StringBuilder sb_,
                                 Iterable objs_,
                                 String dlmt_)

Objectのリストを文字列連結しStringBuilderに付加する. 各ObjectはhiU.str(obj)を用いて文字列化されStringBuilderに追加されます。
２番目以降はその前に指定デリミタが付加されます。

パラメータ:

sb_ - ここに追加される

objs_ - オブジェクトのリスト

dlmt_ - 区切り記号

戻り値:

変更後のsb_

wait

public void wait(Object obj_)

明示Exception無しのwait.

次の操作と同等です。

      try{ obj_.wait(); }
      catch(Exception _ex){throw hiU.asRuntimeException(_ex);}

パラメータ:

obj_ - waitするオブジェクト

isUnix

public static final boolean isUnix()

システムがUNIXを調べる.

次のコードと同等です。

   File.separatorChar=='/'

戻り値:

true:UNIX、false:UNIXではない

isWindows

public static final boolean isWindows()

システムがWindowsを調べる.

次のコードと同等です。

   File.separatorChar=='\\'

戻り値:

true:Windows、false:Windowsではない

rand

public static int rand(int xi_)

線形合同法による乱数生成.

システムによらず決定的な乱数を得たい場合に用いること ができます。
得られる値は0～16383(<0x4000)の間になります。
例えば次のようなプログラムで、毎回同じ乱数値をセット することができます。

    byte[] data= new byte[256];
    int    xi  = 0xAA;
    for(int idx=0;idx < data.length;++idx){
       xi       = hiU.rand(xi);
       data[idx]= (byte)xi;
       }

a=12869,b=6925,m=0x4000とした線形合同法による擬似乱数 生成を行います。
次の記述と同等です。

    int xi =//適当に
    int xii=(xi*12869+6925)%0x4000;

パラメータ:

xi_ - 値

戻り値:

新しい値

equals

public static <T> boolean equals(T obj1_,
                                 T obj2_)

オブジェクトの比較(null可,equals使用)(試験中).

型パラメータ:

T - 型

パラメータ:

obj1_ - オブジェクト

obj2_ - オブジェクト

戻り値:

一致していればtrue