[openrtm-commit:01485] r2585 - branches/RELENG_1_1/OpenRTM-aist/src/lib/coil/common

openrtm @ openrtm.org openrtm @ openrtm.org
2014年 10月 21日 (火) 16:32:24 JST


Author: kawauchi
Date: 2014-10-21 16:32:24 +0900 (Tue, 21 Oct 2014)
New Revision: 2585

Modified:
   branches/RELENG_1_1/OpenRTM-aist/src/lib/coil/common/stringutil.h
Log:
reverted.

Modified: branches/RELENG_1_1/OpenRTM-aist/src/lib/coil/common/stringutil.h
===================================================================
--- branches/RELENG_1_1/OpenRTM-aist/src/lib/coil/common/stringutil.h	2014-10-21 03:58:24 UTC (rev 2584)
+++ branches/RELENG_1_1/OpenRTM-aist/src/lib/coil/common/stringutil.h	2014-10-21 07:32:24 UTC (rev 2585)
@@ -24,10 +24,6 @@
 #include <vector>
 #include <sstream>
 
-#if defined (_MSC_VER) && (_MSC_VER <=1500) // VC2008(VC9.0) or before
-#else
-#include <stdint.h>
-#endif
 // Cygwin's gcc does not provide wstring type
 #if defined(Cygwin) && ( __GNUC__ < 4 )
 namespace std
