Instance Method インスタンスメソッド

range(of:options:in:)

Finds and returns the range of the first occurrence of the given data, within the given range, subject to given options. 与えられたデータの最初の出現の範囲を、与えられた範囲内で、与えられたオプションを条件として、捜して返します。

Declaration 宣言 

func range(of dataToFind: Data, 
   options mask: NSData.SearchOptions = [], 
        in searchRange: NSRange) -> NSRange

Parameters パラメータ

dataToFind

The data for which to search. このデータを捜し出します。

mask

A mask specifying search options. The NSData.SearchOptions options may be specified singly or by combining them with the C bitwise OR operator. 検索オプションを指定するマスク。NSData.SearchOptionsオプションは、単独にまたはそれらをCビット単位OR演算子で組み合わせることによって指定されるかもしれません。

searchRange

The range within the receiver in which to search for dataToFind. If this range is not within the data object's range of bytes, rangeException is raised. レシーバの内部のこの範囲の中でdataToFindを検索することになります。この範囲がデータオブジェクトの持つバイト範囲内でないならば、rangeExceptionが引き起こされます。

Return Value 戻り値

An NSRange structure giving the location and length of dataToFind within searchRange, modulo the options in mask. The range returned is relative to the start of the searched data, not the passed-in search range. Returns {NSNotFound, 0} if dataToFind is not found or is empty. あるNSRange構造体、dataToFindの位置と範囲をsearchRange内で、maskの中のオプションをモジュロ演算して、与えています。返される範囲は、検索されたデータの始まりに相対的です、渡された検索範囲ではなく。{NSNotFound, 0}を返します、もしdataToFindが見つけられないまたは空ならば返します。

See Also 参照

Finding Data データを見つける

func subdata(with: NSRange) -> Data
Returns a new data object containing the data object's bytes that fall within the limits specified by a given range. データオブジェクトの持つバイトで、ある与えられた範囲によって指定される制限内に収まるものを含んでいる新しいデータオブジェクトを返します。
struct NSData.SearchOptions
Options for method used to search data objects. データオブジェクトの検索に使用されるメソッドのオプション。