# mkdir

создаёт новую директорию

## Последовательность вызова

                mkdir(dirname)
                mkdir(parentdir, dirname)
                status = mkdir( ... )
                [status, msg] = mkdir( ... )

## Аргументы

dirname

  символьная строка: имя директории, которую требуется создать.

parentdir

  символьная строка: имя директории в которой будет создана новая директория `dirname`.

status

  целое число: статус работы.

msg

  символьная строка: сообщение об ошибке.

## Описание

Инструкция `mkdir(dirname)` создаёт директорию `dirname` в текущей директории, если `dirname` представляет относительный путь. Иначе, `dirname` представляет абсолютный путь и функция `mkdir` пытается создать директорию с абсолютным именем `dirname`.

Инструкция `mkdir(parentdir, dirname)` создаёт директорию `dirname` в директории `parentdir` (если `parentdir` не существует, то она будет создана), где `parentdir` -- абсолютное или относительное имя.

Инструкция `[status,msg] = mkdir(parentdir, dirname)` создаёт директорию `dirname` в существующей директории `parentdir`, возвращая статус работы `status` и сообщение об ошибке `msg`.

`status` | `msg`
-2 | mkdir: Произошла ошибка: Файл с таким именем уже существует в dirname
0 | mkdir: Произошла ошибка: Невозможно создать каталог dirname
1 |
2 | mkdir: Произошла ошибка: Этот каталог уже существует в dirname

В любой операционной системе, если создание директории удалось, то статус `status` равен 1, а сообщение `msg` пустое.

## Примеры

    // Абсолютное имя пути
    mkdir(TMPDIR+"/mkdir_example_1")
    status_2 = mkdir(TMPDIR+"/mkdir_example_2")
    [status_3,msg_3] = mkdir(TMPDIR+"/mkdir_example_3")

    // Абсолютное имя пути (parentdir + dirname)
    [status_4,msg_4] = mkdir(TMPDIR,"mkdir_example_4")

    // Относительное имя пути
    cd TMPDIR;
    [status_5,msg_5] = mkdir("mkdir_example_5")
    [status_6,msg_6] = mkdir("mkdir_example_5/mkdir_example_6")

## Смотрите также

- chdir
- dir
- rmdir