4.39 _sys_command_string()

rt_sys.h で定義される _sys_command_string() 関数は、現在のアプリケーションを呼び出した環境から、そのアプリケーションを呼び出したコマンドラインを取得します。

構文

char *_sys_command_string(char *cmd, int len);
各項目には以下の意味があります。
cmd
コマンドラインを保存できるバッファを指すポインタです。コマンドラインを cmd に保存する必要はありません。
len
バッファの長さです。

使用法

この関数がライブラリ起動コードによって呼び出されることで、argvargc が設定され、main() に渡されます。

この関数が呼び出されるときに、C ライブラリが完全に初期化されていると想定しないで下さい。例えば、この関数内から malloc() を呼び出してはいけません。これは、C ライブラリの起動シーケンスによって、ヒープが完全に設定される前にこの関数が呼び出されるからです。

戻り値

この関数は以下のいずれかの値を返す必要があります。
  • 正常に実行された場合は、コマンドラインを指すポインタが返されます。このポインタは、cmd バッファを指すポインタ(バッファが使用されている場合)、またはコマンドラインが保存される他の場所を指すポインタとなります。
  • 実行に失敗した場合は NULL が返されます。
関連する参考文書
1.29 C ライブラリ関数の直接セミホスティング依存関数
非機密扱いPDF file icon PDF 版ARM DUI0475KJ
Copyright © 2010-2014 ARM.All rights reserved.