Contents

scanUpTo(_:into:)

Scans the string until a given string is encountered, accumulating characters into a string that’s returned by reference.

Declaration

func scanUpTo(_ string: String, into result: AutoreleasingUnsafeMutablePointer<NSString?>?) -> Bool

Parameters

  • string:

    The string to scan up to.

  • result:

    Upon return, contains any characters that were scanned.

Return Value

true if the receiver scans any characters, otherwise false.

If the only scanned characters are in the charactersToBeSkipped character set (which by default is the whitespace and newline character set), then this method returns false.

Discussion

If stopString is present in the receiver, then on return the scan location is set to the beginning of that string.

If stopString is the first string in the receiver, then the method returns false and stringValue is not changed.

If the search string (stopString) isn’t present in the scanner’s source string, the remainder of the source string is put into stringValue, the receiver’s scanLocation is advanced to the end of the source string, and the method returns true.

Invoke this method with NULL as stringValue to simply scan up to a given string.

See Also

Scanning Characters and Strings