Skip to content

Commit 51a3b79

Browse files
learn-build-service-prod[bot]learn-build-service-prod[bot]
authored
Merge pull request #151 from MicrosoftDocs/main638338465091143158sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 5bde22b + 4a76615 commit 51a3b79

22 files changed

Lines changed: 227 additions & 57 deletions

‎.openpublishing.redirection.json‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,11 @@
4444
"source_path": "query-languages/m/viewfunction-tryinvoke.md",
4545
"redirect_url": "/m/function-values",
4646
"redirect_document_id": false
47+
},
48+
{
49+
"source_path": "query-languages/m/table-onerror.md",
50+
"redirect_url": "/m/function-values",
51+
"redirect_document_id": false
4752
}
4853
]
4954
}

‎query-languages/m/action-witherrorcontext.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
description: "Learn more about: Action.WithErrorContext"
3+
title: "Action.WithErrorContext"
4+
---
5+
# Action.WithErrorContext
6+
7+
## Syntax
8+
9+
<pre>
10+
Action.WithErrorContext(<b>action</b> as action, <b>context</b> as text) as action
11+
</pre>
12+
13+
## About
14+
15+
This function is intended for internal use only.

‎query-languages/m/character-fromnumber.md‎

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,11 @@ Character.FromNumber(<b>number</b> as nullable number) as nullable text
1414

1515
Returns the character equivalent of the number.
1616

17+
The provided `number` should be a 21-bit Unicode code point.
18+
1719
## Example 1
1820

19-
Given the number 9, find the character value.
21+
Convert a number to its equivalent character value.
2022

2123
**Usage**
2224

@@ -27,3 +29,31 @@ Character.FromNumber(9)
2729
**Output**
2830

2931
`"#(tab)"`
32+
33+
## Example 2
34+
35+
Convert a character to a number and back again.
36+
37+
**Usage**
38+
39+
```powerquery-m
40+
Character.FromNumber(Character.ToNumber("A"))
41+
```
42+
43+
**Output**
44+
45+
`"A"`
46+
47+
## Example 3
48+
49+
Convert the hexadecimal code point for the "grinning face" emoticon to its equivalent UTF-16 surrogate pair.
50+
51+
**Usage**
52+
53+
```powerquery-m
54+
Character.FromNumber(0x1F600)
55+
```
56+
57+
**Output**
58+
59+
`"#(0001F600)"`

‎query-languages/m/character-tonumber.md‎

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,11 @@ Character.ToNumber(<b>character</b> as nullable text) as nullable number
1414

1515
Returns the number equivalent of the character, `character`.
1616

17+
The result will be the 21-bit Unicode code point represented by the provided character or surrogate pair.
18+
1719
## Example 1
1820

19-
Given the character "#(tab)" 9, find the number value.
21+
Convert a character to its equivalent number value.
2022

2123
**Usage**
2224

@@ -27,3 +29,17 @@ Character.ToNumber("#(tab)")
2729
**Output**
2830

2931
`9`
32+
33+
## Example 2
34+
35+
Convert the UTF-16 surrogate pair for the "grinning face" emoticon to its equivalent hexadecimal code point.
36+
37+
**Usage**
38+
39+
```powerquery-m
40+
Number.ToText(Character.ToNumber("#(0001F600)"), "X")
41+
```
42+
43+
**Output**
44+
45+
`"1F600"`

