Ввод-вывод модели - как использовать метод экземпляра makeVerticesUniqueAndReturnError ()?
Метод экземпляра makeVerticesUnique() изменил буферы вершин меша так, чтобы вершины не использовались совместно несколькими гранями. Но он устарел в macOS 10.13 High Sierra и в iOS 11:
mdlMesh.makeVerticesUnique() /* deprecated in macOS 10.13 and iOS 11 */
Теперь разработчики должны использовать новый метод экземпляра:
func makeVerticesUniqueAndReturnError() throws
Но это не задокументировано. Как это использовать?
Когда я использую этот новый метод экземпляра, Xcode выдает ошибку:
'throws' may only occur before '->'
Ответы 2
Всякий раз, когда вы не найдете документации на сайте developer.apple.com или в средстве просмотра документации Xcode, проверьте заголовки фреймворка или интерфейс Swift - в них часто есть комментарии к коду, которые могут служить хотя бы приблизительной формой документации.
В Xcode используйте Open Quickly (⌘⇧O) и введите имя заголовка, о котором идет речь (MDLMesh.h), или один из символов внутри него (MDLMesh, makeVerticesUnique, etc). Или ⌘-щелкните один из этих символов в источнике и выберите «Перейти к определению». (Если на этом этапе вы попадаете в заголовок Objective-C и хотите увидеть версию Swift, выберите «Созданный интерфейс» в меню связанных элементов в верхней части файла.)
В этом случае вы увидите, что оба метода эквивалентны по использованию (но для способности нового метода генерировать ошибки):
/*!
@method makeVerticesUnique:
@abstract Deindexes the vertex array
@discussion If any vertices are shared on multiple faces, duplicate those
vertices so faces do not share vertices. The vertex buffer and index
buffers on submeshes may grow to accomadate any vertices added.
*/
@available(OSX, introduced: 10.11, deprecated: 10.13)
open func makeVerticesUnique()
/*!
@method makeVerticesUniqueAndReturnError:
@abstract Deindexes the vertex array
@discussion If any vertices are shared on multiple faces, duplicate those
vertices so faces do not share vertices. The vertex buffer and index
buffers on submeshes may grow to accomadate any vertices added.
*/
@available(OSX 10.13, *)
open func makeVerticesUniqueAndReturnError() throws
Предположительно Apple определила, что исходный метод не обрабатывал сбои изящно (остановка из-за фатальной ошибки? Сбой? Плохой вывод? Не знаю), и решила, что было бы лучше сообщить вызывающим абонентам, когда что-то пойдет не так.
Так же, как вы вызываете любой метод throws - см. Обработка ошибок в книге Swift. Что-то вроде try mesh.makeVerticesUniqueAndReturnError(), заключенное в блок do / catch, где вы решаете, что вы собираетесь делать с ошибкой, если она есть. Или try?, если вы не заботитесь об обработке или представлении того, какая у вас ошибка. Или try!, если вы просто хотите, чтобы ваше приложение вылетало из-за ошибки.
Этот новый instance method отлично работает с ключевым словом try!:
try! mdlMesh.makeVerticesUniqueAndReturnError()
В моем конкретном случае бросающий метод не выдаст ошибку во время выполнения. Таким образом, я могу написать try! перед выражением, чтобы отключить распространение ошибок и заключить вызов в утверждение времени выполнения, что никаких ошибок не будет. Если действительно возникает ошибка, я получаю сообщение об ошибке выполнения.
Большое спасибо за ваш ответ. Я видел тонкости метода
makeVerticesUnique()черезJump to Definition. Но у меня вопрос: как использовать новый метод. Я не вижу примеров. Когда я использую его, Xcode говорит:'throws' may only occur before '->'.