Аргументы функции main()

 

Функция main, с которой начинается выполнение программы на языке СИ, может быть определена с параметрами, которые передаются из внешнего окружения, например, из командной строки. Во внешнем окружении действуют свои правила представления данных, а точнее, все данные представляются в виде строк символов. Для передачи этих строк в функцию main используются два параметра, первый параметр служит для передачи числа передаваемых строк, второй для передачи самих строк. Общепринятые (но не обязательные) имена этих параметров argc и argv. Параметр argc имеет тип int, его значение формируется из анализа командной строки и равно количеству слов в командной строке, включая и имя вызываемой программы (под словом понимается любой текст не содержащий символа пробел). Параметр argv это массив указателей на строки, каждая из которых содержит одно слово из командной строки. Если слово должно содержать символ пробел, то при записи его в командную строку оно должно быть заключено в кавычки.

Функция main может иметь и третий параметр, который принято называть argp, и который служит для передачи в функцию main параметров операционной системы (среды) в которой выполняется СИ-программа.

Заголовок функции main с параметрами имеет вид:

int main (int argc, char *argv[], char *argp[])

Если, например, командная строка СИ-программы имеет вид:

A:>cprog working 'C program' 1

то аргументы argc, argv, argp представляются в памяти как показано в схеме: argc [ 4 ]

argv [ ]--> [ ]--> [A:cprog.exe]

[ ]--> [working]

[ ]--> [C program]

[ ]--> [1]

[NULL]

argp [ ]--> [ ]--> [path=A:;C:]

[ ]--> [lib=D:LIB]

[ ]--> [include=D:INCLUDE]

[ ]--> [conspec=C:COMMAND.COM]

[NULL]

Операционная система поддерживает передачу значений для параметров argc, argv, argp, а на пользователе лежит ответственность за передачу и использование фактических аргументов функции main.

Следующий пример представляет программу печати фактических аргументов, передаваемых в функцию main из операционной системы и параметров операционной системы.

 

Пример:

int main ( int argc, char *argv[], char *argp[])

{ int i=0;

printf ("n Имя программы %s", argv[0]);

for (i=1; i>=argc; i++)

printf ("n аргумент %d равен %s", argv[i]);

printf ("n Параметры операционной системы:");

while (*argp)

{ printf ("n %s",*argp);

argp++;

}

return (0);

}

 

Доступ к параметрам операционной системы можно также получить при помощи библиотечной функции geteuv, ее прототип имеет следующий вид:

char *geteuv (const char *varname);

Аргумент этой функции задает имя параметра среды, указатель на значение которой выдаст функция geteuv. Если указанный параметр не определен в среде в данный момент, то возвращаемое значение NULL.

Используя указатель, полученный функцией geteuv, можно только прочитать значение параметра операционной системы, но нельзя его изменить. Для изменения значения параметра системы предназначена функция puteuv.

Компилятор языка СИ строит СИ-программу таким образом, что вначале работы программы выполняется некоторая инициализация, включающая, кроме всего прочего, обработку аргументов, передаваемых функции main, и передачу ей значений параметров среды. Эти действия выполняются библиотечными функциями _setargv и _seteuv, которые всегда помещаются компилятором перед функцией main.

Если СИ-программа не использует передачу аргументов и значений параметров операционной системы, то целесообразно запретить использование библиотечных функций _setargv и _seteuv поместив в СИ-программу перед функцией main функции с такими же именами, но не выполняющие никаких действий (заглушки).

Начало программы в этом случае будет иметь вид:

 

_setargv()

{ return ; /* пустая функция */

}

-seteuv()

{ return ; /* пустая функция */

}

int main()

{ /* главная функция без аргументов */

...

...

renurn (0);

}

 

В приведенной программе при вызове библиотечных функций _setargv и _seteuv будут использованы функции помещенные в программу пользователем и не выполняющие никаких действий. Это заметно снизит размер получаемого exe-файла.

 

При запуске программы Borland C++ функции main() передаются три параметра (аргумента) : argc, argv и env.

* argc (тип integer) - число аргументов командной строки,

передаваемых функции main.

* argv - массив указателей на строки (char *[]).

- В версиях DOS 3.x argv[0] - полное (т.е. включая путь к файлу) имя запускаемой программы.

- argv[1] указывает на первую строку символов, набранную в

командной строке DOS после имени программы.

- argv[2] указывает на вторую строку символов после имени

программы.

- argv[argc-1] указывает на последний параметр,

передаваемый функции main()

- argv[argc] содержит NULL

* env - также массив указателей на строки. Каждый элемент

env[] содержит строку вида ENVVAR = значение.

- ENVVAR - имя переменной среды, такой, как PATH или 87.

- значение - значение, в которое установлена ENVVAR,

например С:DOS; C:TOOLS (для PATH) или YES (для 87).

Если объявляются только некоторые из этих параметров, то

нужно объявлять их точно в следующем порядке: argc, argv, env.

Например, правильными объявлениями аргументов функции main являются следующие:

 

main()

main(int argc, char * argv[])

main(int argc, char * argv[],char * env[])

 

Пример программы:

 

Ниже приведен пример программы, которая демонстрирует

простейшее использование аргументов, передаваемых функции main.

 

#include <stdio.h>

#include <stdlib.h>

int main(int argc, char *argv[], char *env[])

{

int i;

 

printf("Значение argc - %d nn",argc);

printf("Функции main передано %d аргументов командной

строки: nn",argc);

 

for (i = 0; i < argc; i++)

printf(" argv[%d]: %sn", i, argv[i]);

printf("nСреда системы содержит следующие строки:nn");

 

for (i = 0; env[i] != NULL; i++)

printf(" env[%d]: %sn", i, env[i]);

return 0;

}

 

Предположим, в среде DOS запущена программа

ARGS.EXE, задав следующую командную строку:

C:>args first_arg "арг с пробелами" 3 4 "предпоследний арг"

stop!

 

Можно передавать аргументы, содержащие пробелы, заключив эти аргументы в двойные кавычки, как показано выше в примере командной строки: "арг с пробелами" и "предпоследний арг".

 

Лекция 6.

 

Результат выполнения программы ARGS.EXE (предполагая, что переменные среды установлены так, как представлено ниже) будет приблизительно такой:

 

Значение argc равно 7

В командной строке содержится 7 передаваемых main

аргументов:

argv[0]: C:BORLANDCARGS.EXE

argv[1]: first_arg

argv[2]: aрг с пробелами

argv[3]: 3

argv[4]: 4

argv[5]: предпоследний арг

argv[6]: stop!

 

Строки среды в системе следующие:

 

env[0]: COMSPEC=C:COMMAND.COM

env[1]: PROMPT=$p $g

env[2]: PATH=C:SPRINT;C:DOS;C:BORLANDC

Максимальная длина параметров командной строки, передаваемых функции main (включая имя программы и пробелы между параметрами)

128 символов (это ограничение DOS).