‎query-languages/m/combiner-combinetextbyeachdelimiter.md‎

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,18 @@ Combiner.CombineTextByEachDelimiter(<b>delimiters</b> as list, optional <b>quote
1212

1313
## About
1414

15-
Returns a function that combines a list of text into a single text using each specified delimiter in sequence.
15+
Returns a function that combines a list of text values into a single text value using a sequence of delimiters.
16+
17+
## Example 1
18+
19+
Combine a list of text values using a sequence of delimiters.
20+
21+
**Usage**
22+
23+
```powerquery-m
24+
Combiner.CombineTextByEachDelimiter({"=", "+"})({"a", "b", "c"})
25+
```
26+
27+
**Output**
28+
29+
`"a=b+c"`

‎query-languages/m/combiner-combinetextbylengths.md‎

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,32 @@ Combiner.CombineTextByLengths(<b>lengths</b> as list, optional <b>template</b> a
1212

1313
## About
1414

15-
Returns a function that combines a list of text into a single text using the specified lengths.
15+
Returns a function that combines a list of text values into a single text value using the specified lengths.
16+
17+
## Example 1
18+
19+
Combine a list of text values by extracting the specified numbers of characters from each input value.
20+
21+
**Usage**
22+
23+
```powerquery-m
24+
Combiner.CombineTextByLengths({1, 2, 3})({"aaa", "bbb", "ccc"})
25+
```
26+
27+
**Output**
28+
29+
`"abbccc"`
30+
31+
## Example 2
32+
33+
Combine a list of text values by extracting the specified numbers of characters, after first pre-filling the result with the template text.
34+
35+
**Usage**
36+
37+
```powerquery-m
38+
Combiner.CombineTextByLengths({1, 2, 3}, "*********")({"aaa", "bbb", "ccc"})
39+
```
40+
41+
**Output**
42+
43+
`"abbccc***"`

‎query-languages/m/combiner-combinetextbypositions.md‎

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,20 @@ Combiner.CombineTextByPositions(<b>positions</b> as list, optional <b>template</
1212

1313
## About
1414

15-
Returns a function that combines a list of text into a single text using the specified positions.
15+
Returns a function that combines a list of text values into a single text value using the specified output positions.
16+
17+
## Example 1
18+
19+
Combine a list of text values by placing them in the output at the specified positions.
20+
21+
**Usage**
22+
23+
```powerquery-m
24+
Combiner.CombineTextByPositions({0, 5, 10})({"abc", "def", "ghi"})
25+
```
26+
27+
**Output**
28+
29+
```powerquery-m
30+
"abc def ghi"
31+
```

‎query-languages/m/combiner-combinetextbyranges.md‎

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,20 @@ Combiner.CombineTextByRanges(<b>ranges</b> as list, optional <b>template</b> as
1212

1313
## About
1414

15-
Returns a function that combines a list of text into a single text using the specified positions and lengths. A null length indicates that the entire text value should be included.
15+
Returns a function that combines a list of text values into a single text value using the specified output positions and lengths. A null length indicates that the entire text value should be included.
16+
17+
## Example 1
18+
19+
Combine a list of text values using the specified output positions and lengths.
20+
21+
**Usage**
22+
23+
```powerquery-m
24+
Combiner.CombineTextByRanges({{0, 1}, {3, 2}, {6, null}})({"abc", "def", "ghijkl"})
25+
```
26+
27+
**Output**
28+
29+
```powerquery-m
30+
"a de ghijkl"
31+
```

‎query-languages/m/combiner-functions.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
22
description: "Learn more about: Combiner functions"
33
title: "Combiner functions"
4-
ms.date: 6/15/2023
4+
ms.date: 10/19/2023
55
ms.custom: "nonautomated-date"
66
---
77
# Combiner functions
88

9-
These functions are used by other library functions that merge values. For example, `Table.ToList` and `Table.CombineColumns` apply a combiner function to each row in a table to produce a single value for each row.
9+
These functions are used by other library functions that merge values. For example, [Table.ToList](table-tolist.md) and [Table.CombineColumns](table-combinecolumns.md) apply a combiner function to each row in a table to produce a single value for each row.
1010

1111
|Name|Description|
1212
|------------|---------------|
13-
|[Combiner.CombineTextByDelimiter](combiner-combinetextbydelimiter.md)|Returns a function that combines a list of text values into a single text value using the specified delimiter.|
14-
|[Combiner.CombineTextByEachDelimiter](combiner-combinetextbyeachdelimiter.md)|Returns a function that combines a list of text into a single text using each specified delimiter in sequence.|
15-
|[Combiner.CombineTextByLengths](combiner-combinetextbylengths.md)|Returns a function that combines a list of text into a single text using the specified lengths.|
16-
|[Combiner.CombineTextByPositions](combiner-combinetextbypositions.md)|Returns a function that combines a list of text into a single text using the specified positions.|
17-
|[Combiner.CombineTextByRanges](combiner-combinetextbyranges.md)|Returns a function that combines a list of text into a single text using the specified positions and lengths.|
13+
|[Combiner.CombineTextByDelimiter](combiner-combinetextbydelimiter.md)|Returns a function that combines a list of text using the specified delimiter.|
14+
|[Combiner.CombineTextByEachDelimiter](combiner-combinetextbyeachdelimiter.md)|Returns a function that combines a list of text using a sequence of delimiters.|
15+
|[Combiner.CombineTextByLengths](combiner-combinetextbylengths.md)|Returns a function that combines a list of text using the specified lengths.|
16+
|[Combiner.CombineTextByPositions](combiner-combinetextbypositions.md)|Returns a function that combines a list of text using the specified output positions.|
17+
|[Combiner.CombineTextByRanges](combiner-combinetextbyranges.md)|Returns a function that combines a list of text using the specified positions and lengths.|

‎query-languages/m/docfx.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@
4545
"author": "dougklopfenstein",
4646
"ms.author": "dougklo",
4747
"searchScope": ["Power Query","M formula language"],
48-
"ms.date": "09/11/2023"
48+
"ms.date": "10/19/2023"
4949
},
5050
"fileMetadata": { },
5151
"template": [],

0 commit comments

Comments
 (0)