Развитие русской справки
- Автор темы AZJIO
- Дата начала
asdf8
Во первых возвращается число-идентификатор, даже тип данных другой. Возможно там ассоциированный массив число-дескриптор. Я уже привык что дескриптор это что-то в виде числа идентифицирующее некий объект в системе. В справке по Си нигде не указывается о том, что это дескриптор, вместо этого например для fopen сказано "возвращает указатель на объект файла, который используется для идентификации потока". Создаётся впечатление, что функция ищет первый файл, лучше указать, что функция задаёт параметры поиска и ничего больше, типа объект свойств, набор свойств поиска, для того чтобы используя свойства приступить к поиску. Сейчас существует запутывающая неясность, приходится разгадывать.
Во первых возвращается число-идентификатор, даже тип данных другой. Возможно там ассоциированный массив число-дескриптор. Я уже привык что дескриптор это что-то в виде числа идентифицирующее некий объект в системе. В справке по Си нигде не указывается о том, что это дескриптор, вместо этого например для fopen сказано "возвращает указатель на объект файла, который используется для идентификации потока". Создаётся впечатление, что функция ищет первый файл, лучше указать, что функция задаёт параметры поиска и ничего больше, типа объект свойств, набор свойств поиска, для того чтобы используя свойства приступить к поиску. Сейчас существует запутывающая неясность, приходится разгадывать.
AZJIO
Как по мне, дескриптор - это некоторая абстрактная фиговина которая позволяет работать связанным с ней функциям которая должна быть освобождена/закрыта после окончания пользования ей. Такое определение является для меня необходимым и достаточным, чтобы пользоваться функциями использующими "дескриптор".
Все конечно имхо.
Как по мне, дескриптор - это некоторая абстрактная фиговина которая позволяет работать связанным с ней функциям которая должна быть освобождена/закрыта после окончания пользования ей. Такое определение является для меня необходимым и достаточным, чтобы пользоваться функциями использующими "дескриптор".
Все конечно имхо.
asdf8
То, что его нужно закрыть можно увидеть и в примерах и в описании и незакрытие это меньший страх, чем неправильная работа, всего лишь памяти будет занимать больше. Я помню как мне давалась эта функция.
1. Сначала я думал что она ищет первый файл по маске, а FileFindNextFile продолжает поиск.
2. Далее я столкнулся с тем, что при вызове через bat-файл изменялся текущий путь, то есть изначально для поиска в относительной папке от текущего каталога нужно указать в строке не только маску но и путь и причём это для меня оказалась более частая операция, потому что программа должна искать путь своих файлов в своём каталоге, а не в каталоге bat-файла. Да и в дальнейшем, если я задаю жёсткой путь поиска, то должен его указать в этой строке. А случай "без пути" удобен если я пишу консольную программу, то есть в 99% это не для меня.
3. Выяснил, что в маске может быть только один символ подстановки (wildcards). Возможно я интерпретировал это как то что в маске может быть только одна маска, а на деле в имени файла и в расширении может быть только один символ подстановки, а если 2, то я помню какой глюк это вызывало - http://autoit-script.ru/index.php/topic,8266.msg75503.html#msg75503 -это глюк одного поля ягоды, то что в маске нельзя указывать несколько символов подстановки, общее для всех где задействовано wildcards. (хотя здесь я ещё не уверен на 100%, что я прав)
Все эти критерии должны быть написаны ясно, чтобы исключить двусмысленность или неправильную интерпретацию, оно должно быть воспринято однозначно и точно.
Почему набор свойств? Здесь задаются:
1. Путь
2. Маска
3. Номер файла, который будет обновлять (с инкрементом) функция FileFindNextFile.
То, что его нужно закрыть можно увидеть и в примерах и в описании и незакрытие это меньший страх, чем неправильная работа, всего лишь памяти будет занимать больше. Я помню как мне давалась эта функция.
1. Сначала я думал что она ищет первый файл по маске, а FileFindNextFile продолжает поиск.
2. Далее я столкнулся с тем, что при вызове через bat-файл изменялся текущий путь, то есть изначально для поиска в относительной папке от текущего каталога нужно указать в строке не только маску но и путь и причём это для меня оказалась более частая операция, потому что программа должна искать путь своих файлов в своём каталоге, а не в каталоге bat-файла. Да и в дальнейшем, если я задаю жёсткой путь поиска, то должен его указать в этой строке. А случай "без пути" удобен если я пишу консольную программу, то есть в 99% это не для меня.
3. Выяснил, что в маске может быть только один символ подстановки (wildcards). Возможно я интерпретировал это как то что в маске может быть только одна маска, а на деле в имени файла и в расширении может быть только один символ подстановки, а если 2, то я помню какой глюк это вызывало - http://autoit-script.ru/index.php/topic,8266.msg75503.html#msg75503 -это глюк одного поля ягоды, то что в маске нельзя указывать несколько символов подстановки, общее для всех где задействовано wildcards. (хотя здесь я ещё не уверен на 100%, что я прав)
Все эти критерии должны быть написаны ясно, чтобы исключить двусмысленность или неправильную интерпретацию, оно должно быть воспринято однозначно и точно.
Почему набор свойств? Здесь задаются:
1. Путь
2. Маска
3. Номер файла, который будет обновлять (с инкрементом) функция FileFindNextFile.
Пример из справки функции StringRegExp:
Выдает позицию начала для первого совпадения = 14...
Думаю правильный смысл таков:
Код:
; Тестовая строка
$sText = '<tage>Текст1</tage> <tage>Текст2</tage> <tage>Текст3</Tage>'
; флаг=1, используется смещение для пошагового поиска всех элементов
$iOffset = 1
While 1
$aRes = StringRegExp($sText, '(?i)<tage>(.*?)</tage>', 1, $iOffset)
If @error Then ExitLoop ; Выход из цикла если более не найдено
$iOffset = @extended ; Сохраняет позицию, от которой начать следующий поиск
; Просмотр только одного элемента массива, так как в рег.выр. одна группа
MsgBox(0, 'флаг=1', 'Найдено = ' & $aRes[0] & @LF & _
'Позиция начала = ' & $iOffset - StringLen($aRes[0]) & @LF & _
'Позиция конца = ' & $iOffset - 1) ; Позиции могут использоваться другими строковыми функциями
WEndВыдает позицию начала для первого совпадения = 14...
Думаю правильный смысл таков:
Код:
MsgBox(0, 'флаг=1', 'Найдено = ' & $aRes[0] & @LF & _
'Позиция начала = ' & ($iOffset - StringLen($aRes[0])) - StringLen("</tage><tage>") & @LF & _
'Позиция конца = ' & $iOffset - 1) ; Позиции могут использоваться другими строковыми функциямиFireCat
Переведите как бы вы хотели видеть перевод этого предложения. Могу сказать что несуществующую переменную нельзя передать, как бы объявив её в ByRef, она должна быть объявлена заранее. Что для вас означает именованная переменная? Все переменные имеют имя. Если фраза ступорит, что вы от меня хотите?
Переведите как бы вы хотели видеть перевод этого предложения. Могу сказать что несуществующую переменную нельзя передать, как бы объявив её в ByRef, она должна быть объявлена заранее. Что для вас означает именованная переменная? Все переменные имеют имя. Если фраза ступорит, что вы от меня хотите?
FireCat
Правильнее будет задавать ваш вопрос на официальном форуме, в теме обсуждения документации.
Правильнее будет задавать ваш вопрос на официальном форуме, в теме обсуждения документации.
Kaster
Я не против докопаться до истины, выкладывайте ваши мысли по этому поводу. Страница Func...Return...EndFunc была переведена до меня и хотя я перепроверял, возможно я также не стал изменять текущее описание на непонятное предложение. Моё внутреннее правило/понимание звучит так: всё что переведено должно быть осмысленно, и если предложение непонятно самому переводчику, который в Google в течении 1-3 часов искал ответ на вопрос, то тем более оно будет непонятно и новичку. А раз так, то лучше вообще не переводить предложения, которые не приносят ни какой пользы, кроме отъёма времени и выглядят подозрительно. Я ещё понимаю раздел DllCall, хотя и там фразы выглядят законченными по смыслу. Но в понимании ByRef предназначение очевидно.
1. Вот пример, показывает что необъявленную переменную передавать нельзя, хотя и без ByRef нельзя.
2. Пример показывает, что я передаю функцию в качестве параметра и это не вызывает ошибки.
Я даже передаю число и это тоже не вызывает ошибки, хотя практичность/смысл сведена на 0.
Что здесь имеется ввиду? Значение рядом с ByRef или значение переданное функцией в переменную под ByRef? Если значение рядом с ByRef, то там может быть только переменная, нельзя использовать там имя функции или явное значение (число, текст и т.д.). Если речь о значении в вызываемой функции, которая передаёт его в переменную под ByRef, то тут может быть всё что угодно, но с практической точки зрения не имеет смысла передавать явные значения в ByRef.
Что толку переводить дословно предложение, если оно не добавляет ума, а только отнимает время? Какой смысл забивать справку сомнительными текстами не приносящими пользы? Справка и так ёмкая и добавлять туда бессмыслицу контр-продуктивно. Я согласен, если человек говорящий о неправильности справки даст правильный перевод и докажет нужность этого. Но этого не произошло. Тогда о чём речь?
Я не против докопаться до истины, выкладывайте ваши мысли по этому поводу. Страница Func...Return...EndFunc была переведена до меня и хотя я перепроверял, возможно я также не стал изменять текущее описание на непонятное предложение. Моё внутреннее правило/понимание звучит так: всё что переведено должно быть осмысленно, и если предложение непонятно самому переводчику, который в Google в течении 1-3 часов искал ответ на вопрос, то тем более оно будет непонятно и новичку. А раз так, то лучше вообще не переводить предложения, которые не приносят ни какой пользы, кроме отъёма времени и выглядят подозрительно. Я ещё понимаю раздел DllCall, хотя и там фразы выглядят законченными по смыслу. Но в понимании ByRef предназначение очевидно.
1. Вот пример, показывает что необъявленную переменную передавать нельзя, хотя и без ByRef нельзя.
Код:
MsgBox(0, 'Сообщение', _TestByRef($d))
Func _TestByRef(ByRef $z)
$z = 5
EndFunc2. Пример показывает, что я передаю функцию в качестве параметра и это не вызывает ошибки.
Код:
MsgBox(0, 'Сообщение', _TestByRef(_Num()))
Func _TestByRef(ByRef $z)
$z = 5
EndFunc
Func _Num()
Return 4
EndFuncЯ даже передаю число и это тоже не вызывает ошибки, хотя практичность/смысл сведена на 0.
Код:
MsgBox(0, 'Сообщение', _TestByRef(2))
Func _TestByRef(ByRef $z)
$z = 5
EndFuncЧто здесь имеется ввиду? Значение рядом с ByRef или значение переданное функцией в переменную под ByRef? Если значение рядом с ByRef, то там может быть только переменная, нельзя использовать там имя функции или явное значение (число, текст и т.д.). Если речь о значении в вызываемой функции, которая передаёт его в переменную под ByRef, то тут может быть всё что угодно, но с практической точки зрения не имеет смысла передавать явные значения в ByRef.
Что толку переводить дословно предложение, если оно не добавляет ума, а только отнимает время? Какой смысл забивать справку сомнительными текстами не приносящими пользы? Справка и так ёмкая и добавлять туда бессмыслицу контр-продуктивно. Я согласен, если человек говорящий о неправильности справки даст правильный перевод и докажет нужность этого. Но этого не произошло. Тогда о чём речь?
- Сообщения
- 4,020
- Репутация
- 626
AZJIO
имеется в виду, что в ByRef можно передавать не только именованные параметры типа $var, но и неименнованные, такие как значения возвращаемые функцией. Например
Кстати, в твоем переводе именно это и написано
имеется в виду, что в ByRef можно передавать не только именованные параметры типа $var, но и неименнованные, такие как значения возвращаемые функцией. Например
Код:
Func somefunc(ByRef AnotherFunctionThatReturnsArray($somevar))
; Do stuff
EndFuncКстати, в твоем переводе именно это и написано
Kaster
У меня предложенный тобой вариант вызывает ошибку
Вызывает ошибку именно в строке ByRef
Вообще в описываемых параметрах функции вроде как запрещены любые функции и вычисления. Допустимо только назначить значения по умолчанию, т.е. знак "=". Остальное ошибка.
У меня предложенный тобой вариант вызывает ошибку
Код:
MsgBox(0, 'Сообщение', _Somefunc(9))
Func _Somefunc(ByRef _Fnc($somevar))
Return 1
EndFunc
Func _Fnc($somevar)
Return 2
EndFuncВызывает ошибку именно в строке ByRef
Вообще в описываемых параметрах функции вроде как запрещены любые функции и вычисления. Допустимо только назначить значения по умолчанию, т.е. знак "=". Остальное ошибка.