@@ -42,11 +38,13 @@
 
   /*!
    * @if jp
-   * @brief string ¤«¤Ewstring ¤Ø¤ÎÊÑ´¹
+   * @brief string から wstring への変換
    *
-   * Í¿¤¨¤é¤E¿ string ʸ»úÎó¤Ewstring ʸ»úÎó¤ËÊÑ´¹
+   * 与えられた string 文字列を wstring 文字列に変換
    *
-   * @param str std::string ·¿¤ÎÆþÎÏʸ»ú΁E   * @return std::wstring ·¿¤Î½ÐÎÏʸ»ú΁E   *
+   * @param str std::string 型の入力文字列
+   * @return std::wstring 型の出力文字列
+   *
    * @else
    * @brief string to wstring conversion
    *
@@ -61,11 +59,13 @@
 
   /*!
    * @if jp
-   * @brief wstring ¤«¤Estring ¤Ø¤ÎÊÑ´¹
+   * @brief wstring から string への変換
    *
-   * Í¿¤¨¤é¤E¿ wstring ʸ»úÎó¤Estring ʸ»úÎó¤ËÊÑ´¹
+   * 与えられた wstring 文字列を string 文字列に変換
    *
-   * @param str std::wstring ·¿¤ÎÆþÎÏʸ»ú΁E   * @return std::string ·¿¤Î½ÐÎÏʸ»ú΁E   *
+   * @param str std::wstring 型の入力文字列
+   * @return std::string 型の出力文字列
+   *
    * @else
    * @brief wstring to string conversion
    *
@@ -82,9 +82,10 @@
    * @if jp
    * @brief 大文字への変換
    *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤òÂçʸ»ú¤ËÊÑ´¹
+   * 与えられた文字列を大文字に変換
    *
-   * @param str ÆþÎÏʸ»ú΁E   *
+   * @param str 入力文字列
+   *
    * @else
    * @brief Uppercase String Transformation
    *
@@ -100,9 +101,10 @@
    * @if jp
    * @brief 小文字への変換
    *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤ò¾®Ê¸»ú¤ËÊÑ´¹
+   * 与えられた文字列を小文字に変換
    *
-   * @param str ÆþÎÏʸ»ú΁E   *
+   * @param str 入力文字列
+   *
    * @else
    * @brief Lowercase String Transformation
    *
@@ -116,14 +118,17 @@
 
   /*!
    * @if jp
-   * @brief ÆþÎÏ¥¹¥È¥ê¡¼¥à¤«¤E¹ÔÆɤ߹þ¤E   *
-   * ÆþÎÏ¥¹¥È¥ê¡¼¥à¤«¤E¹ÔÆɤ߹þ¤à¡£
-   * ÆþÎÏ¥¹¥È¥ê¡¼¥à¤Ï¤Î²þ¹Ô¥³¡¼¥É¤ÏUNIX, Windows¤Î²þ¹Ô¥³¡¼¥É¤Î¤¤¤º¤E«¡¢
+   * @brief 入力ストリームから1行読み込む
+   *
+   * 入力ストリームから1行読み込む。
+   * 入力ストリームはの改行コードはUNIX, Windowsの改行コードのいずれか、
    * もしくは混在していてもよい。
    *
-   * @param istr ÆþÎÏ¥¹¥È¥ê¡¼¥E   * @param line Æɤ߹þ¤ó¤Àʸ»úÎó¤ò³ÊǼ¤¹¤EÑ¿E   *
-   * @return ²þ¹Ôʸ»ú¤ò½E¯Æɤ߹þ¤ó¤Àʸ»úÎó¤ÎŤµ
+   * @param istr 入力ストリーム
+   * @param line 読み込んだ文字列を格納する変数
    *
+   * @return 改行文字を除く読み込んだ文字列の長さ
+   *
    * @else
    * @brief Read a line from input stream
    *
@@ -141,13 +146,15 @@
   
   /*!
    * @if jp
-   * @brief ʸ»úÎ󤬥¨¥¹¥±¡¼¥×¤µ¤EƤ¤¤E«È½ÃǤ¹¤E   *
-   * »ØÄꤵ¤E¿Ê¸»ú¤¬¥¨¥¹¥±¡¼¥×¤µ¤EƤ¤¤E«¤É¤¦¤«¤òȽÃǤ¹¤E£
+   * @brief 文字列がエスケープされているか判断する
    *
-   * @param str ¥¨¥¹¥±¡¼¥×¤µ¤EƤ¤¤E«¤É¤¦¤«È½ÃǤ¹¤E¸»ú¤ò´Þ¤àʸ»ú΁E   * @param pos ¥¨¥¹¥±¡¼¥×¤µ¤EƤ¤¤E«¤É¤¦¤«È½ÃǤ¹¤E¸»ú¤Î°ÌÃÖ
+   * 指定された文字がエスケープされているかどうかを判断する。
    *
-   * @return »ØÄꤷ¤¿Ê¸»ú¤¬¥¨¥¹¥±¡¼¥×¤µ¤EƤ¤¤EÐ true, ¤½¤Eʳ°¤Ï false
+   * @param str エスケープされているかどうか判断する文字を含む文字列
+   * @param pos エスケープされているかどうか判断する文字の位置
    *
+   * @return 指定した文字がエスケープされていれば true, それ以外は false
+   *
    * @else
    * @brief Check whether the character is escaped or not
    *
@@ -164,16 +171,19 @@
   
   /*!
    * @if jp
-   * @brief ʸ»úÎó¤ò¥¨¥¹¥±¡¼¥×¤¹¤E   *
-   * ¼¡¤Îʸ»ú¤ò¥¨¥¹¥±¡¼¥×¥·¡¼¥±¥ó¥¹¤ËÊÑ´¹¤¹¤E£<br>
+   * @brief 文字列をエスケープする
+   *
+   * 次の文字をエスケープシーケンスに変換する。<br>
    * HT -> "\t" <br>
    * LF -> "\n" <br>
    * CR -> "\r" <br>
    * FF -> "\f" <br>
-   * ¥·¥ó¥°¥E¯¥ª¡¼¥È¡¢¥À¥Ö¥E¯¥ª¡¼¥È¤Ë¤Ä¤¤¤Æ¤Ï¤È¤¯¤Ë½èÍý¤Ï¤·¤Ê¤¤¡£
+   * シングルクオート、ダブルクオートについてはとくに処理はしない。
    *
-   * @param str ¥¨¥¹¥±¡¼¥×½èÍýÂоÝʸ»ú΁E   *
-   * @return ¥¨¥¹¥±¡¼¥×½èÍý·EÌʸ»ú΁E   *
+   * @param str エスケープ処理対象文字列
+   *
+   * @return エスケープ処理結果文字列
+   *
    * @else
    *
    * @brief Escape string
@@ -197,17 +207,19 @@
    * @if jp
    * @brief 文字列のエスケープを戻す
    *
-   * ¼¡¤Î¥¨¥¹¥±¡¼¥×¥·¡¼¥±¥ó¥¹¤òʸ»ú¤ËÊÑ´¹¤¹¤E£<br>
+   * 次のエスケープシーケンスを文字に変換する。<br>
    * "\t" -> HT <br>
    * "\n" -> LF <br>
    * "\r" -> CR <br>
    * "\f" -> FF <br>
    * "\"" -> "  <br>
    * "\'" -> '  <br>
-   * ※エスケープ処理の完全な逆変換にはなっていないため、丁盲が必要。
+   * ※エスケープ処理の完全な逆変換にはなっていないため、注意が必要。
    *
-   * @param str ¥¢¥ó¥¨¥¹¥±¡¼¥×½èÍýÂоÝʸ»ú΁E   *
-   * @return ¥¢¥ó¥¨¥¹¥±¡¼¥×½èÍý·EÌʸ»ú΁E   *
+   * @param str アンエスケープ処理対象文字列
+   *
+   * @return アンエスケープ処理結果文字列
+   *
    * @else
    *
    * @brief Unescape string
@@ -231,11 +243,13 @@
 
   /*!
    * @if jp
-   * @brief ʸ»úÎó¤Î¶õÇòʸ»ú¤òºEE¹¤E   *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤Î¶õÇòʸ»ú¤òºEE¹¤E£
+   * @brief 文字列の空白文字を削除する
+   *
+   * 与えられた文字列の空白文字を削除する。
    * 空白文字として扱うのは' '(スペース)と'\\t'(タブ)。
    *
-   * @param str ¶õÇòʸ»úºEEèÍýʸ»ú΁E   *
+   * @param str 空白文字削除処理文字列
+   *
    * @else
    * @brief Erase blank characters of string
    *
@@ -250,11 +264,13 @@
 
   /*!
    * @if jp
-   * @brief ʸ»úÎó¤ÎÀèƬ¤Î¶õÇòʸ»ú¤òºEE¹¤E   *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤ÎÀèƬ¤Ë¸ºß¤¹¤EõÇòʸ»ú¤òºEE¹¤E£
+   * @brief 文字列の先頭の空白文字を削除する
+   *
+   * 与えられた文字列の先頭に存在する空白文字を削除する。
    * 空白文字として扱うのは' '(スペース)と'\\t'(タブ)。
    *
-   * @param str ÀèƬ¶õÇòʸ»úºEEèÍýʸ»ú΁E   *
+   * @param str 先頭空白文字削除処理文字列
+   *
    * @else
    * @brief Erase the head blank characters of string
    *
@@ -269,11 +285,13 @@
   
   /*!
    * @if jp
-   * @brief ʸ»úÎó¤ÎËöÈø¤Î¶õÇòʸ»ú¤òºEE¹¤E   *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤ÎËöÈø¤Ë¸ºß¤¹¤EõÇòʸ»ú¤òºEE¹¤E£
+   * @brief 文字列の末尾の空白文字を削除する
+   *
+   * 与えられた文字列の末尾に存在する空白文字を削除する。
    * 空白文字として扱うのは' '(スペース)と'\\t'(タブ)。
    *
-   * @param str ËöÈø¶õÇòʸ»úºEEèÍýʸ»ú΁E   *
+   * @param str 末尾空白文字削除処理文字列
+   *
    * @else
    * @brief Erase the tail blank characters of string
    *
@@ -289,11 +307,13 @@
 
   /*!
    * @if jp
-   * @brief ʸ»úÎó¤ÎÀèƬ¡¦ËöÈø¤Î¶õÇòʸ»ú¤òºEE¹¤E   *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤ÎÀèƬ¤ª¤è¤ÓËöÈø¤Ë¸ºß¤¹¤EõÇòʸ»ú¤òºEE¹¤E£
+   * @brief 文字列の先頭・末尾の空白文字を削除する
+   *
+   * 与えられた文字列の先頭および末尾に存在する空白文字を削除する。
    * 空白文字として扱うのは' '(スペース)と'\\t'(タブ)。
    *
-   * @param str ÀèƬËöÈø¶õÇòʸ»úºEEèÍýʸ»ú΁E   *
+   * @param str 先頭末尾空白文字削除処理文字列
+   *
    * @else
    * @brief Erase the head blank and the tail blank characters of string
    *
@@ -309,11 +329,13 @@
 
   /*!
    * @if jp
-   * @brief ʸ»úÎó¤òÀµµ¬²½¤¹¤E   *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤ÎÀèƬ¤ª¤è¤ÓËöÈø¤Ë¸ºß¤¹¤EõÇòʸ»ú¤òºEE·¡¢
-   * ±Ñ»ú¤ò¤¹¤Ù¤Æ¾®Ê¸»ú¤ËÊÑ´¹¤¹¤E£
+   * @brief 文字列を正規化する
    *
-   * @param str ½èÍýÂоÝʸ»ú΁E   *
+   * 与えられた文字列の先頭および末尾に存在する空白文字を削除し、
+   * 英字をすべて小文字に変換する。
+   *
+   * @param str 処理対象文字列
+   *
    * @else
    * @brief Erase the head/tail blank and replace upper case to lower case
    *
@@ -330,10 +352,14 @@
   
   /*!
    * @if jp
-   * @brief ʸ»úÎó¤òÃÖ¤­´¹¤¨¤E   *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤ËÂФ·¤Æ¡¢»ØÄꤷ¤¿Ê¸»ú¤ÎÃÖ¤­´¹¤¨¤ò¹Ô¤¦¡£
+   * @brief 文字列を置き換える
    *
-   * @param str ÃÖ¤­´¹¤¨½èÍýÂоÝʸ»ú΁E   * @param from ÃÖ´¹¸µÊ¸»E   * @param to ÃÖ´¹Àèʸ»E   *
+   * 与えられた文字列に対して、指定した文字の置き換えを行う。
+   *
+   * @param str 置き換え処理対象文字列
+   * @param from 置換元文字
+   * @param to 置換先文字
+   *
    * @else
    * @brief Replace string
    *
@@ -350,12 +376,14 @@
   
   /*!
    * @if jp
-   * @brief ʸ»úÎó¤òʬ³äʸ»ú¤Çʬ³ä¤¹¤E   * 
-   * ÀßÄꤵ¤E¿Ê¸»úÎó¤òÍ¿¤¨¤é¤E¿¥Ç¥Eߥ¿¤Çʬ³ä¤¹¤E£
+   * @brief 文字列を分割文字で分割する
+   * 
+   * 設定された文字列を与えられたデリミタで分割する。
    *
-   * @param input ʬ³äÂоÝʸ»ú΁E   * @param delimiter ʬ³äʸ»ú΁E¥Ç¥Eߥ¿)
+   * @param input 分割対象文字列
+   * @param delimiter 分割文字列(デリミタ)
    *
-   * @return ʸ»úÎóʬ³ä·EÌ¥E¹¥È
+   * @return 文字列分割結果リスト
    *
    * @else
    * @brief Split string by delimiter
@@ -375,12 +403,17 @@
   
   /*!
    * @if jp
-   * @brief Í¿¤¨¤é¤E¿Ê¸»úÎó¤òboolÃͤËÊÑ´¹¤¹¤E   * 
-   * »ØÄꤵ¤E¿Ê¸»úÎó¤ò¡¢trueɽ¸½Ê¸»úÎó¡¢falseɽ¸½Ê¸»úÎó¤ÈÈæ³Ó¤·¡¢¤½¤Î·E̤E   * boolÃͤȤ·¤ÆÊÖ¤¹¡£
-   * Èæ³Ó¤Î·EÌ¡¢trueɽ¸½Ê¸»úÎó¡¢falseɽ¸½Ê¸»úÎó¤Î¤É¤Á¤é¤È¤â°Eפ·¤Ê¤¤¾Eç¤Ï¡¢
-   * Í¿¤¨¤é¤E¿¥Ç¥Õ¥©¥EÈÃͤòÊÖ¤¹¡£
+   * @brief 与えられた文字列をbool値に変換する
+   * 
+   * 指定された文字列を、true表現文字列、false表現文字列と比較し、その結果を
+   * bool値として返す。
+   * 比較の結果、true表現文字列、false表現文字列のどちらとも一致しない場合は、
+   * 与えられたデフォルト値を返す。
    *
-   * @param str ȽÃÇÂоÝʸ»ú΁E   * @param yes trueɽ¸½Ê¸»ú΁E   * @param no falseɽ¸½Ê¸»ú΁E   * @param default_value ¥Ç¥Õ¥©¥EÈÃÍ(¥Ç¥Õ¥©¥EÈÃÍ:true)
+   * @param str 判断対象文字列
+   * @param yes true表現文字列
+   * @param no false表現文字列
+   * @param default_value デフォルト値(デフォルト値:true)
    * @else
    * @brief Convert given string into bool value
    * 
@@ -400,12 +433,14 @@
               bool default_value = true);
   /*!
    * @if jp
-   * @brief ʸ»úÎó¥E¹¥ÈÃæ¤Ë¤¢¤E¸»úÎ󤬴ޤޤEE«¤É¤¦¤«¤òȽÃǤ¹¤E   * 
-   * E°ú¿ô¤Ë¥«¥ó¥Þ¶èÀÚ¤ê¤Î¥E¹¥È¤ò¡¢ÂE°ú¿ô¤Ëõº÷ÂоÝʸ»úÎó¤ò»ØÄꤷ¡¢
-   * ¤½¤Îʸ»úÎó¤¬ÂE°ú¿ô¤ÎÃæ¤Ë´Þ¤Þ¤EE«¤òȽÃǤ¹¤E£
+   * @brief 文字列リスト中にある文字列が含まれるかどうかを判断する
+   * 
+   * 第1引数にカンマ区切りのリストを、第2引数に探索対象文字列を指定し、
+   * その文字列が第1引数の中に含まれるかを判断する。
    *
-   * @param list ÂоݥE¹¥È
-   * @param value õº÷ʸ»ú΁E   * @return true: ´Þ¤Þ¤EE¢false: ´Þ¤Þ¤Eʤ¤
+   * @param list 対象リスト
+   * @param value 探索文字列
+   * @return true: 含まれる、false: 含まれない
    *
    * @else
    * @brief Include if a string is included in string list
@@ -424,11 +459,14 @@
 
   /*!
    * @if jp
-   * @brief ʸ»úÎó¥E¹¥ÈÃæ¤Ë¤¢¤E¸»úÎ󤬴ޤޤEE«¤É¤¦¤«¤òȽÃǤ¹¤E   * 
-   * E°ú¿ô¤Ë¥«¥ó¥Þ¶èÀÚ¤ê¤Î¥E¹¥È¤ò¡¢ÂE°ú¿ô¤Ëõº÷ÂоÝʸ»úÎó¤ò»ØÄꤷ¡¢
-   * ¤½¤Îʸ»úÎó¤¬ÂE°ú¿ô¤ÎÃæ¤Ë´Þ¤Þ¤EE«¤òȽÃǤ¹¤E£
+   * @brief 文字列リスト中にある文字列が含まれるかどうかを判断する
+   * 
+   * 第1引数にカンマ区切りのリストを、第2引数に探索対象文字列を指定し、
+   * その文字列が第1引数の中に含まれるかを判断する。
    *
-   * @param list ÂоÝʸ»ú΁E   * @param value õº÷ʸ»ú΁E   * @return true: ´Þ¤Þ¤EE¢false: ´Þ¤Þ¤Eʤ¤
+   * @param list 対象文字列
+   * @param value 探索文字列
+   * @return true: 含まれる、false: 含まれない
    *
    * @else
    * @brief Include if a string is included in string list
@@ -447,16 +485,18 @@
   
   /*!
    * @if jp
-   * @brief Í¿¤¨¤é¤E¿Ê¸»úÎó¤¬ÀäÂХѥ¹¤«¤É¤¦¤«¤òȽÃǤ¹¤E   *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤¬ÀäÂХѥ¹É½¸½¤Ç¤¢¤E«¤É¤¦¤«¤òȽÃǤ¹¤E£
-   * ʸ»úÎ󤬰ʲ¼¤Î¾Eç¤Ë¤ÏÀäÂХѥ¹¤È¤·¤ÆȽÃǤ¹¤E£
-   *  - ÀèƬʸ»ú¤¬'/' (UNIX¤Î¾EE
-   *  - ÀèƬ£³Ê¸»ú¤¬¥¢¥EÕ¥¡¥Ù¥Ã¥È¡Ü'/'¡Ü'\\' (Windows¤Î¾EE
-   *  - ÀèƬ£²Ê¸»ú¤¬'\\\\' (Windows¥Í¥Ã¥È¥E¼¥¯¥Ñ¥¹¤Î¾EE
+   * @brief 与えられた文字列が絶対パスかどうかを判断する
    *
-   * @param str ȽāEоÝʸ»ú΁E   *
-   * @return ÀäÂХѥ¹È½ÄEEÌ
+   * 与えられた文字列が絶対パス表現であるかどうかを判断する。
+   * 文字列が以下の場合には絶対パスとして判断する。
+   *  - 先頭文字が'/' (UNIXの場合)
+   *  - 先頭3文字がアルファベット+'/'+'\\' (Windowsの場合)
+   *  - 先頭2文字が'\\\\' (Windowsネットワークパスの場合)
    *
+   * @param str 判定対象文字列
+   *
+   * @return 絶対パス判定結果
+   *
    * @else
    * @brief Investigate whether the given string is absolute path or not
    *
@@ -476,14 +516,16 @@
   
   /*!
    * @if jp
-   * @brief Í¿¤¨¤é¤E¿Ê¸»úÎó¤¬URL¤«¤É¤¦¤«¤òȽÃǤ¹¤E   *
-   * Í¿¤¨¤é¤E¿Ê¸»úÎó¤¬URLɽ¸½¤«¤É¤¦¤«¤òȽÃǤ¹¤E£
-   * Í¿¤¨¤é¤E¿Ê¸»úÎóÃæ¤Ë¡¢'://'¤È¤¤¤¦Ê¸»úÎ󤬴ޤޤEƤ¤¤EEç¤Ë¤Ï
-   * URLɽ¸½¤È¤·¤ÆȽÃǤ¹¤E£
+   * @brief 与えられた文字列がURLかどうかを判断する
    *
-   * @param str ȽāEоÝʸ»ú΁E   *
-   * @return URLȽāEEÌ
+   * 与えられた文字列がURL表現かどうかを判断する。
+   * 与えられた文字列中に、'://'という文字列が含まれている場合には
+   * URL表現として判断する。
    *
+   * @param str 判定対象文字列
+   *
+   * @return URL判定結果
+   *
    * @else
    * @brief Investigate whether the given string is URL or not
    *
@@ -501,13 +543,13 @@
   
   /*!
    * @if jp
-   * @brief Í¿¤¨¤é¤E¿¥ª¥Ö¥¸¥§¥¯¥È¤òstd::string¤ËÊÑ´¹
+   * @brief 与えられたオブジェクトをstd::stringに変換
    *
-   * °ú¿ô¤Ç»ØÄꤵ¤E¿¥ª¥Ö¥¸¥§¥¯¥È¤òʸ»úÎó¤ËÊÑ´¹¤¹¤E£
+   * 引数で指定されたオブジェクトを文字列に変換する。
    *
    * @param n 変換対象オブジェクト
    *
-   * @return ʸ»úÎóÊÑ´¹·EÌ
+   * @return 文字列変換結果
    *
    * @else
    * @brief Convert the given object to std::string
@@ -530,14 +572,15 @@
   
   /*!
    * @if jp
-   * @brief Í¿¤¨¤é¤E¿std::string¤ò¥ª¥Ö¥¸¥§¥¯¥È¤ËÊÑ´¹
+   * @brief 与えられたstd::stringをオブジェクトに変換
    *
-   * °ú¿ô¤ÇÍ¿¤¨¤é¤E¿Ê¸»úÎó¤ò»ØÄꤵ¤E¿¥ª¥Ö¥¸¥§¥¯¥È¤ËÊÑ´¹¤¹¤E£
+   * 引数で与えられた文字列を指定されたオブジェクトに変換する。
    *
    * @param val 変換先オブジェクト
-   * @param str ÊÑ´¹¸µÊ¸»ú΁E   *
-   * @return true: À®¸E false: ¼ºÇÔ
+   * @param str 変換元文字列
    *
+   * @return true: 成功, false: 失敗
+   *
    * @else
    * @brief Convert the given std::string to object.
    *
@@ -563,13 +606,15 @@
   
   /*!
    * @if jp
-   * @brief Í¿¤¨¤é¤E¿Ê¸»úÎó¤òstd::string¤ËÊÑ´¹
+   * @brief 与えられた文字列をstd::stringに変換
    *
-   * °ú¿ô¤ÇÍ¿¤¨¤é¤E¿Ê¸»úÎó¤òstd::string¤ËÊÑ´¹¤¹¤E£
+   * 引数で与えられた文字列をstd::stringに変換する。
    *
-   * @param val ÊÑ´¹Àèʸ»ú΁E   * @param str ÊÑ´¹¸µÊ¸»ú΁E   *
-   * @return true: À®¸E false: ¼ºÇÔ
+   * @param val 変換先文字列
+   * @param str 変換元文字列
    *
+   * @return true: 成功, false: 失敗
+   *
    * @else
    * @brief Convert the given string to std::string.
    *
@@ -587,13 +632,14 @@
 
   /*!
    * @if jp
-   * @brief Í¿¤¨¤é¤E¿Ê¸»úÎó¥E¹¥È¤«¤é½ÅÊ£¤òºEE   *
-   * °ú¿ô¤ÇÍ¿¤¨¤é¤E¿Ê¸»úÎó¥E¹¥È¤«¤é½ÅÊ£¤òºEE·¤¿¥E¹¥È¤òºûÜ®¤¹¤E£
+   * @brief 与えられた文字列リストから重複を削除
    *
-   * @param sv ³Îǧ¸µÊ¸»úÎó¥E¹¥È
+   * 引数で与えられた文字列リストから重複を削除したリストを作成する。
    *
-   * @return ½ÅÊ£ºEEèÍý·EÌ¥E¹¥È
+   * @param sv 確認元文字列リスト
    *
+   * @return 重複削除処理結果リスト
+   *
    * @else
    * @brief Eliminate duplication from the given string list
    *
@@ -610,14 +656,15 @@
   
   /*!
    * @if jp
-   * @brief Í¿¤¨¤é¤E¿Ê¸»úÎó¥E¹¥È¤«¤éCSV¤òÀ¸À®
+   * @brief 与えられた文字列リストからCSVを生成
    *
-   * °ú¿ô¤ÇÍ¿¤¨¤é¤E¿Ê¸»úÎó¥E¹¥È¤Î³ÆÍ×ÁǤòʤ٤¿CSV¤òÀ¸À®¤¹¤E£
-   * ʸ»úÎó¥E¹¥È¤¬¶õ¤Î¾Eç¤Ë¤Ï¶õÇòʸ»ú¤òÊÖ¤¹¡£
+   * 引数で与えられた文字列リストの各要素を並べたCSVを生成する。
+   * 文字列リストが空の場合には空白文字を返す。
    *
-   * @param sv CSVÊÑ´¹ÂоÝʸ»úÎó¥E¹¥È
+   * @param sv CSV変換対象文字列リスト
    *
-   * @return CSVÊÑ´¹·EÌʸ»ú΁E   *
+   * @return CSV変換結果文字列
+   *
    * @else
    * @brief Create CSV file from the given string list
    *
@@ -635,14 +682,15 @@
   
   /*!
    * @if jp
-   * @brief Í¿¤¨¤é¤E¿Ê¸»úÎó¥E¹¥È¤ò°ú¿ô¥E¹¥È¤ËÊÑ´¹
+   * @brief 与えられた文字列リストを引数リストに変換
    *
-   * °ú¿ô¤ÇÍ¿¤¨¤é¤E¿Ê¸»úÎó¥E¹¥È¤Î³ÆÍ×ÁÇËöÈø¤Ë'\\0'¤ò²Ã¤¨¡¢°ú¿ô¥E¹¥È
-   * ¤ËÊÑ´¹¤¹¤E£
+   * 引数で与えられた文字列リストの各要素末尾に'\\0'を加え、引数リスト
+   * に変換する。
    *
-   * @param args ÊÑ´¹ÂоÝʸ»úÎó¥E¹¥È
+   * @param args 変換対象文字列リスト
    *
-   * @return °ú¿ôÊÑ´¹·EÌʸ»ú΁E   *
+   * @return 引数変換結果文字列
+   *
    * @else
    * @brief Convert the given string list into the argument list
    *
@@ -660,13 +708,14 @@
 
   /*!
    * @if jp
-   * @brief »ØÄꤵ¤E¿½ñ¼°¤ËÊÑ´¹
+   * @brief 指定された書式に変換
    *
-   * °ú¿ô¤ÇÍ¿¤¨¤é¤E¿½ñ¼°¤ËÊÑ´¹¤·¤ÆÊÖ¤¹¡£
+   * 引数で与えられた書式に変換して返す。
    *
    * @param fmt 書式
    *
-   * @return ÊÑ´¹·EÌʸ»ú΁E   *
+   * @return 変換結果文字列
+   *
    * @else
    * @brief Convert it into a format given with an argumen
    *
@@ -678,3 +727,7 @@
    *
    * @endif
    */
+  std::string sprintf(char const * __restrict fmt, ...);
+  
+}; // namepsace coil
+#endif // COIL_STRINGUTIL_H



More information about the openrtm-commit mailing list