DM Guide 17 - История изменений

Architect of fates: Откат правок ZLOFENIХ (обсуждение) к версии Michael Shepard

2016-12-12T22:12:54Z

Откат правок ZLOFENIХ (обсуждение) к версии Michael Shepard

Внесённые изменения

ZLOFENIХ: clean up, removed: ''Это 17-ая глава перевода оригинального руководства по Dream Maker от разработчиков.'' (174)

2016-12-12T21:04:33Z

clean up, removed: ''Это 17-ая глава перевода оригинального руководства по Dream Maker от разработчиков.'' (174)

Внесённые изменения

Michael Shepard: Откат правок Inaf (обсуждение) к версии Eversor

2016-01-28T17:43:24Z

Откат правок Inaf (обсуждение) к версии Eversor

Inaf: TODO:1. Решить, нужна ли эта страница на вики и выпилить, если не нужна. 2. Актуализировать информацию 3. Поправить стиль и грамматику 3.Добавит…

2016-01-28T14:28:28Z

TODO:1. Решить, нужна ли эта страница на вики и выпилить, если не нужна. 2. Актуализировать информацию 3. Поправить стиль и грамматику 3.Добавит…

Inaf: TODO:1. Решить, нужна ли эта страница на вики и выпилить, если не нужна. 2. Актуализировать информацию 3. Поправить стиль и грамматику 3.Добавит…

2016-01-28T14:28:11Z

Eversor: Закончил перевод

2015-04-19T06:56:55Z

Закончил перевод

Eversor: Немного перевода

2015-04-18T18:51:30Z

Немного перевода

Внесённые изменения

Eversor: Продолжаю переводить

2015-04-17T20:18:33Z

Продолжаю переводить

Новая страница

''Это 17-ая глава перевода оригинального руководства по Dream Maker от разработчиков.''

