Octal String To Number Function

Owning Palette: String/Number Conversion Functions

Requires: Base Development System

Interprets the characters 0 through 7 in string starting at offset as an octal integer and returns it in number. This function also returns the index in string of the first character following the number.

The connector pane displays the default data types for this polymorphic function.

If you want the function to return a 64-bit integer output, you must wire a 64-bit integer to the default input.

Add to the block diagram

Find on the palette

	string can be a string, a cluster of strings, an array of strings, or an array of clusters of strings.
	offset specifies number of characters into string at which the function starts searching for a match. offset must be numeric. The offset of the first character in string is 0. If offset is unwired or less than 0, the function takes offset as 0.
	default is any object of numeric representation and specifies the numeric representation for number. The default is a 32-bit unsigned integer value of 0. To return a 64-bit integer output, wire a 64-bit integer to default.
	offset past number is the index in string of the first character following the number. offset past number reflects the value from the last string if you input an array of strings.
	number can be a number, a cluster, an array of numbers, or an array of clusters, depending on the structure of string. If the input string represents a number outside the range of the representation of number, number is set to the maximum value for that data type. The following table shows how the values of string, offset, and default affect number. string offset default offset past number number Comments 92 0 0 0 0 9 is not an octal digit. 071a 0 0 3 57 a is not an octal digit, so conversion stops there.