[http://wiki.ss13.ru/index.php?title=All_about_the_code Остальные главы руководства и статьи о программировании на коде BYOND от любителей на русском.]

[http://http://www.byond.com/docs/guide/chap17.html Оригинальная 17-ая глава руководства на английском языке]
{{Заготовка|url="[http://www.byond.com/docs/guide/chap17.html ]"}}

==Глава 17: Контроль сервера и системы==

All creatures pass into My nature at the end of a cycle and are reborn at the beginning of creation.

--Bhagavat Gita

Все ранее рассмотренные аспекты DM представляли собой операции, выполняемые в изолированной области игрового мира. В этой главе рассматриваются команды, позволяющие взаимодействовать с остальной частью компьютера, включая доступ к файлам, программам и другим мирам BYOND’а.

===Замечание о платформо-независимости===

Программисты называют ''платформой'' операционную систему, запущенную на компьютере. На данный момент, BYOND может быть запущен на операционных системах Microsoft Windows и UNIX. Версии для других ОС находятся в разработке.

Когда возможно, лучше писать т.н. ''платформо-независимые'' программы, это означает, что программа будет работать одинаково на разных системах. Язык DM практически гарантирует это, предоставляя синтаксис, как можно меньше опирающийся на особенности внешней вычислительной среды. Фактически, BYOND во многих случая ведет себя как виртуальная операционная система, изолируя ваш код от реальной операционной системы, и тем самым обеспечивает одинаковую среду независимо от машины, на которой он запущен.

Однако когда возникает задача получения доступа к файлам или другим программам компьютера, зависимость от платформы становится необходимой. Например, названия файлов в UNIX регистрозависимы, в то время как в Windows наоборот. Это означает, что при указании имени файла в Windows вы можете обойтись любой комбинацией строчных и прописных букв, в то время как тот же код, запущенный под UNIX сработает только при полном совпадении регистра в имени файла. Поэтому хорошей привычкой будет, по крайней мере, быть последовательным и использовать одинаковый регистр во всем вашем коде, когда ссылаешься на один файл.

Пути к фалам соответствуют текущей директории (если не задан полный путь). Текущей всегда является директория, в которой расположен .dmb файл мира. В UNIX системах в пути после каждой поддиректории ставится знак / . Обычно в Windows для этой цели используется знак \ , однако, DM позволяет использовать вместо него / . Это удобнее, потому, что так он не рассматривается как спецсимвол в текстовой строке.

===shell===

''shell'' передает команду операционной системе. Интерпретатор команд часто называют shell - отсюда и название для этой инструкции. Это спящая операция, которая возвращает значение после ее окончания.

{| border="0"
|-
| shell
| (Cmd)
|-
|
| Cmd – текст команды.
|-
|
| Возвращает статус завершения команды Returns the exit status of the command.
|}

Синтаксис команды, очевидно, полностью зависит от операционной системы. Как правило, она состоит из имени программы и следующего за ним ряда аргументов. Если команда создает вывод (output) или ожидает ввода (input), вам нужно перенаправить ввод и вывод в файлы, что в UNIX и Windows делается при помощи операторов < и > .

В нижеследующем примере запускается команда "dir" и выводится результат.

mob/verb/list_files()
shell("dir > dir.txt")
usr << browse("dir.txt")

===Операции с файлами===

==== file2text====

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

{| border="0"
|-
| file2text
| (File)
|-
|
| File – имя файла.
|-
|
| Возвращает содержимое файла в виде текстовой строки.
|}

====text2file====

''text2file'' instruction is the complement of file2text. It appends a text string to a file. If the file does not exist, it will be created.

{| border="0"
|-
| text2file
| (Txt,File)
|-
|
| Txt is the text string.
|-
|
| File is the file to append to.
|}

====file====
''file'' instruction returns a reference to a file object. The primary use for such an object is with the input/output operators. Outputting a file to a player was discussed in section 11.2.7. It is also possible to send output to a file or get input from a file.

{| border="0"
|-
| file
| (Path)
|-
|
| Path is the name of the file.
|-
|
| Returns a reference to the file.
|}

Using a file as the target for output of the << operator has the same effect as calling ''text2file()''. The output value is appended to the file. Similarly, reading input from a file with the >> operator is the same as ''file2text()''. The file is loaded into a text string and stored in the specified variable.

{| border="0"
|-
| File << Output
|-
| File >> Variable
|}

====fcopy====

''fcopy'' instruction copies one file to another. The source file may be a real external file or a file in the cache. If the destination file already exists, it will be replaced.

{| border="0"
|-
| fcopy
| (Source,Dest)
|-
|
| Source is the source file.
|-
|
| Dest is the destination file.
|-
|
| Returns 1 on success and 0 on failure.
|}

====fdel====

''fdel'' instruction deletes a file from the file system.

{| border="0"
|-
| fdel
| (File)
|-
|
| File is the name of the file.
|-
|
| Returns 1 on success and 0 on failure.
|}

It works with entire directories too (so be careful for heaven's sake). As a precaution, it only accepts directory names when you end them with a slash "/".

====flist====

''flist'' instruction generates a list of files at the specified path in the file system and whose names begin in the specified way.

{| border="0"
|-
| flist
| (Path)
|-
|
| Path is the path to get the listing of.
|-
|
| Returns a list of files and sub-directories.
|}

Only files and sub-directories directly contained in the specified path are listed (i.e. not the contents of the sub-directories too). The file names in the list do not contain the path information but just the bare file name. Sub-directories in the list are identified by a trailing "/" appended to the name.

The format of the path is "dir1/dir2/.../file". Only files matching "file" are listed, so be sure to append a "/" to the end of a directory name if you wish to see its contents. Otherwise, all you will get is the directory name back with a "/" appended.

===Running other Worlds===

It is sometimes desirable for one master world to launch child worlds. For example, you might have a main world with side-adventures (dungeons etc.) taking place in separate sub-worlds. This might be more efficient since areas that are rarely used could be activated only when needed.

The ultimate use of this technique is a world hosting service which allows users to upload their own world files. These are then launched and shut down as they are accessed by players. If you do not have your own dedicated network connection, you may wish to make use of such a service to host your worlds.

====startup====

''startup'' instruction runs another world. It sleeps until the network address of the new world has been determined.

{| border="0"
|-
| startup
| (File,Port=0,Options,...)
|-
|
| File is the dmb file to run.
|-
|
| Port is the network port to use.
|-
|
| Options includes any additional parameters.
|-
|
| Returns network address of the new world.
|}

The network address of a world includes two parts. The first is the IP address of the machine it is running on. The second is the port number. These are combined in a text string of the form "ip:port". The port specified must not be in use by any other programs. The default value of zero indicates that any available port should be used.

The additional options that may be specified are described in the following list.

*'''-once''' This option automatically shuts down the server when all players have logged off.

*'''-log''' This option takes an additional argument which is used as the server's output file. All debugging notices (from proc crashes) and any output sent to world.log is appended to this file. The path to the file is relative to the new server's working directory, which is the location of the .dmb file.

*'''-safe''' This option runs the world in a special protective security mode. The world code may only access files in the same directory (or below) as the .dmb file and access to the ''shell'' instruction is disabled. This is the default mode if the world is run from its own safe directory. Such a directory is recognized when it has the same name as the world .dmb file (напр. inferno/inferno.dmb).

*'''-ultrasafe''' This is the same as ''-safe'' except only access to temporary files is allowed. This is the default if the world is not run from its own safe directory.

*'''-trusted''' In this mode, all operations are permitted. The world may access files in any directory and may run ''shell'' commands. Of course the operating system may apply restrictions, but BYOND will allow the world to try anything.

*'''-params''' The following argument is interpreted as a parameter string as described in [DM_Guide_10|section]. The variable ''world.params'' is initialized from this data. You may use ''params'' multiple times; the individual parameter strings are simply concatenated to form the final result.
*'''-quiet''' This simply disables informational output that the server normally displays when it boots up.

====Control over Child Worlds====

Communication with a child world may be done through ''world.Export()''. In this case, the child world's ''world.Topic()'' procedure is called with a special master flag to indicate that the message came from the world which started it. (See [DM_Guide_8|section] for a review of these procs.)
By default, a child world will respond to the special topics "Del" and "Reboot" by calling ''world.Del()'' and ''world.Reboot()'' respectively. This is only done if the message comes from the master world, since otherwise anyone could send the message and shut your world down.
Another useful topic is "ping", which can be used to determine if a child world is still alive and running.

====shutdown====

''shutdown'' instruction may be used to close a child world or to wait for it to exit normally.

{| border="0"
|-
| shutdown
| (Address,Natural=0)
|-
|
| Address is the network address of the world.
|-
|
| Natural is 1 to suppress sending of "Del" message.
|-
|
| Returns exit status of the child world.
|}

The address should be the same text string returned by ''startup()''. If the second argument is omitted or zero, this is equivalent to calling ''world.Export()'' with the given address and "Del" as the topic. Otherwise, this instruction simply waits for the child world to die naturally of its own accord.

With no arguments at all, this instruction causes the current world to shut down. The same thing can be achieved by calling ''world.Del()''.

@@ Строка 1: / Строка 1: @@
 ''Это 17-ая глава перевода оригинального руководства по Dream Maker от разработчиков.''
-[[All about the code|Остальные главы руководства и статьи о программировании на коде BYOND от любителей на русском.]]
+[[All_about_the_code|Остальные главы руководства и статьи о программировании на коде BYOND от любителей на русском.]]
 [http://www.byond.com/docs/guide/chap17.html Оригинальная 17-ая глава руководства на английском языке]
@@ Строка 86: / Строка 82: @@
 ====file====
-''file'' возвращает ссылку на файл. В основном эта инструкция применяется с операторами ввода/вывода. Вывод файла игроку был обсужден [[DM Guide 11|в главе 11]]. Кроме того, можно отправлять вывод в файл или получать ввод из файла.
+''file'' возвращает ссылку на файл. В основном эта инструкция применяется с операторами ввода/вывода. Вывод файла игроку был обсужден [[DM_Guide_11|в главе 11]]. Кроме того, можно отправлять вывод в файл или получать ввод из файла.
 {| border="0"
@@ Строка 207: / Строка 203: @@
 *'''-trusted''' В этом моде все операции разрешены. Мир может получать доступ к файлам в любых каталогах и командам ''shell''. Конечно, операционная система может налагать ограничения, но BYOND будет разрешать миру всё.
-*'''-params''' Данный аргумент интерпретируется как строка параметра, что уже было описано в [[DM Guide 10|10-ой главе]]. Переменная ''world.params'' инициализируется из этих данных. Вы можете использовать ''params'' несколько раз; отдельные строки параметров, просто объединяются для формирования окончательного результата.
+*'''-params''' Данный аргумент интерпретируется как строка параметра, что уже было описано в [[DM_Guide_10|10-ой главе]]. Переменная ''world.params'' инициализируется из этих данных. Вы можете использовать ''params'' несколько раз; отдельные строки параметров, просто объединяются для формирования окончательного результата.
 *'''-quiet''' Это просто отключает информационный вывод, который сервер обычно отображает при загрузке.
@@ Строка 213: / Строка 209: @@
 ====Контроль Дочерних Миров====
-Связь с дочерним миром может быть осуществлена с помощью ''world.Export ()''. В этом случае, процедура ''world.Topic()'' вызывается со специальным флагом, чтобы указать, что сообщение пришло из мира, который его запустил. (см. [[DM Guide 8|8-ую главу]]) По умолчанию, дочерний мир будет реагировать на спецальные команды "Del" и "Reboot" вызовом ''world.Del ()'' и ''world.Reboot ()'' соответственно. Это происходит только если приходит сообщение от главного мира, так как в противном случае кто угодно может отправить сообщение и прекратить работу вашего мира.
+Связь с дочерним миром может быть осуществлена с помощью ''world.Export ()''. В этом случае, процедура ''world.Topic()'' вызывается со специальным флагом, чтобы указать, что сообщение пришло из мира, который его запустил. (см. [[DM_Guide_8 | 8-ую главу]]) По умолчанию, дочерний мир будет реагировать на спецальные команды "Del" и "Reboot" вызовом ''world.Del ()'' и ''world.Reboot ()'' соответственно. Это происходит только если приходит сообщение от главного мира, так как в противном случае кто угодно может отправить сообщение и прекратить работу вашего мира.
 Есть еще одна полезная команда "ping", которая может быть использована для определения, работает ли еще дочерний мир.

← Предыдущая версия		Версия от 14:28, 28 января 2016
Строка 1:		Строка 1:
		+	{{Заготовка}}
		+
	{{Заготовка}}		{{Заготовка}}

@@ Строка 1: / Строка 1: @@
 ''Это 17-ая глава перевода оригинального руководства по Dream Maker от разработчиков.''
-[[All_about_the_code|Остальные главы руководства и статьи о программировании на коде BYOND от любителей на русском.]]
+[[All about the code|Остальные главы руководства и статьи о программировании на коде BYOND от любителей на русском.]]
 [http://www.byond.com/docs/guide/chap17.html Оригинальная 17-ая глава руководства на английском языке]
@@ Строка 82: / Строка 84: @@
 ====file====
-''file'' возвращает ссылку на файл. В основном эта инструкция применяется с операторами ввода/вывода. Вывод файла игроку был обсужден [[DM_Guide_11|в главе 11]]. Кроме того, можно отправлять вывод в файл или получать ввод из файла.
+''file'' возвращает ссылку на файл. В основном эта инструкция применяется с операторами ввода/вывода. Вывод файла игроку был обсужден [[DM Guide 11|в главе 11]]. Кроме того, можно отправлять вывод в файл или получать ввод из файла.
 {| border="0"
@@ Строка 203: / Строка 205: @@
 *'''-trusted''' В этом моде все операции разрешены. Мир может получать доступ к файлам в любых каталогах и командам ''shell''. Конечно, операционная система может налагать ограничения, но BYOND будет разрешать миру всё.
-*'''-params''' Данный аргумент интерпретируется как строка параметра, что уже было описано в [[DM_Guide_10|10-ой главе]]. Переменная ''world.params'' инициализируется из этих данных. Вы можете использовать ''params'' несколько раз; отдельные строки параметров, просто объединяются для формирования окончательного результата.
+*'''-params''' Данный аргумент интерпретируется как строка параметра, что уже было описано в [[DM Guide 10|10-ой главе]]. Переменная ''world.params'' инициализируется из этих данных. Вы можете использовать ''params'' несколько раз; отдельные строки параметров, просто объединяются для формирования окончательного результата.
 *'''-quiet''' Это просто отключает информационный вывод, который сервер обычно отображает при загрузке.
@@ Строка 209: / Строка 211: @@
 ====Контроль Дочерних Миров====
-Связь с дочерним миром может быть осуществлена с помощью ''world.Export ()''. В этом случае, процедура ''world.Topic()'' вызывается со специальным флагом, чтобы указать, что сообщение пришло из мира, который его запустил. (см. [[DM_Guide_8 | 8-ую главу]]) По умолчанию, дочерний мир будет реагировать на спецальные команды "Del" и "Reboot" вызовом ''world.Del ()'' и ''world.Reboot ()'' соответственно. Это происходит только если приходит сообщение от главного мира, так как в противном случае кто угодно может отправить сообщение и прекратить работу вашего мира.
+Связь с дочерним миром может быть осуществлена с помощью ''world.Export ()''. В этом случае, процедура ''world.Topic()'' вызывается со специальным флагом, чтобы указать, что сообщение пришло из мира, который его запустил. (см. [[DM Guide 8|8-ую главу]]) По умолчанию, дочерний мир будет реагировать на спецальные команды "Del" и "Reboot" вызовом ''world.Del ()'' и ''world.Reboot ()'' соответственно. Это происходит только если приходит сообщение от главного мира, так как в противном случае кто угодно может отправить сообщение и прекратить работу вашего мира.
 Есть еще одна полезная команда "ping", которая может быть использована для определения, работает ли еще дочерний мир.

@@ Строка 4: / Строка 4: @@
 [http://www.byond.com/docs/guide/chap17.html Оригинальная 17-ая глава руководства на английском языке]
 ==Глава 17: Контроль сервера и системы==
@@ Строка 196: / Строка 195: @@
 *'''-once''' Эта опция автоматически выключает сервер, когда все игроки отключатся.
-*'''-log''' This option takes an additional argument which is used as the server's output file. All debugging notices (from proc crashes) and any output sent to world.log is appended to this file. The path to the file is relative to the new server's working directory, which is the location of the .dmb file.
+*'''-log''' Эта опция требует наличие дополнительного аргумента, который используется для файла вывода сервера. Все отладочные заметки (от крашей действий proc) и весь вывод, записываемый в world.log, будет добавляться в этот файл. Путь до этого файла соответствует рабочей директории сервера, которая расположена в папке с .dmb файлом.
-*'''-safe''' Эта опция запускает мир в специальном защищенном режиме. Код мира сможет иметь доступ только к файлам в той же директории (и поддиректориях), в которой находится .dmb, а доступ к инструкции ''shell'' запрещен. Это стандартный режим, если мир запускается из его собственной безопасной директории. Such a directory is recognized when it has the same name as the world .dmb file (напр. inferno/inferno.dmb).
+*'''-safe''' Эта опция запускает мир в специальном защищенном режиме. Код мира сможет иметь доступ только к файлам в той же директории (и поддиректориях), в которой находится .dmb, а доступ к инструкции ''shell'' запрещен. Это стандартный режим, если мир запускается из его собственной безопасной директории. Такая директория распознается, когда она имеет то же имя, что и .dmb файл мира.
-*'''-ultrasafe''' Эта опция аналогична ''-safe'', за исключениям того что разрешает доступ только ко временным файлам. Это стандартный режим, если мир не запускается из его собственной безопасной директории.
+*'''-ultrasafe''' Эта опция аналогична ''-safe'', за исключением того что разрешает доступ только к временным файлам. Это стандартный режим, если мир не запускается из его собственной безопасной директории.
 *'''-trusted''' В этом моде все операции разрешены. Мир может получать доступ к файлам в любых каталогах и командам ''shell''. Конечно, операционная система может налагать ограничения, но BYOND будет разрешать миру всё.
-*'''-params''' The following argument is interpreted as a parameter string as described in [DM_Guide_10|section]. The variable ''world.params'' is initialized from this data. You may use ''params'' multiple times; the individual parameter strings are simply concatenated to form the final result.
+*'''-params''' Данный аргумент интерпретируется как строка параметра, что уже было описано в [[DM_Guide_10|10-ой главе]]. Переменная ''world.params'' инициализируется из этих данных. Вы можете использовать ''params'' несколько раз; отдельные строки параметров, просто объединяются для формирования окончательного результата.
-====Control over Child Worlds====
+*'''-quiet''' Это просто отключает информационный вывод, который сервер обычно отображает при загрузке.
-Communication with a child world may be done through ''world.Export()''. In this case, the child world's ''world.Topic()'' procedure is called with a special master flag to indicate that the message came from the world which started it. (See [[DM_Guide_8|section]] for a review of these procs.)
+====Контроль Дочерних Миров====
-By default, a child world will respond to the special topics "Del" and "Reboot" by calling ''world.Del()'' and ''world.Reboot()'' respectively. This is only done if the message comes from the master world, since otherwise anyone could send the message and shut your world down.
-Another useful topic is "ping", which can be used to determine if a child world is still alive and running.
+Связь с дочерним миром может быть осуществлена с помощью ''world.Export ()''. В этом случае, процедура ''world.Topic()'' вызывается со специальным флагом, чтобы указать, что сообщение пришло из мира, который его запустил. (см. [[DM_Guide_8 | 8-ую главу]]) По умолчанию, дочерний мир будет реагировать на спецальные команды "Del" и "Reboot" вызовом ''world.Del ()'' и ''world.Reboot ()'' соответственно. Это происходит только если приходит сообщение от главного мира, так как в противном случае кто угодно может отправить сообщение и прекратить работу вашего мира.
 ====shutdown====
-''shutdown'' instruction may be used to close a child world or to wait for it to exit normally.
+''shutdown'' Инструкция может быть использована, чтобы закрыть дочерний мир или подождать, пока он закроется нормально.
 {| border="0"
@@ Строка 223: / Строка 223: @@
 |-
+|
-| Address is the network address of the world.
+| Address – сетевой адрес мира.
 |-
+|
-| Natural is 1 to suppress sending of "Del" message.
+| Natural - для предотвращения отправки сообщения "Del" должно быть равно 1.
 |-
+|
-| Returns exit status of the child world.
+| Возращает статус закрытия мира.
 |}
-The address should be the same text string returned by ''startup()''. If the second argument is omitted or zero, this is equivalent to calling ''world.Export()'' with the given address and "Del" as the topic. Otherwise, this instruction simply waits for the child world to die naturally of its own accord.
+Address должен быть строкой, возвращаемой инструкцией ''startup()''. Если второй аргумент опущен или равен нулю, то это эквивалентно вызову ''world.Export ()'' с данным адресом и "Del" в качестве команды. В противном случае, эта инструкция просто ждет, когда дочерний мир закроется самостоятельно.
-With no arguments at all, this instruction causes the current world to shut down. The same thing can be achieved by calling ''world.Del()''.
+Вовсе без аргументов эта инструкция вызывает закрытие текущего мира. То же самое может быть достигнуто вызовом ''world.Del ()''.